@@ -510,6 +510,10 @@ to be, with the one believed to be most secure at release time being PERL_HASH_F
510
510
PERL_HASH_FUNC_SIPHASH13
511
511
PERL_HASH_FUNC_ZAPHOD32
512
512
513
+ =for apidoc Amnh;||PERL_HASH_FUNC_SIPHASH
514
+ =for apidoc_item ||PERL_HASH_FUNC_SIPHASH13
515
+ =for apidoc_item ||PERL_HASH_FUNC_ZAPHOD32
516
+
513
517
In addition, these, (or custom hash functions), may be "fronted" by the
514
518
SBOX32 hash function for keys under a chosen size. This hash function is
515
519
special in that it has proven theoretical security properties, and is very
@@ -526,6 +530,8 @@ with something like this
526
530
527
531
-Accflags='-DPERL_HASH_USE_SBOX32_ALSO=0'
528
532
533
+ =for apidoc Amnh||PERL_HASH_USE_SBOX32_ALSO
534
+
529
535
or alternatively you can use the simple define C<PERL_HASH_NO_SBOX32> like this:
530
536
531
537
-Accflags='-DPERL_HASH_NO_SBOX32'
@@ -537,6 +543,8 @@ this:
537
543
538
544
-Accflags='-DSBOX_MAX_LEN=128'
539
545
546
+ =for apidoc Amn|U32|SBOX32_MAX_LEN
547
+
540
548
As of Perl 5.18 the order returned by keys(), values(), and each() is
541
549
non-deterministic and distinct per hash, and the insert order for
542
550
colliding keys is randomized as well, and perl allows for controlling this
555
563
556
564
-Accflags='-DPERL_PERTURB_KEYS_DETERMINISTIC'
557
565
566
+ =for apidoc Amnh;||PERL_PERTURB_KEYS_DETERMINISTIC
567
+ =for apidoc_item ||PERL_PERTURB_KEYS_DISABLED
568
+ =for apidoc_item ||PERL_PERTURB_KEYS_RANDOM
569
+
558
570
Since Perl 5.18 the seed used for the hash function is randomly selected
559
571
at process start, which can be overridden by specifying a seed by setting
560
572
the PERL_HASH_SEED environment variable. Be aware that
@@ -573,6 +585,8 @@ seed with the define C<NO_HASH_SEED> by providing to Configure
573
585
574
586
-Accflags='-DNO_HASH_SEED'
575
587
588
+ =for apidoc Amnh||NO_HASH_SEED
589
+
576
590
Note that if you do this you should modify the code in hv_func.h to specify
577
591
your own key. In the future this define may be renamed and replaced with one
578
592
that requires you to specify the key to use.
@@ -610,6 +624,8 @@ settings.
610
624
611
625
=item PERL_MAX_NESTED_EVAL_BEGIN_BLOCKS_DEFAULT
612
626
627
+ =for apidoc Amnh||PERL_MAX_NESTED_EVAL_BEGIN_BLOCKS_DEFAULT
628
+
613
629
This define is used to control the default maximum number of nested
614
630
eval/BEGIN statements, and in this context require should be
615
631
understood to be a special form of eval so this means require/BEGIN
@@ -917,6 +933,8 @@ installation, perhaps in a strange place:
917
933
918
934
=item APPLLIB_EXP
919
935
936
+ =for apidoc Amnh||APPLLIB_EXP
937
+
920
938
There is one other way of adding paths to @INC at perl build time, and
921
939
that is by setting the APPLLIB_EXP C pre-processor token to a colon-
922
940
separated list of directories, like this
@@ -1391,6 +1409,8 @@ default is set.
1391
1409
1392
1410
=item -DPERL_POLLUTE_MALLOC
1393
1411
1412
+ =for apidoc Amnh||PERL_POLLUTE_MALLOC
1413
+
1394
1414
NOTE: This flag is enabled automatically on some platforms if you just
1395
1415
run Configure to accept all the defaults.
1396
1416
@@ -1410,6 +1430,8 @@ versions.
1410
1430
1411
1431
=item -DPERL_DEBUGGING_MSTATS
1412
1432
1433
+ =for apidoc Amnh||PERL_DEBUGGING_MSTATS
1434
+
1413
1435
This flag enables debugging mstats, which is required to use the
1414
1436
Devel::Peek::mstat() function. You cannot enable this unless you are
1415
1437
using Perl's malloc, so a typical Configure command would be
0 commit comments