diff options
Diffstat (limited to 'doc/gawk.info')
-rw-r--r-- | doc/gawk.info | 493 |
1 files changed, 252 insertions, 241 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index 056fc2cc..368f1ea9 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -22479,8 +22479,8 @@ use the same ‘gawk’ executable from run to run. so: $ gawk --version - ⊣ GNU Awk 5.2.1, API 3.2, PMA Avon 8-g1, (GNU MPFR 4.1.0, GNU MP 6.2.1) - ⊣ Copyright (C) 1989, 1991-2022 Free Software Foundation. + ⊣ GNU Awk 5.2.2, API 3.2, PMA Avon 8-g1, (GNU MPFR 4.1.0, GNU MP 6.2.1) + ⊣ Copyright (C) 1989, 1991-2023 Free Software Foundation. ... If you see the ‘PMA’ with a version indicator, then it’s supported. @@ -22575,6 +22575,17 @@ the different verbosity levels are. “leaking” into the backing file and being recovered later by an attacker. + • Over time, the backing file will be filled with memory “leaked” by + ‘gawk’ as it runs. Most notably this is the memory used to compile + your program into an internal form before running it, which happens + each time, but there are other leakages as well. (For an extreme + example of this, see this thread + (https://lists.gnu.org/archive/html/bug-gawk/2023-04/msg00025.html) + in the <bug-gawk@gnu-org> mailing list archives.) It is up to you + to use ‘du -sh PMAFILE’ occasionally to monitor how full the file + is, and arrange to dump any data you may need before the backing + file becomes full. + Terence Kelly has provided a separate ‘Persistent-Memory ‘gawk’ User Manual’ document, which is included in the ‘gawk’ distribution. It is worth reading. *Note General Introduction: (pm-gawk)Top. @@ -38221,7 +38232,7 @@ Index * Kahrs, Jürgen <1>: Contributors. (line 71) * Kasal, Stepan: Acknowledgments. (line 60) * Kelly, Terence: Persistent Memory. (line 76) -* Kelly, Terence <1>: Persistent Memory. (line 127) +* Kelly, Terence <1>: Persistent Memory. (line 138) * Kelly, Terence <2>: Feature History. (line 510) * Kenobi, Obi-Wan: Undocumented. (line 6) * Kernighan, Brian: History. (line 21) @@ -40031,244 +40042,244 @@ Ref: Two-way I/O-Footnote-2929593 Node: TCP/IP Networking929675 Node: Profiling932855 Node: Persistent Memory942565 -Ref: Persistent Memory-Footnote-1951523 -Node: Extension Philosophy951654 -Node: Advanced Features Summary953189 -Node: Internationalization955459 -Node: I18N and L10N957165 -Node: Explaining gettext957860 -Ref: Explaining gettext-Footnote-1964013 -Ref: Explaining gettext-Footnote-2964208 -Node: Programmer i18n964373 -Ref: Programmer i18n-Footnote-1969486 -Node: Translator i18n969535 -Node: String Extraction970371 -Ref: String Extraction-Footnote-1971549 -Node: Printf Ordering971647 -Ref: Printf Ordering-Footnote-1974509 -Node: I18N Portability974577 -Ref: I18N Portability-Footnote-1977151 -Node: I18N Example977222 -Ref: I18N Example-Footnote-1980622 -Ref: I18N Example-Footnote-2980698 -Node: Gawk I18N980815 -Node: I18N Summary981471 -Node: Debugger982872 -Node: Debugging983896 -Node: Debugging Concepts984345 -Node: Debugging Terms986171 -Node: Awk Debugging988784 -Ref: Awk Debugging-Footnote-1989761 -Node: Sample Debugging Session989901 -Node: Debugger Invocation990453 -Node: Finding The Bug992082 -Node: List of Debugger Commands998768 -Node: Breakpoint Control1000145 -Node: Debugger Execution Control1003977 -Node: Viewing And Changing Data1007457 -Node: Execution Stack1011195 -Node: Debugger Info1012876 -Node: Miscellaneous Debugger Commands1017175 -Node: Readline Support1022428 -Node: Limitations1023374 -Node: Debugging Summary1026018 -Node: Namespaces1027321 -Node: Global Namespace1028448 -Node: Qualified Names1029893 -Node: Default Namespace1030928 -Node: Changing The Namespace1031703 -Node: Naming Rules1033397 -Node: Internal Name Management1035312 -Node: Namespace Example1036382 -Node: Namespace And Features1038965 -Node: Namespace Summary1040422 -Node: Arbitrary Precision Arithmetic1041935 -Node: Computer Arithmetic1043454 -Ref: table-numeric-ranges1047271 -Ref: table-floating-point-ranges1047769 -Ref: Computer Arithmetic-Footnote-11048428 -Node: Math Definitions1048487 -Ref: table-ieee-formats1051532 -Node: MPFR features1052106 -Node: MPFR On Parole1052559 -Ref: MPFR On Parole-Footnote-11053403 -Node: MPFR Intro1053562 -Node: FP Math Caution1055252 -Ref: FP Math Caution-Footnote-11056326 -Node: Inexactness of computations1056703 -Node: Inexact representation1057734 -Node: Comparing FP Values1059117 -Node: Errors accumulate1060375 -Node: Strange values1061842 -Ref: Strange values-Footnote-11064508 -Node: Getting Accuracy1064613 -Node: Try To Round1067350 -Node: Setting precision1068257 -Ref: table-predefined-precision-strings1068962 -Node: Setting the rounding mode1070847 -Ref: table-gawk-rounding-modes1071229 -Ref: Setting the rounding mode-Footnote-11075287 -Node: Arbitrary Precision Integers1075470 -Ref: Arbitrary Precision Integers-Footnote-11078682 -Node: Checking for MPFR1078838 -Node: POSIX Floating Point Problems1080328 -Ref: POSIX Floating Point Problems-Footnote-11085192 -Node: Floating point summary1085230 -Node: Dynamic Extensions1087494 -Node: Extension Intro1089093 -Node: Plugin License1090401 -Node: Extension Mechanism Outline1091214 -Ref: figure-load-extension1091665 -Ref: figure-register-new-function1093250 -Ref: figure-call-new-function1094360 -Node: Extension API Description1096484 -Node: Extension API Functions Introduction1098213 -Ref: table-api-std-headers1100111 -Node: General Data Types1104575 -Ref: General Data Types-Footnote-11113743 -Node: Memory Allocation Functions1114058 -Ref: Memory Allocation Functions-Footnote-11118783 -Node: Constructor Functions1118882 -Node: API Ownership of MPFR and GMP Values1122787 -Node: Registration Functions1124348 -Node: Extension Functions1125052 -Node: Exit Callback Functions1130628 -Node: Extension Version String1131947 -Node: Input Parsers1132642 -Node: Output Wrappers1147286 -Node: Two-way processors1152134 -Node: Printing Messages1154495 -Ref: Printing Messages-Footnote-11155709 -Node: Updating ERRNO1155864 -Node: Requesting Values1156663 -Ref: table-value-types-returned1157416 -Node: Accessing Parameters1158525 -Node: Symbol Table Access1159809 -Node: Symbol table by name1160325 -Ref: Symbol table by name-Footnote-11163536 -Node: Symbol table by cookie1163668 -Ref: Symbol table by cookie-Footnote-11167949 -Node: Cached values1168013 -Ref: Cached values-Footnote-11171657 -Node: Array Manipulation1171814 -Ref: Array Manipulation-Footnote-11172917 -Node: Array Data Types1172954 -Ref: Array Data Types-Footnote-11175776 -Node: Array Functions1175876 -Node: Flattening Arrays1180905 -Node: Creating Arrays1187957 -Node: Redirection API1192807 -Node: Extension API Variables1195828 -Node: Extension Versioning1196553 -Ref: gawk-api-version1196990 -Node: Extension GMP/MPFR Versioning1198778 -Node: Extension API Informational Variables1200484 -Node: Extension API Boilerplate1201645 -Node: Changes from API V11205781 -Node: Finding Extensions1207415 -Node: Extension Example1207990 -Node: Internal File Description1208814 -Node: Internal File Ops1213138 -Ref: Internal File Ops-Footnote-11224696 -Node: Using Internal File Ops1224844 -Ref: Using Internal File Ops-Footnote-11227275 -Node: Extension Samples1227553 -Node: Extension Sample File Functions1229122 -Node: Extension Sample Fnmatch1237260 -Node: Extension Sample Fork1238855 -Node: Extension Sample Inplace1240131 -Node: Extension Sample Ord1243803 -Node: Extension Sample Readdir1244679 -Ref: table-readdir-file-types1245576 -Node: Extension Sample Revout1246714 -Node: Extension Sample Rev2way1247311 -Node: Extension Sample Read write array1248063 -Node: Extension Sample Readfile1251337 -Node: Extension Sample Time1252468 -Node: Extension Sample API Tests1254758 -Node: gawkextlib1255266 -Node: Extension summary1258302 -Node: Extension Exercises1262160 -Node: Language History1263438 -Node: V7/SVR3.11265152 -Node: SVR41267502 -Node: POSIX1269034 -Node: BTL1270459 -Node: POSIX/GNU1271228 -Node: Feature History1277759 -Node: Common Extensions1297326 -Node: Ranges and Locales1298803 -Ref: Ranges and Locales-Footnote-11303604 -Ref: Ranges and Locales-Footnote-21303631 -Ref: Ranges and Locales-Footnote-31303870 -Node: Contributors1304093 -Node: History summary1310298 -Node: Installation1311744 -Node: Gawk Distribution1312708 -Node: Getting1313200 -Node: Extracting1314199 -Node: Distribution contents1315911 -Node: Unix Installation1323991 -Node: Quick Installation1324813 -Node: Compiling with MPFR1327359 -Node: Shell Startup Files1328065 -Node: Additional Configuration Options1329222 -Node: Configuration Philosophy1331609 -Node: Compiling from Git1334111 -Node: Building the Documentation1334670 -Node: Non-Unix Installation1336082 -Node: PC Installation1336558 -Node: PC Binary Installation1337431 -Node: PC Compiling1338336 -Node: PC Using1339514 -Node: Cygwin1343242 -Node: MSYS1344498 -Node: OpenVMS Installation1345130 -Node: OpenVMS Compilation1345811 -Ref: OpenVMS Compilation-Footnote-11347294 -Node: OpenVMS Dynamic Extensions1347356 -Node: OpenVMS Installation Details1348992 -Node: OpenVMS Running1351427 -Node: OpenVMS GNV1355564 -Node: Bugs1356319 -Node: Bug definition1357243 -Node: Bug address1360894 -Node: Usenet1364485 -Node: Performance bugs1365716 -Node: Asking for help1368734 -Node: Maintainers1370725 -Node: Other Versions1371752 -Node: Installation summary1380684 -Node: Notes1382068 -Node: Compatibility Mode1382878 -Node: Additions1383700 -Node: Accessing The Source1384645 -Node: Adding Code1386180 -Node: New Ports1393316 -Node: Derived Files1397826 -Ref: Derived Files-Footnote-11403673 -Ref: Derived Files-Footnote-21403708 -Ref: Derived Files-Footnote-31404325 -Node: Future Extensions1404439 -Node: Implementation Limitations1405111 -Node: Extension Design1406353 -Node: Old Extension Problems1407517 -Ref: Old Extension Problems-Footnote-11409093 -Node: Extension New Mechanism Goals1409154 -Ref: Extension New Mechanism Goals-Footnote-11412650 -Node: Extension Other Design Decisions1412851 -Node: Extension Future Growth1415050 -Node: Notes summary1415674 -Node: Basic Concepts1416887 -Node: Basic High Level1417572 -Ref: figure-general-flow1417854 -Ref: figure-process-flow1418561 -Ref: Basic High Level-Footnote-11421962 -Node: Basic Data Typing1422151 -Node: Glossary1425569 -Node: Copying1458691 -Node: GNU Free Documentation License1496452 -Node: Index1521775 +Ref: Persistent Memory-Footnote-1952175 +Node: Extension Philosophy952306 +Node: Advanced Features Summary953841 +Node: Internationalization956111 +Node: I18N and L10N957817 +Node: Explaining gettext958512 +Ref: Explaining gettext-Footnote-1964665 +Ref: Explaining gettext-Footnote-2964860 +Node: Programmer i18n965025 +Ref: Programmer i18n-Footnote-1970138 +Node: Translator i18n970187 +Node: String Extraction971023 +Ref: String Extraction-Footnote-1972201 +Node: Printf Ordering972299 +Ref: Printf Ordering-Footnote-1975161 +Node: I18N Portability975229 +Ref: I18N Portability-Footnote-1977803 +Node: I18N Example977874 +Ref: I18N Example-Footnote-1981274 +Ref: I18N Example-Footnote-2981350 +Node: Gawk I18N981467 +Node: I18N Summary982123 +Node: Debugger983524 +Node: Debugging984548 +Node: Debugging Concepts984997 +Node: Debugging Terms986823 +Node: Awk Debugging989436 +Ref: Awk Debugging-Footnote-1990413 +Node: Sample Debugging Session990553 +Node: Debugger Invocation991105 +Node: Finding The Bug992734 +Node: List of Debugger Commands999420 +Node: Breakpoint Control1000797 +Node: Debugger Execution Control1004629 +Node: Viewing And Changing Data1008109 +Node: Execution Stack1011847 +Node: Debugger Info1013528 +Node: Miscellaneous Debugger Commands1017827 +Node: Readline Support1023080 +Node: Limitations1024026 +Node: Debugging Summary1026670 +Node: Namespaces1027973 +Node: Global Namespace1029100 +Node: Qualified Names1030545 +Node: Default Namespace1031580 +Node: Changing The Namespace1032355 +Node: Naming Rules1034049 +Node: Internal Name Management1035964 +Node: Namespace Example1037034 +Node: Namespace And Features1039617 +Node: Namespace Summary1041074 +Node: Arbitrary Precision Arithmetic1042587 +Node: Computer Arithmetic1044106 +Ref: table-numeric-ranges1047923 +Ref: table-floating-point-ranges1048421 +Ref: Computer Arithmetic-Footnote-11049080 +Node: Math Definitions1049139 +Ref: table-ieee-formats1052184 +Node: MPFR features1052758 +Node: MPFR On Parole1053211 +Ref: MPFR On Parole-Footnote-11054055 +Node: MPFR Intro1054214 +Node: FP Math Caution1055904 +Ref: FP Math Caution-Footnote-11056978 +Node: Inexactness of computations1057355 +Node: Inexact representation1058386 +Node: Comparing FP Values1059769 +Node: Errors accumulate1061027 +Node: Strange values1062494 +Ref: Strange values-Footnote-11065160 +Node: Getting Accuracy1065265 +Node: Try To Round1068002 +Node: Setting precision1068909 +Ref: table-predefined-precision-strings1069614 +Node: Setting the rounding mode1071499 +Ref: table-gawk-rounding-modes1071881 +Ref: Setting the rounding mode-Footnote-11075939 +Node: Arbitrary Precision Integers1076122 +Ref: Arbitrary Precision Integers-Footnote-11079334 +Node: Checking for MPFR1079490 +Node: POSIX Floating Point Problems1080980 +Ref: POSIX Floating Point Problems-Footnote-11085844 +Node: Floating point summary1085882 +Node: Dynamic Extensions1088146 +Node: Extension Intro1089745 +Node: Plugin License1091053 +Node: Extension Mechanism Outline1091866 +Ref: figure-load-extension1092317 +Ref: figure-register-new-function1093902 +Ref: figure-call-new-function1095012 +Node: Extension API Description1097136 +Node: Extension API Functions Introduction1098865 +Ref: table-api-std-headers1100763 +Node: General Data Types1105227 +Ref: General Data Types-Footnote-11114395 +Node: Memory Allocation Functions1114710 +Ref: Memory Allocation Functions-Footnote-11119435 +Node: Constructor Functions1119534 +Node: API Ownership of MPFR and GMP Values1123439 +Node: Registration Functions1125000 +Node: Extension Functions1125704 +Node: Exit Callback Functions1131280 +Node: Extension Version String1132599 +Node: Input Parsers1133294 +Node: Output Wrappers1147938 +Node: Two-way processors1152786 +Node: Printing Messages1155147 +Ref: Printing Messages-Footnote-11156361 +Node: Updating ERRNO1156516 +Node: Requesting Values1157315 +Ref: table-value-types-returned1158068 +Node: Accessing Parameters1159177 +Node: Symbol Table Access1160461 +Node: Symbol table by name1160977 +Ref: Symbol table by name-Footnote-11164188 +Node: Symbol table by cookie1164320 +Ref: Symbol table by cookie-Footnote-11168601 +Node: Cached values1168665 +Ref: Cached values-Footnote-11172309 +Node: Array Manipulation1172466 +Ref: Array Manipulation-Footnote-11173569 +Node: Array Data Types1173606 +Ref: Array Data Types-Footnote-11176428 +Node: Array Functions1176528 +Node: Flattening Arrays1181557 +Node: Creating Arrays1188609 +Node: Redirection API1193459 +Node: Extension API Variables1196480 +Node: Extension Versioning1197205 +Ref: gawk-api-version1197642 +Node: Extension GMP/MPFR Versioning1199430 +Node: Extension API Informational Variables1201136 +Node: Extension API Boilerplate1202297 +Node: Changes from API V11206433 +Node: Finding Extensions1208067 +Node: Extension Example1208642 +Node: Internal File Description1209466 +Node: Internal File Ops1213790 +Ref: Internal File Ops-Footnote-11225348 +Node: Using Internal File Ops1225496 +Ref: Using Internal File Ops-Footnote-11227927 +Node: Extension Samples1228205 +Node: Extension Sample File Functions1229774 +Node: Extension Sample Fnmatch1237912 +Node: Extension Sample Fork1239507 +Node: Extension Sample Inplace1240783 +Node: Extension Sample Ord1244455 +Node: Extension Sample Readdir1245331 +Ref: table-readdir-file-types1246228 +Node: Extension Sample Revout1247366 +Node: Extension Sample Rev2way1247963 +Node: Extension Sample Read write array1248715 +Node: Extension Sample Readfile1251989 +Node: Extension Sample Time1253120 +Node: Extension Sample API Tests1255410 +Node: gawkextlib1255918 +Node: Extension summary1258954 +Node: Extension Exercises1262812 +Node: Language History1264090 +Node: V7/SVR3.11265804 +Node: SVR41268154 +Node: POSIX1269686 +Node: BTL1271111 +Node: POSIX/GNU1271880 +Node: Feature History1278411 +Node: Common Extensions1297978 +Node: Ranges and Locales1299455 +Ref: Ranges and Locales-Footnote-11304256 +Ref: Ranges and Locales-Footnote-21304283 +Ref: Ranges and Locales-Footnote-31304522 +Node: Contributors1304745 +Node: History summary1310950 +Node: Installation1312396 +Node: Gawk Distribution1313360 +Node: Getting1313852 +Node: Extracting1314851 +Node: Distribution contents1316563 +Node: Unix Installation1324643 +Node: Quick Installation1325465 +Node: Compiling with MPFR1328011 +Node: Shell Startup Files1328717 +Node: Additional Configuration Options1329874 +Node: Configuration Philosophy1332261 +Node: Compiling from Git1334763 +Node: Building the Documentation1335322 +Node: Non-Unix Installation1336734 +Node: PC Installation1337210 +Node: PC Binary Installation1338083 +Node: PC Compiling1338988 +Node: PC Using1340166 +Node: Cygwin1343894 +Node: MSYS1345150 +Node: OpenVMS Installation1345782 +Node: OpenVMS Compilation1346463 +Ref: OpenVMS Compilation-Footnote-11347946 +Node: OpenVMS Dynamic Extensions1348008 +Node: OpenVMS Installation Details1349644 +Node: OpenVMS Running1352079 +Node: OpenVMS GNV1356216 +Node: Bugs1356971 +Node: Bug definition1357895 +Node: Bug address1361546 +Node: Usenet1365137 +Node: Performance bugs1366368 +Node: Asking for help1369386 +Node: Maintainers1371377 +Node: Other Versions1372404 +Node: Installation summary1381336 +Node: Notes1382720 +Node: Compatibility Mode1383530 +Node: Additions1384352 +Node: Accessing The Source1385297 +Node: Adding Code1386832 +Node: New Ports1393968 +Node: Derived Files1398478 +Ref: Derived Files-Footnote-11404325 +Ref: Derived Files-Footnote-21404360 +Ref: Derived Files-Footnote-31404977 +Node: Future Extensions1405091 +Node: Implementation Limitations1405763 +Node: Extension Design1407005 +Node: Old Extension Problems1408169 +Ref: Old Extension Problems-Footnote-11409745 +Node: Extension New Mechanism Goals1409806 +Ref: Extension New Mechanism Goals-Footnote-11413302 +Node: Extension Other Design Decisions1413503 +Node: Extension Future Growth1415702 +Node: Notes summary1416326 +Node: Basic Concepts1417539 +Node: Basic High Level1418224 +Ref: figure-general-flow1418506 +Ref: figure-process-flow1419213 +Ref: Basic High Level-Footnote-11422614 +Node: Basic Data Typing1422803 +Node: Glossary1426221 +Node: Copying1459343 +Node: GNU Free Documentation License1497104 +Node: Index1522427 End Tag Table |