summaryrefslogtreecommitdiff
path: root/doc/builtins.ps
blob: 930d67c9bf688f8445990917a550e34c8cd5876a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
2052
2053
2054
2055
2056
2057
2058
2059
2060
2061
2062
2063
2064
2065
2066
2067
2068
2069
2070
2071
2072
2073
2074
2075
2076
2077
2078
2079
2080
2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
2233
2234
2235
2236
2237
2238
2239
2240
2241
2242
2243
2244
2245
2246
2247
2248
2249
2250
2251
2252
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430
2431
2432
2433
2434
2435
2436
2437
2438
2439
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450
2451
2452
2453
2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488
2489
2490
2491
2492
2493
2494
2495
2496
2497
2498
2499
2500
2501
2502
2503
2504
2505
2506
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517
2518
2519
2520
2521
2522
2523
2524
2525
2526
2527
2528
2529
2530
2531
2532
2533
2534
2535
2536
2537
2538
2539
2540
2541
2542
2543
2544
2545
2546
2547
2548
2549
2550
2551
2552
2553
2554
2555
%!PS-Adobe-3.0
%%Creator: groff version 1.19.2
%%CreationDate: Mon Dec 29 10:37:30 2008
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
%%+ font Symbol
%%+ font Courier
%%DocumentSuppliedResources: procset grops 1.19 2
%%Pages: 20
%%PageOrder: Ascend
%%DocumentMedia: Default 595 842 0 () ()
%%Orientation: Portrait
%%EndComments
%%BeginDefaults
%%PageMedia: Default
%%EndDefaults
%%BeginProlog
%%BeginResource: procset grops 1.19 2
%!PS-Adobe-3.0 Resource-ProcSet
/setpacking where{
pop
currentpacking
true setpacking
}if
/grops 120 dict dup begin
/SC 32 def
/A/show load def
/B{0 SC 3 -1 roll widthshow}bind def
/C{0 exch ashow}bind def
/D{0 exch 0 SC 5 2 roll awidthshow}bind def
/E{0 rmoveto show}bind def
/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def
/G{0 rmoveto 0 exch ashow}bind def
/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/I{0 exch rmoveto show}bind def
/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def
/K{0 exch rmoveto 0 exch ashow}bind def
/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/M{rmoveto show}bind def
/N{rmoveto 0 SC 3 -1 roll widthshow}bind def
/O{rmoveto 0 exch ashow}bind def
/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/Q{moveto show}bind def
/R{moveto 0 SC 3 -1 roll widthshow}bind def
/S{moveto 0 exch ashow}bind def
/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/SF{
findfont exch
[exch dup 0 exch 0 exch neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/MF{
findfont
[5 2 roll
0 3 1 roll
neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/level0 0 def
/RES 0 def
/PL 0 def
/LS 0 def
/MANUAL{
statusdict begin/manualfeed true store end
}bind def
/PLG{
gsave newpath clippath pathbbox grestore
exch pop add exch pop
}bind def
/BP{
/level0 save def
1 setlinecap
1 setlinejoin
72 RES div dup scale
LS{
90 rotate
}{
0 PL translate
}ifelse
1 -1 scale
}bind def
/EP{
level0 restore
showpage
}def
/DA{
newpath arcn stroke
}bind def
/SN{
transform
.25 sub exch .25 sub exch
round .25 add exch round .25 add exch
itransform
}bind def
/DL{
SN
moveto
SN
lineto stroke
}bind def
/DC{
newpath 0 360 arc closepath
}bind def
/TM matrix def
/DE{
TM currentmatrix pop
translate scale newpath 0 0 .5 0 360 arc closepath
TM setmatrix
}bind def
/RC/rcurveto load def
/RL/rlineto load def
/ST/stroke load def
/MT/moveto load def
/CL/closepath load def
/Fr{
setrgbcolor fill
}bind def
/setcmykcolor where{
pop
/Fk{
setcmykcolor fill
}bind def
}if
/Fg{
setgray fill
}bind def
/FL/fill load def
/LW/setlinewidth load def
/Cr/setrgbcolor load def
/setcmykcolor where{
pop
/Ck/setcmykcolor load def
}if
/Cg/setgray load def
/RE{
findfont
dup maxlength 1 index/FontName known not{1 add}if dict begin
{
1 index/FID ne{def}{pop pop}ifelse
}forall
/Encoding exch def
dup/FontName exch def
currentdict end definefont pop
}bind def
/DEFS 0 def
/EBEGIN{
moveto
DEFS begin
}bind def
/EEND/end load def
/CNT 0 def
/level1 0 def
/PBEGIN{
/level1 save def
translate
div 3 1 roll div exch scale
neg exch neg exch translate
0 setgray
0 setlinecap
1 setlinewidth
0 setlinejoin
10 setmiterlimit
[]0 setdash
/setstrokeadjust where{
pop
false setstrokeadjust
}if
/setoverprint where{
pop
false setoverprint
}if
newpath
/CNT countdictstack def
userdict begin
/showpage{}def
/setpagedevice{}def
}bind def
/PEND{
countdictstack CNT sub{end}repeat
level1 restore
}bind def
end def
/setpacking where{
pop
setpacking
}if
%%EndResource
%%EndProlog
%%BeginSetup
%%BeginFeature: *PageSize Default
<< /PageSize [ 595 842 ] /ImagingBBox null >> setpagedevice
%%EndFeature
%%IncludeResource: font Times-Roman
%%IncludeResource: font Times-Bold
%%IncludeResource: font Times-Italic
%%IncludeResource: font Symbol
%%IncludeResource: font Courier
grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72
def/PL 841.89 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron
/Zcaron/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen
/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon
/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O
/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex
/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y
/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft
/guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl
/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut
/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash
/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen
/brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft
/logicalnot/minus/registered/macron/degree/plusminus/twosuperior
/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior
/ordmasculine/guilsinglright/onequarter/onehalf/threequarters
/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE
/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex
/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis
/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn
/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla
/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis
/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash
/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def
/Courier@0 ENC0/Courier RE/Times-Italic@0 ENC0/Times-Italic RE
/Times-Bold@0 ENC0/Times-Bold RE/Times-Roman@0 ENC0/Times-Roman RE
%%EndSetup
%%Page: 1 1
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10.95
/Times-Bold@0 SF -.219(NA)72 84 S(ME).219 E F0 1.325
(bash, :, ., [, alias, bg, bind, break, b)108 96 R 1.325(uiltin, caller)
-.2 F 3.825(,c)-.4 G 1.324
(d, command, compgen, complete, compopt, continue,)-3.825 F .903
(declare, dirs, diso)108 108 R .903(wn, echo, enable, e)-.25 F -.25(va)
-.25 G .904(l, e).25 F -.15(xe)-.15 G .904(c, e).15 F .904(xit, e)-.15 F
.904(xport, f)-.15 F .904(alse, fc, fg, getopts, hash, help, history)-.1
F 3.404(,j)-.65 G(obs,)-3.404 E .133(kill, let, local, logout, map\214l\
e, popd, printf, pushd, pwd, read, readonly)108 120 R 2.633(,r)-.65 G
.133(eturn, set, shift, shopt, source, sus-)-2.633 F .279(pend, test, t\
imes, trap, true, type, typeset, ulimit, umask, unalias, unset, w)108
132 R .279(ait \255 bash b)-.1 F .279(uilt-in commands, see)-.2 F/F2 10
/Times-Bold@0 SF(bash)108 144 Q F0(\(1\))A F1 -.329(BA)72 160.8 S(SH B)
.329 E(UIL)-.11 E(TIN COMMANDS)-1.007 E F0 .063
(Unless otherwise noted, each b)108 172.8 R .062(uiltin command documen\
ted in this section as accepting options preceded by)-.2 F F2<ad>108
184.8 Q F0(accepts)3.8 E F2<adad>3.8 E F0 1.3
(to signify the end of the options.)3.8 F -.15(Fo)6.3 G 3.8(re).15 G 1.3
(xample, the)-3.95 F F2(:)3.8 E F0(,)A F2(true)3.8 E F0(,)A F2(false)3.8
E F0 3.8(,a)C(nd)-3.8 E F2(test)3.8 E F0 -.2(bu)3.8 G 1.3(iltins do not)
.2 F(accept options.)108 196.8 Q F2(:)108 214.8 Q F0([)2.5 E/F3 10
/Times-Italic@0 SF(ar)A(guments)-.37 E F0(])A .452(No ef)144 226.8 R
.452(fect; the command does nothing be)-.25 F .452(yond e)-.15 F
(xpanding)-.15 E F3(ar)3.282 E(guments)-.37 E F0 .451(and performing an)
3.221 F 2.951(ys)-.15 G(peci\214ed)-2.951 E 2.5(redirections. A)144
238.8 R(zero e)2.5 E(xit code is returned.)-.15 E F2(.)110.5 255.6 Q F3
(\214lename)6.666 E F0([)2.5 E F3(ar)A(guments)-.37 E F0(])A F2(sour)108
267.6 Q(ce)-.18 E F3(\214lename)2.5 E F0([)2.5 E F3(ar)A(guments)-.37 E
F0(])A 1.02(Read and e)144 279.6 R -.15(xe)-.15 G 1.02
(cute commands from).15 F F3(\214lename)5.43 E F0 1.02
(in the current shell en)3.7 F 1.02(vironment and return the e)-.4 F
(xit)-.15 E 1.68(status of the last command e)144 291.6 R -.15(xe)-.15 G
1.68(cuted from).15 F F3(\214lename)4.18 E F0 6.68(.I).18 G(f)-6.68 E F3
(\214lename)6.09 E F0 1.68(does not contain a slash, \214le)4.36 F .608
(names in)144 303.6 R/F4 9/Times-Bold@0 SF -.666(PA)3.108 G(TH)-.189 E
F0 .608(are used to \214nd the directory containing)2.858 F F3
(\214lename)3.108 E F0 5.608(.T).18 G .608(he \214le searched for in)
-5.608 F F4 -.666(PA)3.108 G(TH)-.189 E F0 .833(need not be e)144 315.6
R -.15(xe)-.15 G 3.333(cutable. When).15 F F2(bash)3.333 E F0 .832
(is not in)3.333 F F3 .832(posix mode)3.332 F F0 3.332(,t)C .832
(he current directory is searched if no)-3.332 F .981
(\214le is found in)144 327.6 R F4 -.666(PA)3.481 G(TH)-.189 E/F5 9
/Times-Roman@0 SF(.)A F0 .981(If the)5.481 F F2(sour)3.481 E(cepath)-.18
E F0 .981(option to the)3.481 F F2(shopt)3.481 E F0 -.2(bu)3.481 G .981
(iltin command is turned of).2 F .982(f, the)-.25 F F4 -.666(PA)144
339.6 S(TH)-.189 E F0 .112(is not searched.)2.363 F .112(If an)5.112 F
(y)-.15 E F3(ar)2.612 E(guments)-.37 E F0 .112(are supplied, the)2.612 F
2.612(yb)-.15 G .112(ecome the positional parameters when)-2.612 F F3
(\214lename)144 351.6 Q F0 .341(is e)2.841 F -.15(xe)-.15 G 2.841
(cuted. Otherwise).15 F .341(the positional parameters are unchanged.)
2.841 F .342(The return status is the)5.342 F .716
(status of the last command e)144 363.6 R .716
(xited within the script \(0 if no commands are e)-.15 F -.15(xe)-.15 G
.716(cuted\), and f).15 F .715(alse if)-.1 F F3(\214lename)145.91 375.6
Q F0(is not found or cannot be read.)2.68 E F2(alias)108 392.4 Q F0([)
2.5 E F2<ad70>A F0 2.5(][)C F3(name)-2.5 E F0([=)A F3(value)A F0 2.5(].)
C(..])-2.5 E F2(Alias)144 404.4 Q F0 2.724(with no ar)5.224 F 2.724
(guments or with the)-.18 F F2<ad70>5.224 E F0 2.724
(option prints the list of aliases in the form)5.224 F F2(alias)5.225 E
F3(name)144 416.4 Q F0(=)A F3(value)A F0 .58(on standard output.)3.08 F
.58(When ar)5.58 F .58
(guments are supplied, an alias is de\214ned for each)-.18 F F3(name)
3.08 E F0(whose)144 428.4 Q F3(value)2.895 E F0 .395(is gi)2.895 F -.15
(ve)-.25 G 2.895(n. A).15 F .395(trailing space in)2.895 F F3(value)
5.395 E F0 .395(causes the ne)2.895 F .395(xt w)-.15 F .395
(ord to be check)-.1 F .395(ed for alias sub-)-.1 F .054
(stitution when the alias is e)144 440.4 R 2.554(xpanded. F)-.15 F .054
(or each)-.15 F F3(name)2.554 E F0 .054(in the ar)2.554 F .054
(gument list for which no)-.18 F F3(value)2.554 E F0 .053(is sup-)2.553
F 1.313(plied, the name and v)144 452.4 R 1.314
(alue of the alias is printed.)-.25 F F2(Alias)6.314 E F0 1.314
(returns true unless a)3.814 F F3(name)3.814 E F0 1.314(is gi)3.814 F
-.15(ve)-.25 G 3.814(nf).15 G(or)-3.814 E
(which no alias has been de\214ned.)144 464.4 Q F2(bg)108 481.2 Q F0([)
2.5 E F3(jobspec)A F0(...])2.5 E .745(Resume each suspended job)144
493.2 R F3(jobspec)3.245 E F0 .745
(in the background, as if it had been started with)3.245 F F2(&)3.244 E
F0 5.744(.I)C(f)-5.744 E F3(job-)4.984 E(spec)144 505.2 Q F0 .671
(is not present, the shell')3.481 F 3.171(sn)-.55 G .672(otion of the)
-3.171 F F3(curr)3.172 E .672(ent job)-.37 F F0 .672(is used.)3.172 F F2
(bg)5.672 E F3(jobspec)4.912 E F0 .672(returns 0 unless run)3.482 F .419
(when job control is disabled or)144 517.2 R 2.919(,w)-.4 G .419
(hen run with job control enabled, an)-2.919 F 2.918(ys)-.15 G
(peci\214ed)-2.918 E F3(jobspec)2.918 E F0 -.1(wa)2.918 G 2.918(sn).1 G
(ot)-2.918 E(found or w)144 529.2 Q(as started without job control.)-.1
E F2(bind)108 546 Q F0([)2.5 E F2<ad6d>A F3 -.1(ke)2.5 G(ymap)-.2 E F0
2.5(][)C F2(\255lpsvPSV)-2.5 E F0(])A F2(bind)108 558 Q F0([)2.5 E F2
<ad6d>A F3 -.1(ke)2.5 G(ymap)-.2 E F0 2.5(][)C F2<ad71>-2.5 E F3
(function)2.5 E F0 2.5(][)C F2<ad75>-2.5 E F3(function)2.5 E F0 2.5(][)C
F2<ad72>-2.5 E F3 -.1(ke)2.5 G(yseq)-.2 E F0(])A F2(bind)108 570 Q F0([)
2.5 E F2<ad6d>A F3 -.1(ke)2.5 G(ymap)-.2 E F0(])A F2<ad66>2.5 E F3
(\214lename)2.5 E F2(bind)108 582 Q F0([)2.5 E F2<ad6d>A F3 -.1(ke)2.5 G
(ymap)-.2 E F0(])A F2<ad78>2.5 E F3 -.1(ke)2.5 G(yseq)-.2 E F0(:)A F3
(shell\255command)A F2(bind)108 594 Q F0([)2.5 E F2<ad6d>A F3 -.1(ke)2.5
G(ymap)-.2 E F0(])A F3 -.1(ke)2.5 G(yseq)-.2 E F0(:)A F3
(function\255name)A F2(bind)108 606 Q F3 -.37(re)2.5 G
(adline\255command).37 E F0 .238(Display current)144 618 R F2 -.18(re)
2.738 G(adline).18 E F0 -.1(ke)2.738 G 2.738(ya)-.05 G .239
(nd function bindings, bind a k)-2.738 F .539 -.15(ey s)-.1 H .239
(equence to a).15 F F2 -.18(re)2.739 G(adline).18 E F0 .239(function or)
2.739 F .476(macro, or set a)144 630 R F2 -.18(re)2.976 G(adline).18 E
F0 -.25(va)2.976 G 2.976(riable. Each).25 F .476(non-option ar)2.976 F
.475(gument is a command as it w)-.18 F .475(ould appear in)-.1 F F3
(.inputr)144 642 Q(c)-.37 E F0 2.983(,b).31 G .484
(ut each binding or command must be passed as a separate ar)-3.183 F
.484(gument; e.g., '"\\C\255x\\C\255r":)-.18 F 2.5
(re\255read\255init\255\214le'. Options,)144 654 R(if supplied, ha)2.5 E
.3 -.15(ve t)-.2 H(he follo).15 E(wing meanings:)-.25 E F2<ad6d>144 666
Q F3 -.1(ke)2.5 G(ymap)-.2 E F0(Use)180 678 Q F3 -.1(ke)5.159 G(ymap)-.2
E F0 2.659(as the k)5.349 F -.15(ey)-.1 G 2.658(map to be af).15 F 2.658
(fected by the subsequent bindings.)-.25 F(Acceptable)7.658 E F3 -.1(ke)
180 690 S(ymap)-.2 E F0 3.192(names are)5.882 F F3 3.192
(emacs, emacs\255standar)5.692 F 3.193
(d, emacs\255meta, emacs\255ctlx, vi, vi\255mo)-.37 F(ve)-.1 E(,)-.1 E
(vi\255command)180 702 Q F0 4.43(,a)C(nd)-4.43 E F3(vi\255insert)4.429 E
F0(.).68 E F3(vi)6.929 E F0 1.929(is equi)4.429 F -.25(va)-.25 G 1.929
(lent to).25 F F3(vi\255command)4.429 E F0(;)A F3(emacs)4.429 E F0 1.929
(is equi)4.429 F -.25(va)-.25 G 1.929(lent to).25 F F3(emacs\255standar)
180 714 Q(d)-.37 E F0(.)A(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(1)
203.725 E 0 Cg EP
%%Page: 2 2
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
/Times-Bold@0 SF<ad6c>144 84 Q F0(List the names of all)27.52 E F1 -.18
(re)2.5 G(adline).18 E F0(functions.)2.5 E F1<ad70>144 96 Q F0(Display)
24.74 E F1 -.18(re)2.5 G(adline).18 E F0
(function names and bindings in such a w)2.5 E(ay that the)-.1 E 2.5(yc)
-.15 G(an be re-read.)-2.5 E F1<ad50>144 108 Q F0(List current)24.19 E
F1 -.18(re)2.5 G(adline).18 E F0(function names and bindings.)2.5 E F1
<ad73>144 120 Q F0(Display)26.41 E F1 -.18(re)3.655 G(adline).18 E F0
-.1(ke)3.655 G 3.655(ys)-.05 G 1.155
(equences bound to macros and the strings the)-3.655 F 3.655(yo)-.15 G
1.155(utput in such a)-3.655 F -.1(wa)180 132 S 2.5(yt).1 G(hat the)-2.5
E 2.5(yc)-.15 G(an be re-read.)-2.5 E F1<ad53>144 144 Q F0(Display)24.74
E F1 -.18(re)2.5 G(adline).18 E F0 -.1(ke)2.5 G 2.5(ys)-.05 G
(equences bound to macros and the strings the)-2.5 E 2.5(yo)-.15 G
(utput.)-2.5 E F1<ad76>144 156 Q F0(Display)25.3 E F1 -.18(re)2.5 G
(adline).18 E F0 -.25(va)2.5 G(riable names and v).25 E
(alues in such a w)-.25 E(ay that the)-.1 E 2.5(yc)-.15 G
(an be re-read.)-2.5 E F1<ad56>144 168 Q F0(List current)23.08 E F1 -.18
(re)2.5 G(adline).18 E F0 -.25(va)2.5 G(riable names and v).25 E(alues.)
-.25 E F1<ad66>144 180 Q/F2 10/Times-Italic@0 SF(\214lename)2.5 E F0
(Read k)180 192 Q .3 -.15(ey b)-.1 H(indings from).15 E F2(\214lename)
2.5 E F0(.)A F1<ad71>144 204 Q F2(function)2.5 E F0(Query about which k)
180 216 Q -.15(ey)-.1 G 2.5(si).15 G -1.9 -.4(nv o)-2.5 H .2 -.1(ke t).4
H(he named).1 E F2(function)2.5 E F0(.)A F1<ad75>144 228 Q F2(function)
2.5 E F0(Unbind all k)180 240 Q -.15(ey)-.1 G 2.5(sb).15 G
(ound to the named)-2.5 E F2(function)2.5 E F0(.)A F1<ad72>144 252 Q F2
-.1(ke)2.5 G(yseq)-.2 E F0(Remo)180 264 Q .3 -.15(ve a)-.15 H .3 -.15
(ny c).15 H(urrent binding for).15 E F2 -.1(ke)2.5 G(yseq)-.2 E F0(.)A
F1<ad78>144 276 Q F2 -.1(ke)2.5 G(yseq)-.2 E F1(:)A F2(shell\255command)
A F0(Cause)180 288 Q F2(shell\255command)4.325 E F0 1.825(to be e)4.325
F -.15(xe)-.15 G 1.825(cuted whene).15 F -.15(ve)-.25 G(r).15 E F2 -.1
(ke)4.325 G(yseq)-.2 E F0 1.825(is entered.)4.325 F(When)6.825 E F2
(shell\255com-)4.325 E(mand)180 300 Q F0 1.113(is e)3.613 F -.15(xe)-.15
G 1.113(cuted, the shell sets the).15 F F1(READLINE_LINE)3.613 E F0 -.25
(va)3.613 G 1.113(riable to the contents of the).25 F F1 -.18(re)180 312
S(adline).18 E F0 .587(line b)3.087 F(uf)-.2 E .587(fer and the)-.25 F
F1(READLINE_POINT)3.087 E F0 -.25(va)3.087 G .586
(riable to the current location of the).25 F 1.24(insertion point.)180
324 R 1.241(If the e)6.241 F -.15(xe)-.15 G 1.241
(cuted command changes the v).15 F 1.241(alue of)-.25 F F1
(READLINE_LINE)3.741 E F0(or)3.741 E F1(READLINE_POINT)180 336 Q F0 2.5
(,t)C(hose ne)-2.5 E 2.5(wv)-.25 G
(alues will be re\215ected in the editing state.)-2.75 E(The return v)
144 352.8 Q(alue is 0 unless an unrecognized option is gi)-.25 E -.15
(ve)-.25 G 2.5(no).15 G 2.5(ra)-2.5 G 2.5(ne)-2.5 G(rror occurred.)-2.5
E F1(br)108 369.6 Q(eak)-.18 E F0([)2.5 E F2(n)A F0(])A .055
(Exit from within a)144 381.6 R F1 -.25(fo)2.555 G(r).25 E F0(,)A F1
(while)2.555 E F0(,)A F1(until)2.555 E F0 2.555(,o)C(r)-2.555 E F1
(select)2.555 E F0 2.555(loop. If)2.555 F F2(n)2.555 E F0 .055
(is speci\214ed, break)2.555 F F2(n)2.555 E F0(le)2.555 E -.15(ve)-.25 G
(ls.).15 E F2(n)5.414 E F0 .054(must be)2.794 F/F3 10/Symbol SF<b3>2.554
E F0(1.)2.554 E(If)144 393.6 Q F2(n)3.074 E F0 .215(is greater than the\
 number of enclosing loops, all enclosing loops are e)2.954 F 2.715
(xited. The)-.15 F .215(return v)2.715 F(alue)-.25 E(is 0 unless)144
405.6 Q F2(n)2.5 E F0(is not greater than or equal to 1.)2.5 E F1 -.2
(bu)108 422.4 S(iltin).2 E F2(shell\255b)2.5 E(uiltin)-.2 E F0([)2.5 E
F2(ar)A(guments)-.37 E F0(])A(Ex)144 434.4 Q .793
(ecute the speci\214ed shell b)-.15 F .793(uiltin, passing it)-.2 F F2
(ar)3.293 E(guments)-.37 E F0 3.293(,a).27 G .793(nd return its e)-3.293
F .792(xit status.)-.15 F .792(This is useful)5.792 F .615
(when de\214ning a function whose name is the same as a shell b)144
446.4 R .616(uiltin, retaining the functionality of)-.2 F .57(the b)144
458.4 R .57(uiltin within the function.)-.2 F(The)5.57 E F1(cd)3.07 E F0
-.2(bu)3.07 G .57(iltin is commonly rede\214ned this w).2 F(ay)-.1 E
5.57(.T)-.65 G .57(he return status)-5.57 F(is f)144 470.4 Q(alse if)-.1
E F2(shell\255b)2.84 E(uiltin)-.2 E F0(is not a shell b)2.74 E
(uiltin command.)-.2 E F1(caller)108 487.2 Q F0([)2.5 E F2 -.2(ex)C(pr)
.2 E F0(])A .253(Returns the conte)144 499.2 R .254(xt of an)-.15 F
2.754(ya)-.15 G(cti)-2.754 E .554 -.15(ve s)-.25 H .254
(ubroutine call \(a shell function or a script e).15 F -.15(xe)-.15 G
.254(cuted with the).15 F F1(.)2.754 E F0(or)2.754 E F1(sour)144 511.2 Q
(ce)-.18 E F0 -.2(bu)3.063 G 3.063(iltins. W).2 F(ithout)-.4 E F2 -.2
(ex)3.062 G(pr).2 E F0(,)A F1(caller)3.062 E F0 .562
(displays the line number and source \214lename of the current)3.062 F
.253(subroutine call.)144 523.2 R .253(If a non-ne)5.253 F -.05(ga)-.15
G(ti).05 E .553 -.15(ve i)-.25 H(nte).15 E .253(ger is supplied as)-.15
F F2 -.2(ex)2.753 G(pr).2 E F0(,)A F1(caller)2.753 E F0 .254
(displays the line number)2.754 F 2.754(,s)-.4 G(ub-)-2.754 E 1.327(rou\
tine name, and source \214le corresponding to that position in the curr\
ent e)144 535.2 R -.15(xe)-.15 G 1.327(cution call stack.).15 F(This e)
144 547.2 Q(xtra information may be used, for e)-.15 E .001
(xample, to print a stack trace.)-.15 F .001(The current frame is frame)
5.001 F 3.02(0. The)144 559.2 R .52(return v)3.02 F .52
(alue is 0 unless the shell is not e)-.25 F -.15(xe)-.15 G .519
(cuting a subroutine call or).15 F F2 -.2(ex)3.019 G(pr).2 E F0 .519
(does not corre-)3.019 F(spond to a v)144 571.2 Q
(alid position in the call stack.)-.25 E F1(cd)108 588 Q F0([)2.5 E F1
(\255L|-P)A F0 2.5(][)C F2(dir)-2.5 E F0(])A .21
(Change the current directory to)144 600 R F2(dir)2.71 E F0 5.21(.T)C
.21(he v)-5.21 F(ariable)-.25 E/F4 9/Times-Bold@0 SF(HOME)2.71 E F0 .21
(is the def)2.46 F(ault)-.1 E F2(dir)2.71 E F0 5.21(.T).73 G .21(he v)
-5.21 F(ariable)-.25 E F4(CDP)2.71 E -.855(AT)-.666 G(H).855 E F0 .777
(de\214nes the search path for the directory containing)144 612 R F2
(dir)3.276 E F0 5.776(.A).73 G(lternati)-5.776 E 1.076 -.15(ve d)-.25 H
.776(irectory names in).15 F F4(CDP)3.276 E -.855(AT)-.666 G(H).855 E F0
.764(are separated by a colon \(:\).)144 624 R 3.264(An)5.764 G .764
(ull directory name in)-3.264 F F4(CDP)3.264 E -.855(AT)-.666 G(H).855 E
F0 .764(is the same as the current direc-)3.014 F(tory)144 636 Q 2.974
(,i)-.65 G .474(.e., `)-2.974 F(`)-.74 E F1(.)A F0 -.74('')C 5.474(.I)
.74 G(f)-5.474 E F2(dir)3.324 E F0(be)3.704 E .474
(gins with a slash \(/\), then)-.15 F F4(CDP)2.974 E -.855(AT)-.666 G(H)
.855 E F0 .473(is not used. The)2.724 F F1<ad50>2.973 E F0 .473
(option says to use)2.973 F .579(the ph)144 648 R .579
(ysical directory structure instead of follo)-.05 F .579
(wing symbolic links \(see also the)-.25 F F1<ad50>3.08 E F0 .58
(option to the)3.08 F F1(set)144 660 Q F0 -.2(bu)3.384 G .884
(iltin command\); the).2 F F1<ad4c>3.384 E F0 .884
(option forces symbolic links to be follo)3.384 F 3.384(wed. An)-.25 F
(ar)3.383 E .883(gument of)-.18 F F1<ad>3.383 E F0(is)3.383 E(equi)144
672 Q -.25(va)-.25 G .062(lent to).25 F F4($OLDPWD)2.562 E/F5 9
/Times-Roman@0 SF(.)A F0 .062(If a non-empty directory name from)4.562 F
F1(CDP)2.562 E -.95(AT)-.74 G(H).95 E F0 .063(is used, or if)2.562 F F1
<ad>2.563 E F0 .063(is the \214rst)2.563 F(ar)144 684 Q .116(gument, an\
d the directory change is successful, the absolute pathname of the ne)
-.18 F 2.615(ww)-.25 G .115(orking direc-)-2.715 F 1.164
(tory is written to the standard output.)144 696 R 1.164(The return v)
6.164 F 1.165(alue is true if the directory w)-.25 F 1.165
(as successfully)-.1 F(changed; f)144 708 Q(alse otherwise.)-.1 E
(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(2)203.725 E 0 Cg EP
%%Page: 3 3
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
/Times-Bold@0 SF(command)108 84 Q F0([)2.5 E F1(\255pVv)A F0(])A/F2 10
/Times-Italic@0 SF(command)2.5 E F0([)2.5 E F2(ar)A(g)-.37 E F0(...])2.5
E(Run)144 96 Q F2(command)2.957 E F0(with)3.527 E F2(ar)3.087 E(gs)-.37
E F0 .257(suppressing the normal shell function lookup. Only b)3.027 F
.257(uiltin commands or)-.2 F .501(commands found in the)144 108 R/F3 9
/Times-Bold@0 SF -.666(PA)3.001 G(TH)-.189 E F0 .502(are e)2.751 F -.15
(xe)-.15 G 3.002(cuted. If).15 F(the)3.002 E F1<ad70>3.002 E F0 .502
(option is gi)3.002 F -.15(ve)-.25 G .502(n, the search for).15 F F2
(command)3.202 E F0(is)3.772 E .232(performed using a def)144 120 R .231
(ault v)-.1 F .231(alue for)-.25 F F1 -.74(PA)2.731 G(TH)-.21 E F0 .231
(that is guaranteed to \214nd all of the standard utilities.)2.731 F(If)
5.231 E .174(either the)144 132 R F1<ad56>2.674 E F0(or)2.674 E F1<ad76>
2.674 E F0 .175(option is supplied, a description of)2.674 F F2(command)
2.875 E F0 .175(is printed.)3.445 F(The)5.175 E F1<ad76>2.675 E F0 .175
(option causes)2.675 F 3.11(as)144 144 S .61(ingle w)-3.11 F .61
(ord indicating the command or \214le name used to in)-.1 F -.2(vo)-.4 G
-.1(ke).2 G F2(command)3.41 E F0 .61(to be displayed; the)3.88 F F1
<ad56>144 156 Q F0 .249(option produces a more v)2.749 F .249
(erbose description.)-.15 F .249(If the)5.249 F F1<ad56>2.749 E F0(or)
2.749 E F1<ad76>2.75 E F0 .25(option is supplied, the e)2.75 F .25
(xit status)-.15 F 1.005(is 0 if)144 168 R F2(command)3.705 E F0 -.1(wa)
4.275 G 3.505(sf).1 G 1.005(ound, and 1 if not.)-3.505 F 1.004
(If neither option is supplied and an error occurred or)6.005 F F2
(command)144.2 180 Q F0 1.598(cannot be found, the e)4.868 F 1.599
(xit status is 127.)-.15 F 1.599(Otherwise, the e)6.599 F 1.599
(xit status of the)-.15 F F1(command)4.099 E F0 -.2(bu)144 192 S
(iltin is the e).2 E(xit status of)-.15 E F2(command)2.5 E F0(.).77 E F1
(compgen)108 208.8 Q F0([)2.5 E F2(option)A F0 2.5(][)C F2(wor)-2.5 E(d)
-.37 E F0(])A .013(Generate possible completion matches for)144 220.8 R
F2(wor)2.513 E(d)-.37 E F0 .013(according to the)2.513 F F2(option)2.513
E F0 .013(s, which may be an)B 2.512(yo)-.15 G(ption)-2.512 E .981
(accepted by the)144 232.8 R F1(complete)3.481 E F0 -.2(bu)3.481 G .981
(iltin with the e).2 F .981(xception of)-.15 F F1<ad70>3.481 E F0(and)
3.481 E F1<ad72>3.481 E F0 3.481(,a)C .982(nd write the matches to the)
-3.481 F 1.415(standard output.)144 244.8 R 1.415(When using the)6.415 F
F1<ad46>3.915 E F0(or)3.915 E F1<ad43>3.915 E F0 1.415(options, the v)
3.915 F 1.415(arious shell v)-.25 F 1.415(ariables set by the pro-)-.25
F(grammable completion f)144 256.8 Q(acilities, while a)-.1 E -.25(va)
-.2 G(ilable, will not ha).25 E .3 -.15(ve u)-.2 H(seful v).15 E(alues.)
-.25 E .352(The matches will be generated in the same w)144 280.8 R .352
(ay as if the programmable completion code had gen-)-.1 F .02(erated th\
em directly from a completion speci\214cation with the same \215ags.)144
292.8 R(If)5.02 E F2(wor)2.52 E(d)-.37 E F0 .02(is speci\214ed, only)
2.52 F(those completions matching)144 304.8 Q F2(wor)2.5 E(d)-.37 E F0
(will be displayed.)2.5 E(The return v)144 328.8 Q
(alue is true unless an in)-.25 E -.25(va)-.4 G
(lid option is supplied, or no matches were generated.).25 E F1
(complete)108 345.6 Q F0([)3.033 E F1(\255abcdefgjksuv)A F0 3.033(][)C
F1<ad6f>-3.033 E F2(comp-option)3.033 E F0 3.033(][)C F1<ad45>-3.033 E
F0 3.033(][)C F1<ad41>-3.033 E F2(action)3.033 E F0 3.033(][)C F1<ad47>
-3.033 E F2(globpat)3.033 E F0 3.034(][)C F1<ad57>-3.034 E F2(wor)3.034
E(dlist)-.37 E F0 3.034(][)C F1<ad46>-3.034 E F2(function)3.034 E F0(])A
([)108 357.6 Q F1<ad43>A F2(command)2.5 E F0(])A([)144 369.6 Q F1<ad58>A
F2(\214lterpat)2.5 E F0 2.5(][)C F1<ad50>-2.5 E F2(pr)2.5 E(e\214x)-.37
E F0 2.5(][)C F1<ad53>-2.5 E F2(suf)2.5 E<8c78>-.18 E F0(])A F2(name)2.5
E F0([)2.5 E F2(name ...)A F0(])A F1(complete \255pr)108 381.6 Q F0([)
2.5 E F1<ad45>A F0 2.5(][)C F2(name)-2.5 E F0(...])2.5 E .633
(Specify ho)144 393.6 R 3.133(wa)-.25 G -.18(rg)-3.133 G .633
(uments to each).18 F F2(name)3.133 E F0 .633(should be completed.)3.133
F .634(If the)5.634 F F1<ad70>3.134 E F0 .634
(option is supplied, or if no)3.134 F .14(options are supplied, e)144
405.6 R .139(xisting completion speci\214cations are printed in a w)-.15
F .139(ay that allo)-.1 F .139(ws them to be)-.25 F .31
(reused as input.)144 417.6 R(The)5.31 E F1<ad72>2.81 E F0 .31
(option remo)2.81 F -.15(ve)-.15 G 2.81(sac).15 G .31
(ompletion speci\214cation for each)-2.81 F F2(name)2.81 E F0 2.81(,o)C
1.11 -.4(r, i)-2.81 H 2.81(fn).4 G(o)-2.81 E F2(name)2.81 E F0(s)A 1.393
(are supplied, all completion speci\214cations.)144 429.6 R(The)6.393 E
F1<ad45>3.893 E F0 1.392(option indicates that the remaining options)
3.892 F 1.304(and actions should apply to `)144 441.6 R(`empty')-.74 E
3.804('c)-.74 G 1.304
(ommand completion; that is, completion attempted on a)-3.804 F
(blank line.)144 453.6 Q 1.438
(The process of applying these completion speci\214cations when w)144
477.6 R 1.437(ord completion is attempted is)-.1 F(described abo)144
489.6 Q .3 -.15(ve u)-.15 H(nder).15 E F1(Pr)2.5 E
(ogrammable Completion)-.18 E F0(.)A .555
(Other options, if speci\214ed, ha)144 513.6 R .855 -.15(ve t)-.2 H .555
(he follo).15 F .555(wing meanings.)-.25 F .555(The ar)5.555 F .555
(guments to the)-.18 F F1<ad47>3.056 E F0(,)A F1<ad57>3.056 E F0 3.056
(,a)C(nd)-3.056 E F1<ad58>3.056 E F0 .723(options \(and, if necessary)
144 525.6 R 3.223(,t)-.65 G(he)-3.223 E F1<ad50>3.223 E F0(and)3.223 E
F1<ad53>3.223 E F0 .722
(options\) should be quoted to protect them from e)3.223 F(xpan-)-.15 E
(sion before the)144 537.6 Q F1(complete)2.5 E F0 -.2(bu)2.5 G
(iltin is in).2 E -.2(vo)-.4 G -.1(ke).2 G(d.).1 E F1<ad6f>144 549.6 Q
F2(comp-option)2.5 E F0(The)184 561.6 Q F2(comp-option)2.79 E F0 .291
(controls se)2.791 F -.15(ve)-.25 G .291(ral aspects of the compspec')
.15 F 2.791(sb)-.55 G(eha)-2.791 E .291(vior be)-.2 F .291
(yond the simple)-.15 F(generation of completions.)184 573.6 Q F2
(comp-option)5 E F0(may be one of:)2.5 E F1(bashdefault)184 585.6 Q F0
.281(Perform the rest of the def)224 597.6 R(ault)-.1 E F1(bash)2.781 E
F0 .281(completions if the compspec generates no)2.781 F(matches.)224
609.6 Q F1(default)184 621.6 Q F0 2.875(Use readline')10 F 5.375(sd)-.55
G(ef)-5.375 E 2.876
(ault \214lename completion if the compspec generates no)-.1 F(matches.)
224 633.6 Q F1(dir)184 645.6 Q(names)-.15 E F0(Perform directory name c\
ompletion if the compspec generates no matches.)224 657.6 Q F1
(\214lenames)184 669.6 Q F0 -.7(Te)224 681.6 S .137(ll readline that th\
e compspec generates \214lenames, so it can perform an).7 F 2.636<798c>
-.15 G(le-)-2.636 E .134(name\255speci\214c processing \(lik)224 693.6 R
2.634(ea)-.1 G .134(dding a slash to directory names, quoting spe-)
-2.634 F .45(cial characters, or suppressing trailing spaces\).)224
705.6 R .45(Intended to be used with shell)5.45 F(functions.)224 717.6 Q
(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(3)203.725 E 0 Cg EP
%%Page: 4 4
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
/Times-Bold@0 SF(nospace)184 84 Q F0 -.7(Te)6.11 G .22
(ll readline not to append a space \(the def).7 F .22(ault\) to w)-.1 F
.22(ords completed at the end)-.1 F(of the line.)224 96 Q F1(plusdirs)
184 108 Q F0 1.985(After an)5.54 F 4.485(ym)-.15 G 1.985
(atches de\214ned by the compspec are generated, directory name)-4.485 F
.583(completion is attempted and an)224 120 R 3.084(ym)-.15 G .584
(atches are added to the results of the other)-3.084 F(actions.)224 132
Q F1<ad41>144 144 Q/F2 10/Times-Italic@0 SF(action)2.5 E F0(The)184 156
Q F2(action)2.5 E F0(may be one of the follo)2.5 E
(wing to generate a list of possible completions:)-.25 E F1(alias)184
168 Q F0(Alias names.)20.55 E(May also be speci\214ed as)5 E F1<ad61>2.5
E F0(.)A F1(arrayv)184 180 Q(ar)-.1 E F0(Array v)224 192 Q
(ariable names.)-.25 E F1 4.7(binding Readline)184 204 R F0 -.1(ke)2.5 G
2.5(yb)-.05 G(inding names.)-2.5 E F1 -.2(bu)184 216 S(iltin).2 E F0
(Names of shell b)11.85 E(uiltin commands.)-.2 E
(May also be speci\214ed as)5 E F1<ad62>2.5 E F0(.)A F1(command)184 228
Q F0(Command names.)224 240 Q(May also be speci\214ed as)5 E F1<ad63>2.5
E F0(.)A F1(dir)184 252 Q(ectory)-.18 E F0(Directory names.)224 264 Q
(May also be speci\214ed as)5 E F1<ad64>2.5 E F0(.)A F1(disabled)184 276
Q F0(Names of disabled shell b)224 288 Q(uiltins.)-.2 E F1(enabled)184
300 Q F0(Names of enabled shell b)6.66 E(uiltins.)-.2 E F1(export)184
312 Q F0(Names of e)12.23 E(xported shell v)-.15 E 2.5(ariables. May)
-.25 F(also be speci\214ed as)2.5 E F1<ad65>2.5 E F0(.)A F1(\214le)184
324 Q F0(File names.)27.22 E(May also be speci\214ed as)5 E F1<ad66>2.5
E F0(.)A F1(function)184 336 Q F0(Names of shell functions.)224 348 Q F1
(gr)184 360 Q(oup)-.18 E F0(Group names.)14.62 E
(May also be speci\214ed as)5 E F1<ad67>2.5 E F0(.)A F1(helptopic)184
372 Q F0(Help topics as accepted by the)224 384 Q F1(help)2.5 E F0 -.2
(bu)2.5 G(iltin.).2 E F1(hostname)184 396 Q F0(Hostnames, as tak)224 408
Q(en from the \214le speci\214ed by the)-.1 E/F3 9/Times-Bold@0 SF
(HOSTFILE)2.5 E F0(shell v)2.25 E(ariable.)-.25 E F1(job)184 420 Q F0
(Job names, if job control is acti)26.11 E -.15(ve)-.25 G 5(.M).15 G
(ay also be speci\214ed as)-5 E F1<ad6a>2.5 E F0(.)A F1 -.1(ke)184 432 S
(yw).1 E(ord)-.1 E F0(Shell reserv)224 444 Q(ed w)-.15 E 2.5(ords. May)
-.1 F(also be speci\214ed as)2.5 E F1<ad6b>2.5 E F0(.)A F1(running)184
456 Q F0(Names of running jobs, if job control is acti)5.54 E -.15(ve)
-.25 G(.).15 E F1(ser)184 468 Q(vice)-.1 E F0(Service names.)10.67 E
(May also be speci\214ed as)5 E F1<ad73>2.5 E F0(.)A F1(setopt)184 480 Q
F0 -1.11(Va)14.45 G(lid ar)1.11 E(guments for the)-.18 E F1<ad6f>2.5 E
F0(option to the)2.5 E F1(set)2.5 E F0 -.2(bu)2.5 G(iltin.).2 E F1
(shopt)184 492 Q F0(Shell option names as accepted by the)16.66 E F1
(shopt)2.5 E F0 -.2(bu)2.5 G(iltin.).2 E F1(signal)184 504 Q F0
(Signal names.)14.99 E F1(stopped)184 516 Q F0
(Names of stopped jobs, if job control is acti)6.66 E -.15(ve)-.25 G(.)
.15 E F1(user)184 528 Q F0(User names.)21.67 E
(May also be speci\214ed as)5 E F1<ad75>2.5 E F0(.)A F1 -.1(va)184 540 S
(riable).1 E F0(Names of all shell v)5.1 E 2.5(ariables. May)-.25 F
(also be speci\214ed as)2.5 E F1<ad76>2.5 E F0(.)A F1<ad47>144 552 Q F2
(globpat)2.5 E F0 1.411(The \214lename e)184 564 R 1.411
(xpansion pattern)-.15 F F2(globpat)3.911 E F0 1.411(is e)3.911 F 1.411
(xpanded to generate the possible comple-)-.15 F(tions.)184 576 Q F1
<ad57>144 588 Q F2(wor)2.5 E(dlist)-.37 E F0(The)184 600 Q F2(wor)3.639
E(dlist)-.37 E F0 1.14(is split using the characters in the)3.639 F F3
(IFS)3.64 E F0 1.14(special v)3.39 F 1.14(ariable as delimiters, and)
-.25 F 2.008(each resultant w)184 612 R 2.008(ord is e)-.1 F 4.508
(xpanded. The)-.15 F 2.007(possible completions are the members of the)
4.508 F(resultant list which match the w)184 624 Q(ord being completed.)
-.1 E F1<ad43>144 636 Q F2(command)2.5 E(command)184 648 Q F0 1.055
(is e)3.555 F -.15(xe)-.15 G 1.055(cuted in a subshell en).15 F 1.056
(vironment, and its output is used as the possible)-.4 F(completions.)
184 660 Q F1<ad46>144 672 Q F2(function)2.5 E F0 1.181
(The shell function)184 684 R F2(function)3.681 E F0 1.181(is e)3.681 F
-.15(xe)-.15 G 1.181(cuted in the current shell en).15 F 3.68
(vironment. When)-.4 F 1.18(it \214n-)3.68 F .932
(ishes, the possible completions are retrie)184 696 R -.15(ve)-.25 G
3.432(df).15 G .932(rom the v)-3.432 F .932(alue of the)-.25 F F3
(COMPREPL)3.432 E(Y)-.828 E F0(array)3.182 E -.25(va)184 708 S(riable.)
.25 E(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(4)203.725 E 0 Cg EP
%%Page: 5 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
/Times-Bold@0 SF<ad58>144 84 Q/F2 10/Times-Italic@0 SF(\214lterpat)2.5 E
(\214lterpat)184 96 Q F0 .733(is a pattern as used for \214lename e)
3.234 F 3.233(xpansion. It)-.15 F .733
(is applied to the list of possible)3.233 F 1.596
(completions generated by the preceding options and ar)184 108 R 1.596
(guments, and each completion)-.18 F(matching)184 120 Q F2(\214lterpat)
3.205 E F0 .705(is remo)3.205 F -.15(ve)-.15 G 3.205(df).15 G .704
(rom the list.)-3.205 F 3.204(Al)5.704 G(eading)-3.204 E F1(!)3.204 E F0
(in)3.204 E F2(\214lterpat)3.204 E F0(ne)3.204 E -.05(ga)-.15 G .704
(tes the pattern;).05 F(in this case, an)184 132 Q 2.5(yc)-.15 G
(ompletion not matching)-2.5 E F2(\214lterpat)2.5 E F0(is remo)2.5 E
-.15(ve)-.15 G(d.).15 E F1<ad50>144 144 Q F2(pr)2.5 E(e\214x)-.37 E(pr)
184 156 Q(e\214x)-.37 E F0 .534(is added at the be)3.034 F .534
(ginning of each possible completion after all other options ha)-.15 F
-.15(ve)-.2 G(been applied.)184 168 Q F1<ad53>144 180 Q F2(suf)2.5 E
2.81(\214x suf)-.18 F<8c78>-.18 E F0
(is appended to each possible completion after all other options ha)2.5
E .3 -.15(ve b)-.2 H(een applied.).15 E .467(The return v)144 196.8 R
.467(alue is true unless an in)-.25 F -.25(va)-.4 G .466
(lid option is supplied, an option other than).25 F F1<ad70>2.966 E F0
(or)2.966 E F1<ad72>2.966 E F0 .466(is sup-)2.966 F 1.361
(plied without a)144 208.8 R F2(name)3.861 E F0(ar)3.861 E 1.361
(gument, an attempt is made to remo)-.18 F 1.662 -.15(ve a c)-.15 H
1.362(ompletion speci\214cation for a).15 F F2(name)144 220.8 Q F0
(for which no speci\214cation e)2.5 E
(xists, or an error occurs adding a completion speci\214cation.)-.15 E
F1(compopt)108 237.6 Q F0([)2.5 E F1<ad6f>A F2(option)2.5 E F0 2.5(][)C
F1(+o)-2.5 E F2(option)2.5 E F0 2.5(][)C F2(name)-2.5 E F0(])A .447
(Modify completion options for each)144 249.6 R F2(name)2.947 E F0 .447
(according to the)2.947 F F2(option)2.947 E F0 .447
(s, or for the currently-e)B -.15(xe)-.15 G(cution).15 E .725
(completion if no)144 261.6 R F2(name)3.225 E F0 3.225(sa)C .725
(re supplied.)-3.225 F .725(If no)5.725 F F2(option)3.225 E F0 3.225(sa)
C .725(re gi)-3.225 F -.15(ve)-.25 G .726
(n, display the completion options for).15 F(each)144 273.6 Q F2(name)
3.224 E F0 .724(or the current completion.)3.224 F .724(The possible v)
5.724 F .724(alues of)-.25 F F2(option)3.224 E F0 .724(are those v)3.224
F .723(alid for the)-.25 F F1(com-)3.223 E(plete)144 285.6 Q F0 -.2(bu)
2.5 G(iltin described abo).2 E -.15(ve)-.15 G(.).15 E .327(The return v)
108 302.4 R .327(alue is true unless an in)-.25 F -.25(va)-.4 G .327
(lid option is supplied, an attempt is made to modify the options for a)
.25 F F2(name)108 314.4 Q F0(for which no completion speci\214cation e)
2.5 E(xists, or an output error occurs.)-.15 E F1(continue)108 331.2 Q
F0([)2.5 E F2(n)A F0(])A 1.754(Resume the ne)144 343.2 R 1.754
(xt iteration of the enclosing)-.15 F F1 -.25(fo)4.254 G(r).25 E F0(,)A
F1(while)4.254 E F0(,)A F1(until)4.254 E F0 4.254(,o)C(r)-4.254 E F1
(select)4.254 E F0 4.253(loop. If)4.254 F F2(n)4.613 E F0 1.753
(is speci\214ed,)4.493 F 1.208(resume at the)144 355.2 R F2(n)3.709 E F0
1.209(th enclosing loop.)B F2(n)6.569 E F0 1.209(must be)3.949 F/F3 10
/Symbol SF<b3>3.709 E F0 3.709(1. If)3.709 F F2(n)4.069 E F0 1.209
(is greater than the number of enclosing)3.949 F .514
(loops, the last enclosing loop \(the `)144 367.2 R(`top-le)-.74 E -.15
(ve)-.25 G(l').15 E 3.014('l)-.74 G .514(oop\) is resumed.)-3.014 F .513
(The return v)5.513 F .513(alue is 0 unless)-.25 F F2(n)3.013 E F0(is)
3.013 E(not greater than or equal to 1.)144 379.2 Q F1(declar)108 396 Q
(e)-.18 E F0([)2.5 E F1(\255aAfFilrtux)A F0 2.5(][)C F1<ad70>-2.5 E F0
2.5(][)C F2(name)-2.5 E F0([=)A F2(value)A F0 2.5(].)C(..])-2.5 E F1
(typeset)108 408 Q F0([)2.5 E F1(\255aAfFilrtux)A F0 2.5(][)C F1<ad70>
-2.5 E F0 2.5(][)C F2(name)-2.5 E F0([=)A F2(value)A F0 2.5(].)C(..])
-2.5 E 1.264(Declare v)144 420 R 1.264(ariables and/or gi)-.25 F 1.564
-.15(ve t)-.25 H 1.264(hem attrib).15 F 3.765(utes. If)-.2 F(no)3.765 E
F2(name)3.765 E F0 3.765(sa)C 1.265(re gi)-3.765 F -.15(ve)-.25 G 3.765
(nt).15 G 1.265(hen display the v)-3.765 F 1.265(alues of)-.25 F -.25
(va)144 432 S 3.483(riables. The).25 F F1<ad70>3.483 E F0 .983
(option will display the attrib)3.483 F .983(utes and v)-.2 F .982
(alues of each)-.25 F F2(name)3.482 E F0 5.982(.W).18 G(hen)-5.982 E F1
<ad70>3.482 E F0 .982(is used)3.482 F(with)144 444 Q F2(name)3.579 E F0
(ar)3.579 E 1.079(guments, additional options are ignored.)-.18 F(When)
6.079 E F1<ad70>3.579 E F0 1.079(is supplied without)3.579 F F2(name)
3.58 E F0(ar)3.58 E(gu-)-.18 E .151(ments, it will display the attrib)
144 456 R .151(utes and v)-.2 F .151(alues of all v)-.25 F .15
(ariables ha)-.25 F .15(ving the attrib)-.2 F .15
(utes speci\214ed by the)-.2 F .046(additional options.)144 468 R .046
(If no other options are supplied with)5.046 F F1<ad70>2.547 E F0(,)A F1
(declar)2.547 E(e)-.18 E F0 .047(will display the attrib)2.547 F .047
(utes and)-.2 F -.25(va)144 480 S 1.363(lues of all shell v).25 F 3.863
(ariables. The)-.25 F F1<ad66>3.863 E F0 1.362
(option will restrict the display to shell functions.)3.863 F(The)6.362
E F1<ad46>3.862 E F0 2.422(option inhibits the display of function de\
\214nitions; only the function name and attrib)144 492 R 2.423(utes are)
-.2 F 2.664(printed. If)144 504 R(the)2.664 E F1(extdeb)2.664 E(ug)-.2 E
F0 .164(shell option is enabled using)2.664 F F1(shopt)2.664 E F0 2.664
(,t)C .163(he source \214le name and line number)-2.664 F 1.382
(where the function is de\214ned are displayed as well.)144 516 R(The)
6.382 E F1<ad46>3.882 E F0 1.382(option implies)3.882 F F1<ad66>3.882 E
F0 6.382(.T)C 1.382(he follo)-6.382 F(wing)-.25 E .794
(options can be used to restrict output to v)144 528 R .794
(ariables with the speci\214ed attrib)-.25 F .793(ute or to gi)-.2 F
1.093 -.15(ve v)-.25 H(ariables)-.1 E(attrib)144 540 Q(utes:)-.2 E F1
<ad61>144 552 Q F0(Each)25.3 E F2(name)2.5 E F0(is an inde)2.5 E -.15
(xe)-.15 G 2.5(da).15 G(rray v)-2.5 E(ariable \(see)-.25 E F1(Arrays)2.5
E F0(abo)2.5 E -.15(ve)-.15 G(\).).15 E F1<ad41>144 564 Q F0(Each)23.08
E F2(name)2.5 E F0(is an associati)2.5 E .3 -.15(ve a)-.25 H(rray v).15
E(ariable \(see)-.25 E F1(Arrays)2.5 E F0(abo)2.5 E -.15(ve)-.15 G(\).)
.15 E F1<ad66>144 576 Q F0(Use function names only)26.97 E(.)-.65 E F1
<ad69>144 588 Q F0 .557(The v)27.52 F .558
(ariable is treated as an inte)-.25 F .558(ger; arithmetic e)-.15 F -.25
(va)-.25 G .558(luation \(see).25 F/F4 9/Times-Bold@0 SF .558
(ARITHMETIC EV)3.058 F(ALU)-1.215 E(A-)-.54 E(TION \))180 600 Q F0
(is performed when the v)2.25 E(ariable is assigned a v)-.25 E(alue.)
-.25 E F1<ad6c>144 612 Q F0 .91(When the v)27.52 F .909
(ariable is assigned a v)-.25 F .909(alue, all upper)-.25 F .909
(-case characters are con)-.2 F -.15(ve)-.4 G .909(rted to lo).15 F(wer)
-.25 E(-)-.2 E 2.5(case. The)180 624 R(upper)2.5 E(-case attrib)-.2 E
(ute is disabled.)-.2 E F1<ad72>144 636 Q F0(Mak)25.86 E(e)-.1 E F2
(name)5.046 E F0 5.046(sr)C(eadonly)-5.046 E 7.546(.T)-.65 G 2.546
(hese names cannot then be assigned v)-7.546 F 2.547
(alues by subsequent)-.25 F(assignment statements or unset.)180 648 Q F1
<ad74>144 660 Q F0(Gi)26.97 E .73 -.15(ve e)-.25 H(ach).15 E F2(name)
2.93 E F0(the)2.929 E F2(tr)2.929 E(ace)-.15 E F0(attrib)2.929 E 2.929
(ute. T)-.2 F .429(raced functions inherit the)-.35 F F1(DEB)2.929 E(UG)
-.1 E F0(and)2.929 E F1(RETURN)2.929 E F0(traps from the calling shell.)
180 672 Q(The trace attrib)5 E(ute has no special meaning for v)-.2 E
(ariables.)-.25 E F1<ad75>144 684 Q F0 .909(When the v)24.74 F .909
(ariable is assigned a v)-.25 F .909(alue, all lo)-.25 F(wer)-.25 E .909
(-case characters are con)-.2 F -.15(ve)-.4 G .91(rted to upper).15 F(-)
-.2 E 2.5(case. The)180 696 R(lo)2.5 E(wer)-.25 E(-case attrib)-.2 E
(ute is disabled.)-.2 E F1<ad78>144 708 Q F0(Mark)25.3 E F2(name)2.5 E
F0 2.5(sf)C(or e)-2.5 E(xport to subsequent commands via the en)-.15 E
(vironment.)-.4 E .121(Using `+' instead of `\255' turns of)144 724.8 R
2.621(ft)-.25 G .121(he attrib)-2.621 F .121(ute instead, with the e)-.2
F .12(xceptions that)-.15 F F1(+a)2.62 E F0 .12(may not be used)2.62 F
(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(5)203.725 E 0 Cg EP
%%Page: 6 6
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E 1.236
(to destro)144 84 R 3.736(ya)-.1 G 3.737(na)-3.736 G 1.237(rray v)-3.737
F 1.237(ariable and)-.25 F/F1 10/Times-Bold@0 SF 1.237(+r will not r)
3.737 F(emo)-.18 E 1.437 -.1(ve t)-.1 H 1.237(he r).1 F 1.237
(eadonly attrib)-.18 F 3.737(ute. When)-.2 F 1.237(used in a)3.737 F
.312(function, mak)144 96 R .312(es each)-.1 F/F2 10/Times-Italic@0 SF
(name)2.812 E F1 .311(local, as with the local)2.812 F F0 2.811
(command. If)2.811 F 2.811(av)2.811 G .311(ariable name is follo)-3.061
F .311(wed by)-.25 F(=)144 108 Q F2(value)A F0 3.238(,t)C .738(he v)
-3.238 F .738(alue of the v)-.25 F .738(ariable is set to)-.25 F F2
(value)3.238 E F0 5.738(.T)C .738(he return v)-5.738 F .739
(alue is 0 unless an in)-.25 F -.25(va)-.4 G .739(lid option is).25 F
.603(encountered, an attempt is made to de\214ne a function using)144
120 R/F3 10/Courier@0 SF .603(\255f foo=bar)3.103 F F0 3.103(,a)C 3.103
(na)-3.103 G .603(ttempt is made to)-3.103 F 1.242(assign a v)144 132 R
1.242(alue to a readonly v)-.25 F 1.242
(ariable, an attempt is made to assign a v)-.25 F 1.243
(alue to an array v)-.25 F(ariable)-.25 E 1.386
(without using the compound assignment syntax \(see)144 144 R F1(Arrays)
3.886 E F0(abo)3.886 E -.15(ve)-.15 G 1.386(\), one of the).15 F F2
(names)3.886 E F0 1.386(is not a)3.886 F -.25(va)144 156 S .171
(lid shell v).25 F .171(ariable name, an attempt is made to turn of)-.25
F 2.671(fr)-.25 G .171(eadonly status for a readonly v)-2.671 F .172
(ariable, an)-.25 F .96(attempt is made to turn of)144 168 R 3.46(fa)
-.25 G .96(rray status for an array v)-3.46 F .96
(ariable, or an attempt is made to display a)-.25 F(non-e)144 180 Q
(xistent function with)-.15 E F1<ad66>2.5 E F0(.)A F1(dirs [+)108 196.8
Q F2(n)A F1 2.5(][)C<ad>-2.5 E F2(n)A F1 2.5(][)C(\255cplv])-2.5 E F0
-.4(Wi)144 208.8 S .328
(thout options, displays the list of currently remembered directories.)
.4 F .329(The def)5.329 F .329(ault display is on a)-.1 F 1.238
(single line with directory names separated by spaces.)144 220.8 R 1.238
(Directories are added to the list with the)6.238 F F1(pushd)144 232.8 Q
F0(command; the)2.5 E F1(popd)2.5 E F0(command remo)2.5 E -.15(ve)-.15 G
2.5(se).15 G(ntries from the list.)-2.5 E F1(+)144 244.8 Q F2(n)A F0
1.564(Displays the)25.3 F F2(n)4.064 E F0 1.565
(th entry counting from the left of the list sho)B 1.565(wn by)-.25 F F1
(dirs)4.065 E F0 1.565(when in)4.065 F -.2(vo)-.4 G -.1(ke).2 G(d).1 E
(without options, starting with zero.)180 256.8 Q F1<ad>144 268.8 Q F2
(n)A F0 1.194(Displays the)25.3 F F2(n)3.694 E F0 1.194
(th entry counting from the right of the list sho)B 1.194(wn by)-.25 F
F1(dirs)3.694 E F0 1.194(when in)3.694 F -.2(vo)-.4 G -.1(ke).2 G(d).1 E
(without options, starting with zero.)180 280.8 Q F1<ad63>144 292.8 Q F0
(Clears the directory stack by deleting all of the entries.)25.86 E F1
<ad6c>144 304.8 Q F0 .324(Produces a longer listing; the def)27.52 F
.324(ault listing format uses a tilde to denote the home direc-)-.1 F
(tory)180 316.8 Q(.)-.65 E F1<ad70>144 328.8 Q F0
(Print the directory stack with one entry per line.)24.74 E F1<ad76>144
340.8 Q F0 .273(Print the directory stack with one entry per line, pre\
\214xing each entry with its inde)25.3 F 2.772(xi)-.15 G 2.772(nt)-2.772
G(he)-2.772 E(stack.)180 352.8 Q .257(The return v)144 369.6 R .258
(alue is 0 unless an in)-.25 F -.25(va)-.4 G .258
(lid option is supplied or).25 F F2(n)2.758 E F0(inde)2.758 E -.15(xe)
-.15 G 2.758(sb).15 G -.15(ey)-2.758 G .258(ond the end of the direc-)
.15 F(tory stack.)144 381.6 Q F1(diso)108 398.4 Q(wn)-.1 E F0([)2.5 E F1
(\255ar)A F0 2.5(][)C F1<ad68>-2.5 E F0 2.5(][)C F2(jobspec)-2.5 E F0
(...])2.5 E -.4(Wi)144 410.4 S .295(thout options, each).4 F F2(jobspec)
4.535 E F0 .295(is remo)3.105 F -.15(ve)-.15 G 2.795(df).15 G .295
(rom the table of acti)-2.795 F .595 -.15(ve j)-.25 H 2.795(obs. If).15
F F2(jobspec)4.535 E F0 .295(is not present,)3.105 F .243(and neither)
144 422.4 R F1 .243(\255a nor \255r is supplied, the shell')2.743 F
2.743(sn)-.37 G .243(otion of the)-2.743 F F2(curr)2.743 E .243(ent job)
-.37 F F1 .243(is used.)2.743 F .244(If the \255h option)5.243 F .334
(is gi)144 434.4 R -.1(ve)-.1 G .334(n, each).1 F F2(jobspec)4.574 E F0
.334(is not remo)3.144 F -.15(ve)-.15 G 2.834(df).15 G .334
(rom the table, b)-2.834 F .334(ut is mark)-.2 F .334(ed so that)-.1 F
/F4 9/Times-Bold@0 SF(SIGHUP)2.834 E F0 .333(is not sent to)2.584 F
1.189(the job if the shell recei)144 446.4 R -.15(ve)-.25 G 3.689(sa).15
G F4(SIGHUP)A/F5 9/Times-Roman@0 SF(.)A F0 1.189(If no)5.689 F F2
(jobspec)5.429 E F0 1.189(is present, and neither the)3.999 F F1<ad61>
3.689 E F0 1.19(nor the)3.69 F F1<ad72>3.69 E F0 1.57
(option is supplied, the)144 458.4 R F2(curr)4.07 E 1.57(ent job)-.37 F
F0 1.57(is used.)4.07 F 1.569(If no)6.569 F F2(jobspec)5.809 E F0 1.569
(is supplied, the)4.379 F F1<ad61>4.069 E F0 1.569(option means to)4.069
F(remo)144 470.4 Q .903 -.15(ve o)-.15 H 3.103(rm).15 G .603
(ark all jobs; the)-3.103 F F1<ad72>3.103 E F0 .603(option without a)
3.103 F F2(jobspec)4.843 E F0(ar)3.414 E .604
(gument restricts operation to running)-.18 F 2.5(jobs. The)144 482.4 R
(return v)2.5 E(alue is 0 unless a)-.25 E F2(jobspec)4.24 E F0
(does not specify a v)2.81 E(alid job)-.25 E(.)-.4 E F1(echo)108 499.2 Q
F0([)2.5 E F1(\255neE)A F0 2.5(][)C F2(ar)-2.5 E(g)-.37 E F0(...])2.5 E
.395(Output the)144 511.2 R F2(ar)2.895 E(g)-.37 E F0 .395
(s, separated by spaces, follo)B .395(wed by a ne)-.25 F 2.895
(wline. The)-.25 F .394(return status is al)2.895 F -.1(wa)-.1 G .394
(ys 0.).1 F(If)5.394 E F1<ad6e>2.894 E F0 .548
(is speci\214ed, the trailing ne)144 523.2 R .548(wline is suppressed.)
-.25 F .548(If the)5.548 F F1<ad65>3.048 E F0 .548(option is gi)3.048 F
-.15(ve)-.25 G .548(n, interpretation of the fol-).15 F(lo)144 535.2 Q
.053(wing backslash-escaped characters is enabled.)-.25 F(The)5.053 E F1
<ad45>2.553 E F0 .052(option disables the interpretation of these)2.552
F 1.502(escape characters, e)144 547.2 R -.15(ve)-.25 G 4.002(no).15 G
4.002(ns)-4.002 G 1.502(ystems where the)-4.002 F 4.002(ya)-.15 G 1.502
(re interpreted by def)-4.002 F 4.003(ault. The)-.1 F F1(xpg_echo)4.003
E F0(shell)4.003 E .009
(option may be used to dynamically determine whether or not)144 559.2 R
F1(echo)2.509 E F0 -.15(ex)2.509 G .009(pands these escape characters)
.15 F .659(by def)144 571.2 R(ault.)-.1 E F1(echo)5.659 E F0 .659
(does not interpret)3.159 F F1<adad>3.159 E F0 .659
(to mean the end of options.)3.159 F F1(echo)5.66 E F0 .66
(interprets the follo)3.16 F(wing)-.25 E(escape sequences:)144 583.2 Q
F1(\\a)144 595.2 Q F0(alert \(bell\))28.22 E F1(\\b)144 607.2 Q F0
(backspace)27.66 E F1(\\c)144 619.2 Q F0(suppress further output)28.78 E
F1(\\e)144 631.2 Q F0(an escape character)28.78 E F1(\\f)144 643.2 Q F0
(form feed)29.89 E F1(\\n)144 655.2 Q F0(ne)27.66 E 2.5(wl)-.25 G(ine)
-2.5 E F1(\\r)144 667.2 Q F0(carriage return)28.78 E F1(\\t)144 679.2 Q
F0(horizontal tab)29.89 E F1(\\v)144 691.2 Q F0 -.15(ve)28.22 G
(rtical tab).15 E F1(\\\\)144 703.2 Q F0(backslash)30.44 E F1(\\0)144
715.2 Q F2(nnn)A F0(the eight-bit character whose v)13.22 E
(alue is the octal v)-.25 E(alue)-.25 E F2(nnn)2.5 E F0
(\(zero to three octal digits\))2.5 E(GNU Bash-4.0)72 768 Q(2004 Apr 20)
148.735 E(6)203.725 E 0 Cg EP
%%Page: 7 7
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
/Times-Bold@0 SF(\\x)144 84 Q/F2 10/Times-Italic@0 SF(HH)A F0
(the eight-bit character whose v)13.78 E(alue is the he)-.25 E
(xadecimal v)-.15 E(alue)-.25 E F2(HH)2.5 E F0(\(one or tw)2.5 E 2.5(oh)
-.1 G .3 -.15(ex d)-2.5 H(igits\)).15 E F1(enable)108 100.8 Q F0([)2.5 E
F1<ad61>A F0 2.5(][)C F1(\255dnps)-2.5 E F0 2.5(][)C F1<ad66>-2.5 E F2
(\214lename)2.5 E F0 2.5(][)C F2(name)-2.5 E F0(...])2.5 E .278
(Enable and disable b)144 112.8 R .278(uiltin shell commands.)-.2 F .278
(Disabling a b)5.278 F .278(uiltin allo)-.2 F .278
(ws a disk command which has)-.25 F .833(the same name as a shell b)144
124.8 R .834(uiltin to be e)-.2 F -.15(xe)-.15 G .834
(cuted without specifying a full pathname, e).15 F -.15(ve)-.25 G 3.334
(nt).15 G(hough)-3.334 E .99(the shell normally searches for b)144 136.8
R .989(uiltins before disk commands.)-.2 F(If)5.989 E F1<ad6e>3.489 E F0
.989(is used, each)3.489 F F2(name)3.489 E F0 .989(is dis-)3.489 F 1.581
(abled; otherwise,)144 148.8 R F2(names)4.082 E F0 1.582(are enabled.)
4.082 F -.15(Fo)6.582 G 4.082(re).15 G 1.582(xample, to use the)-4.232 F
F1(test)4.082 E F0 1.582(binary found via the)4.082 F/F3 9/Times-Bold@0
SF -.666(PA)4.082 G(TH)-.189 E F0 .081(instead of the shell b)144 160.8
R .081(uiltin v)-.2 F .081(ersion, run)-.15 F/F4 10/Courier@0 SF .081
(enable -n test)2.581 F F0 5.081(.T)C(he)-5.081 E F1<ad66>2.58 E F0 .08
(option means to load the ne)2.58 F(w)-.25 E -.2(bu)144 172.8 S 1.524
(iltin command).2 F F2(name)4.384 E F0 1.524(from shared object)4.204 F
F2(\214lename)4.024 E F0 4.024(,o).18 G 4.024(ns)-4.024 G 1.524
(ystems that support dynamic loading.)-4.024 F(The)144 184.8 Q F1<ad64>
2.867 E F0 .367(option will delete a b)2.867 F .367(uiltin pre)-.2 F
.367(viously loaded with)-.25 F F1<ad66>2.866 E F0 5.366(.I)C 2.866(fn)
-5.366 G(o)-2.866 E F2(name)2.866 E F0(ar)2.866 E .366(guments are gi)
-.18 F -.15(ve)-.25 G .366(n, or).15 F .398(if the)144 196.8 R F1<ad70>
2.898 E F0 .399(option is supplied, a list of shell b)2.899 F .399
(uiltins is printed.)-.2 F -.4(Wi)5.399 G .399(th no other option ar).4
F .399(guments, the)-.18 F .099(list consists of all enabled shell b)144
208.8 R 2.598(uiltins. If)-.2 F F1<ad6e>2.598 E F0 .098
(is supplied, only disabled b)2.598 F .098(uiltins are printed.)-.2 F
(If)5.098 E F1<ad61>2.598 E F0 1.916
(is supplied, the list printed includes all b)144 220.8 R 1.916
(uiltins, with an indication of whether or not each is)-.2 F 2.879
(enabled. If)144 232.8 R F1<ad73>2.879 E F0 .379
(is supplied, the output is restricted to the POSIX)2.879 F F2(special)
2.879 E F0 -.2(bu)2.878 G 2.878(iltins. The).2 F .378(return v)2.878 F
(alue)-.25 E .994(is 0 unless a)144 244.8 R F2(name)3.854 E F0 .994
(is not a shell b)3.674 F .994(uiltin or there is an error loading a ne)
-.2 F 3.495(wb)-.25 G .995(uiltin from a shared)-3.695 F(object.)144
256.8 Q F1 -2.3 -.15(ev a)108 273.6 T(l).15 E F0([)2.5 E F2(ar)A(g)-.37
E F0(...])2.5 E(The)144 285.6 Q F2(ar)3.171 E(g)-.37 E F0 3.171(sa)C
.671(re read and concatenated together into a single command.)-3.171 F
.67(This command is then read)5.67 F .495(and e)144 297.6 R -.15(xe)-.15
G .495(cuted by the shell, and its e).15 F .495
(xit status is returned as the v)-.15 F .495(alue of)-.25 F F1 -2.3 -.15
(ev a)2.995 H(l).15 E F0 5.495(.I)C 2.995(ft)-5.495 G .495(here are no)
-2.995 F F2(ar)2.995 E(gs)-.37 E F0(,).27 E(or only null ar)144 309.6 Q
(guments,)-.18 E F1 -2.3 -.15(ev a)2.5 H(l).15 E F0(returns 0.)2.5 E F1
(exec)108 326.4 Q F0([)2.5 E F1(\255cl)A F0 2.5(][)C F1<ad61>-2.5 E F2
(name)2.5 E F0 2.5(][)C F2(command)-2.5 E F0([)2.5 E F2(ar)A(guments)
-.37 E F0(]])A(If)144 338.4 Q F2(command)3.006 E F0 .306
(is speci\214ed, it replaces the shell.)3.576 F .305(No ne)5.305 F 2.805
(wp)-.25 G .305(rocess is created.)-2.805 F(The)5.305 E F2(ar)3.135 E
(guments)-.37 E F0(become)3.075 E .176(the ar)144 350.4 R .176
(guments to)-.18 F F2(command)2.676 E F0 5.176(.I)C 2.676(ft)-5.176 G
(he)-2.676 E F1<ad6c>2.676 E F0 .176
(option is supplied, the shell places a dash at the be)2.676 F .177
(ginning of)-.15 F .5(the zeroth ar)144 362.4 R .5(gument passed to)-.18
F F2(command)3 E F0 5.499(.T).77 G .499(his is what)-5.499 F F2(lo)2.999
E(gin)-.1 E F0 .499(\(1\) does.).24 F(The)5.499 E F1<ad63>2.999 E F0
.499(option causes)2.999 F F2(com-)3.199 E(mand)144 374.4 Q F0 .638
(to be e)3.908 F -.15(xe)-.15 G .638(cuted with an empty en).15 F 3.138
(vironment. If)-.4 F F1<ad61>3.138 E F0 .638
(is supplied, the shell passes)3.138 F F2(name)3.499 E F0 .639(as the)
3.319 F 1.078(zeroth ar)144 386.4 R 1.077(gument to the e)-.18 F -.15
(xe)-.15 G 1.077(cuted command.).15 F(If)6.077 E F2(command)3.777 E F0
1.077(cannot be e)4.347 F -.15(xe)-.15 G 1.077(cuted for some reason, a)
.15 F(non-interacti)144 398.4 Q .617 -.15(ve s)-.25 H .317(hell e).15 F
.317(xits, unless the shell option)-.15 F F1(execfail)2.817 E F0 .318
(is enabled, in which case it returns f)2.817 F(ail-)-.1 E 2.505
(ure. An)144 410.4 R(interacti)2.505 E .305 -.15(ve s)-.25 H .005
(hell returns f).15 F .005(ailure if the \214le cannot be e)-.1 F -.15
(xe)-.15 G 2.505(cuted. If).15 F F2(command)2.705 E F0 .005
(is not speci\214ed,)3.275 F(an)144 422.4 Q 3.036(yr)-.15 G .536
(edirections tak)-3.036 F 3.036(ee)-.1 G -.25(ff)-3.036 G .536
(ect in the current shell, and the return status is 0.).25 F .536
(If there is a redirection)5.536 F(error)144 434.4 Q 2.5(,t)-.4 G
(he return status is 1.)-2.5 E F1(exit)108 451.2 Q F0([)2.5 E F2(n)A F0
6.29(]C)C .096(ause the shell to e)-6.29 F .096(xit with a status of)
-.15 F F2(n)2.596 E F0 5.096(.I)C(f)-5.096 E F2(n)2.955 E F0 .095
(is omitted, the e)2.835 F .095(xit status is that of the last command)
-.15 F -.15(exe)144 463.2 S 2.5(cuted. A).15 F(trap on)2.5 E F3(EXIT)2.5
E F0(is e)2.25 E -.15(xe)-.15 G(cuted before the shell terminates.).15 E
F1(export)108 480 Q F0([)2.5 E F1(\255fn)A F0 2.5(][).833 G F2(name)-2.5
E F0([=)A F2(wor)A(d)-.37 E F0(]] ...)A F1(export \255p)108 492 Q F0
.256(The supplied)144 504 R F2(names)3.117 E F0 .257(are mark)3.027 F
.257(ed for automatic e)-.1 F .257(xport to the en)-.15 F .257
(vironment of subsequently e)-.4 F -.15(xe)-.15 G(cuted).15 E 2.627
(commands. If)144 516 R(the)2.627 E F1<ad66>2.627 E F0 .127
(option is gi)2.627 F -.15(ve)-.25 G .127(n, the).15 F F2(names)2.987 E
F0 .127(refer to functions.)2.897 F .127(If no)5.127 F F2(names)2.987 E
F0 .127(are gi)2.897 F -.15(ve)-.25 G .126(n, or if the).15 F F1<ad70>
144 528 Q F0 .659(option is supplied, a list of all names that are e)
3.159 F .66(xported in this shell is printed.)-.15 F(The)5.66 E F1<ad6e>
3.16 E F0(option)3.16 E 1.587(causes the e)144 540 R 1.587
(xport property to be remo)-.15 F -.15(ve)-.15 G 4.086(df).15 G 1.586
(rom each)-4.086 F F2(name)4.086 E F0 6.586(.I)C 4.086(fav)-6.586 G
1.586(ariable name is follo)-4.336 F 1.586(wed by)-.25 F(=)144 552 Q F2
(wor)A(d)-.37 E F0 2.803(,t)C .303(he v)-2.803 F .303(alue of the v)-.25
F .304(ariable is set to)-.25 F F2(wor)2.804 E(d)-.37 E F0(.)A F1
(export)5.304 E F0 .304(returns an e)2.804 F .304
(xit status of 0 unless an in)-.15 F -.25(va)-.4 G(lid).25 E .294
(option is encountered, one of the)144 564 R F2(names)2.793 E F0 .293
(is not a v)2.793 F .293(alid shell v)-.25 F .293(ariable name, or)-.25
F F1<ad66>2.793 E F0 .293(is supplied with a)2.793 F F2(name)144.36 576
Q F0(that is not a function.)2.68 E F1(fc)108 592.8 Q F0([)2.5 E F1
<ad65>A F2(ename)2.5 E F0 2.5(][)C F1(\255lnr)-2.5 E F0 2.5(][)C F2
<8c72>-2.5 E(st)-.1 E F0 2.5(][)C F2(last)-2.5 E F0(])A F1(fc \255s)108
604.8 Q F0([)2.5 E F2(pat)A F0(=)A F2 -.37(re)C(p).37 E F0 2.5(][)C F2
(cmd)-2.5 E F0(])A .477(Fix Command.)144 616.8 R .478
(In the \214rst form, a range of commands from)5.477 F F2<8c72>4.888 E
(st)-.1 E F0(to)3.658 E F2(last)3.068 E F0 .478
(is selected from the his-)3.658 F .882(tory list.)144 628.8 R F2 -.45
(Fi)5.882 G -.1(rs).45 G(t).1 E F0(and)4.062 E F2(last)3.472 E F0 .882
(may be speci\214ed as a string \(to locate the last command be)4.062 F
.881(ginning with)-.15 F .797(that string\) or as a number \(an inde)144
640.8 R 3.297(xi)-.15 G .797(nto the history list, where a ne)-3.297 F
-.05(ga)-.15 G(ti).05 E 1.097 -.15(ve n)-.25 H .797(umber is used as an)
.15 F(of)144 652.8 Q .277(fset from the current command number\).)-.25 F
(If)5.277 E F2(last)2.867 E F0 .276
(is not speci\214ed it is set to the current command)3.457 F .092
(for listing \(so that)144 664.8 R F4 .092(fc \255l \25510)2.592 F F0
.092(prints the last 10 commands\) and to)2.592 F F2<8c72>4.502 E(st)-.1
E F0 2.592(otherwise. If)3.272 F F2<8c72>4.502 E(st)-.1 E F0 .093
(is not)3.273 F(speci\214ed it is set to the pre)144 676.8 Q
(vious command for editing and \25516 for listing.)-.25 E(The)144 700.8
Q F1<ad6e>2.522 E F0 .022
(option suppresses the command numbers when listing.)2.522 F(The)5.022 E
F1<ad72>2.522 E F0 .022(option re)2.522 F -.15(ve)-.25 G .022
(rses the order of).15 F .438(the commands.)144 712.8 R .438(If the)
5.438 F F1<ad6c>2.938 E F0 .438(option is gi)2.938 F -.15(ve)-.25 G .438
(n, the commands are listed on standard output.).15 F(Otherwise,)5.438 E
.335(the editor gi)144 724.8 R -.15(ve)-.25 G 2.835(nb).15 G(y)-2.835 E
F2(ename)3.025 E F0 .335(is in)3.015 F -.2(vo)-.4 G -.1(ke).2 G 2.835
(do).1 G 2.835(na\214)-2.835 G .335(le containing those commands.)-2.835
F(If)5.334 E F2(ename)3.024 E F0 .334(is not gi)3.014 F -.15(ve)-.25 G
(n,).15 E(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(7)203.725 E 0 Cg
EP
%%Page: 8 8
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E .63(the v)
144 84 R .63(alue of the)-.25 F/F1 9/Times-Bold@0 SF(FCEDIT)3.13 E F0
-.25(va)2.88 G .631(riable is used, and the v).25 F .631(alue of)-.25 F
F1(EDIT)3.131 E(OR)-.162 E F0(if)2.881 E F1(FCEDIT)3.131 E F0 .631
(is not set.)2.881 F .631(If nei-)5.631 F 1.884(ther v)144 96 R 1.884
(ariable is set, is used.)-.25 F 1.884
(When editing is complete, the edited commands are echoed and)6.884 F
-.15(exe)144 108 S(cuted.).15 E .039(In the second form,)144 132 R/F2 10
/Times-Italic@0 SF(command)2.539 E F0 .039(is re-e)2.539 F -.15(xe)-.15
G .039(cuted after each instance of).15 F F2(pat)2.54 E F0 .04
(is replaced by)2.54 F F2 -.37(re)2.54 G(p).37 E F0 5.04(.A)C(useful)
-2.5 E .406(alias to use with this is)144 144 R/F3 10/Courier@0 SF .406
(r='fc \255s')2.906 F F0 2.906(,s)C 2.906(ot)-2.906 G .406(hat typing)
-2.906 F F3 6.406(rc)2.906 G(c)-6.406 E F0 .406
(runs the last command be)2.906 F .406(ginning with)-.15 F F3(cc)144 156
Q F0(and typing)2.5 E F3(r)2.5 E F0(re-e)2.5 E -.15(xe)-.15 G
(cutes the last command.).15 E .142
(If the \214rst form is used, the return v)144 180 R .142
(alue is 0 unless an in)-.25 F -.25(va)-.4 G .142
(lid option is encountered or).25 F F2<8c72>4.552 E(st)-.1 E F0(or)3.322
E F2(last)2.732 E F0 .455(specify history lines out of range.)144 192 R
.454(If the)5.454 F/F4 10/Times-Bold@0 SF<ad65>2.954 E F0 .454
(option is supplied, the return v)2.954 F .454(alue is the v)-.25 F .454
(alue of the)-.25 F .787(last command e)144 204 R -.15(xe)-.15 G .787
(cuted or f).15 F .788
(ailure if an error occurs with the temporary \214le of commands.)-.1 F
.788(If the)5.788 F 1.136
(second form is used, the return status is that of the command re-e)144
216 R -.15(xe)-.15 G 1.135(cuted, unless).15 F F2(cmd)3.835 E F0 1.135
(does not)4.405 F(specify a v)144 228 Q
(alid history line, in which case)-.25 E F4(fc)2.5 E F0(returns f)2.5 E
(ailure.)-.1 E F4(fg)108 244.8 Q F0([)2.5 E F2(jobspec)A F0(])A(Resume)
144 256.8 Q F2(jobspec)5.653 E F0 1.413(in the fore)4.223 F 1.413
(ground, and mak)-.15 F 3.913(ei)-.1 G 3.913(tt)-3.913 G 1.413
(he current job)-3.913 F 6.413(.I)-.4 G(f)-6.413 E F2(jobspec)5.653 E F0
1.414(is not present, the)4.223 F(shell')144 268.8 Q 3.117(sn)-.55 G
.617(otion of the)-3.117 F F2(curr)3.117 E .617(ent job)-.37 F F0 .617
(is used.)3.117 F .617(The return v)5.617 F .616
(alue is that of the command placed into the)-.25 F(fore)144 280.8 Q
.362(ground, or f)-.15 F .362
(ailure if run when job control is disabled or)-.1 F 2.862(,w)-.4 G .363
(hen run with job control enabled, if)-2.862 F F2(jobspec)145.74 292.8 Q
F0 .004(does not specify a v)2.815 F .004(alid job or)-.25 F F2(jobspec)
4.244 E F0 .004(speci\214es a job that w)2.814 F .004
(as started without job control.)-.1 F F4(getopts)108 309.6 Q F2
(optstring name)2.5 E F0([)2.5 E F2(ar)A(gs)-.37 E F0(])A F4(getopts)144
321.6 Q F0 .793
(is used by shell procedures to parse positional parameters.)3.293 F F2
(optstring)6.023 E F0 .793(contains the option)3.513 F .15
(characters to be recognized; if a character is follo)144 333.6 R .149
(wed by a colon, the option is e)-.25 F .149(xpected to ha)-.15 F .449
-.15(ve a)-.2 H(n).15 E(ar)144 345.6 Q .578
(gument, which should be separated from it by white space.)-.18 F .579
(The colon and question mark char)5.579 F(-)-.2 E 1.665
(acters may not be used as option characters.)144 357.6 R 1.665
(Each time it is in)6.665 F -.2(vo)-.4 G -.1(ke).2 G(d,).1 E F4(getopts)
4.165 E F0 1.665(places the ne)4.165 F(xt)-.15 E .796
(option in the shell v)144 369.6 R(ariable)-.25 E F2(name)3.296 E F0
3.296(,i).18 G(nitializing)-3.296 E F2(name)3.657 E F0 .797
(if it does not e)3.477 F .797(xist, and the inde)-.15 F 3.297(xo)-.15 G
3.297(ft)-3.297 G .797(he ne)-3.297 F(xt)-.15 E(ar)144 381.6 Q .085
(gument to be processed into the v)-.18 F(ariable)-.25 E F1(OPTIND)2.585
E/F5 9/Times-Roman@0 SF(.)A F1(OPTIND)4.585 E F0 .085
(is initialized to 1 each time the shell)2.335 F .845
(or a shell script is in)144 393.6 R -.2(vo)-.4 G -.1(ke).2 G 3.345
(d. When).1 F .845(an option requires an ar)3.345 F(gument,)-.18 E F4
(getopts)3.346 E F0 .846(places that ar)3.346 F(gument)-.18 E .804
(into the v)144 405.6 R(ariable)-.25 E F1(OPT)3.304 E(ARG)-.81 E F5(.)A
F0 .803(The shell does not reset)5.304 F F1(OPTIND)3.303 E F0 .803
(automatically; it must be manually)3.053 F .293
(reset between multiple calls to)144 417.6 R F4(getopts)2.793 E F0 .293
(within the same shell in)2.793 F -.2(vo)-.4 G .293(cation if a ne).2 F
2.793(ws)-.25 G .294(et of parameters)-2.793 F(is to be used.)144 429.6
Q 2.044(When the end of options is encountered,)144 453.6 R F4(getopts)
4.543 E F0 -.15(ex)4.543 G 2.043(its with a return v).15 F 2.043
(alue greater than zero.)-.25 F F4(OPTIND)144 465.6 Q F0
(is set to the inde)2.5 E 2.5(xo)-.15 G 2.5(ft)-2.5 G
(he \214rst non-option ar)-2.5 E(gument, and)-.18 E F4(name)2.5 E F0
(is set to ?.)2.5 E F4(getopts)144 489.6 Q F0 2.392
(normally parses the positional parameters, b)4.892 F 2.392
(ut if more ar)-.2 F 2.393(guments are gi)-.18 F -.15(ve)-.25 G 4.893
(ni).15 G(n)-4.893 E F2(ar)4.893 E(gs)-.37 E F0(,).27 E F4(getopts)144
501.6 Q F0(parses those instead.)2.5 E F4(getopts)144 525.6 Q F0 1.166
(can report errors in tw)3.666 F 3.665(ow)-.1 G 3.665(ays. If)-3.765 F
1.165(the \214rst character of)3.665 F F2(optstring)3.895 E F0 1.165
(is a colon,)3.885 F F2(silent)4.005 E F0(error)4.345 E 1.263
(reporting is used.)144 537.6 R 1.263
(In normal operation diagnostic messages are printed when in)6.263 F
-.25(va)-.4 G 1.263(lid options or).25 F .394(missing option ar)144
549.6 R .394(guments are encountered.)-.18 F .394(If the v)5.394 F
(ariable)-.25 E F1(OPTERR)2.894 E F0 .394
(is set to 0, no error messages)2.644 F(will be displayed, e)144 561.6 Q
-.15(ve)-.25 G 2.5(ni).15 G 2.5(ft)-2.5 G(he \214rst character of)-2.5 E
F2(optstring)2.73 E F0(is not a colon.)2.72 E .666(If an in)144 585.6 R
-.25(va)-.4 G .666(lid option is seen,).25 F F4(getopts)3.166 E F0 .667
(places ? into)3.167 F F2(name)3.527 E F0 .667
(and, if not silent, prints an error message)3.347 F .4(and unsets)144
597.6 R F1(OPT)2.9 E(ARG)-.81 E F5(.)A F0(If)4.899 E F4(getopts)2.899 E
F0 .399(is silent, the option character found is placed in)2.899 F F1
(OPT)2.899 E(ARG)-.81 E F0 .399(and no)2.649 F
(diagnostic message is printed.)144 609.6 Q 1.241(If a required ar)144
633.6 R 1.241(gument is not found, and)-.18 F F4(getopts)3.741 E F0
1.241(is not silent, a question mark \()3.741 F F4(?).833 E F0 3.742
(\)i).833 G 3.742(sp)-3.742 G 1.242(laced in)-3.742 F F2(name)144 645.6
Q F0(,).18 E F1(OPT)2.735 E(ARG)-.81 E F0 .234
(is unset, and a diagnostic message is printed.)2.485 F(If)5.234 E F4
(getopts)2.734 E F0 .234(is silent, then a colon \()2.734 F F4(:).833 E
F0(\)).833 E(is placed in)144 657.6 Q F2(name)2.86 E F0(and)2.68 E F1
(OPT)2.5 E(ARG)-.81 E F0(is set to the option character found.)2.25 E F4
(getopts)144 681.6 Q F0 .902
(returns true if an option, speci\214ed or unspeci\214ed, is found.)
3.401 F .902(It returns f)5.902 F .902(alse if the end of)-.1 F
(options is encountered or an error occurs.)144 693.6 Q(GNU Bash-4.0)72
768 Q(2004 Apr 20)148.735 E(8)203.725 E 0 Cg EP
%%Page: 9 9
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
/Times-Bold@0 SF(hash)108 84 Q F0([)2.5 E F1(\255lr)A F0 2.5(][)C F1
<ad70>-2.5 E/F2 10/Times-Italic@0 SF(\214lename)2.5 E F0 2.5(][)C F1
(\255dt)-2.5 E F0 2.5(][)C F2(name)-2.5 E F0(])A -.15(Fo)144 96 S 3.555
(re).15 G(ach)-3.555 E F2(name)3.555 E F0 3.555(,t).18 G 1.054(he full \
\214le name of the command is determined by searching the directories i\
n)-3.555 F F1($P)144 108 Q -.95(AT)-.74 G(H).95 E F0 .349
(and remembered.)2.849 F .349(If the)5.349 F F1<ad70>2.849 E F0 .349
(option is supplied, no path search is performed, and)2.849 F F2
(\214lename)4.76 E F0 .452
(is used as the full \214le name of the command.)144 120 R(The)5.452 E
F1<ad72>2.952 E F0 .452(option causes the shell to for)2.952 F .452
(get all remem-)-.18 F .592(bered locations.)144 132 R(The)5.592 E F1
<ad64>3.092 E F0 .593(option causes the shell to for)3.092 F .593
(get the remembered location of each)-.18 F F2(name)3.093 E F0(.)A .021
(If the)144 144 R F1<ad74>2.521 E F0 .021
(option is supplied, the full pathname to which each)2.521 F F2(name)
2.52 E F0 .02(corresponds is printed.)2.52 F .02(If multi-)5.02 F(ple)
144 156 Q F2(name)3.703 E F0(ar)3.703 E 1.203(guments are supplied with)
-.18 F F1<ad74>3.703 E F0 3.703(,t)C(he)-3.703 E F2(name)3.703 E F0
1.204(is printed before the hashed full pathname.)3.703 F(The)144 168 Q
F1<ad6c>3.216 E F0 .715(option causes output to be displayed in a forma\
t that may be reused as input.)3.216 F .715(If no ar)5.715 F(gu-)-.18 E
1.183(ments are gi)144 180 R -.15(ve)-.25 G 1.183(n, or if only).15 F F1
<ad6c>3.683 E F0 1.184
(is supplied, information about remembered commands is printed.)3.684 F
(The return status is true unless a)144 192 Q F2(name)2.86 E F0
(is not found or an in)2.68 E -.25(va)-.4 G(lid option is supplied.).25
E F1(help)108 208.8 Q F0([)2.5 E F1(\255dms)A F0 2.5(][)C F2(pattern)
-2.5 E F0(])A .867(Display helpful information about b)144 220.8 R .867
(uiltin commands.)-.2 F(If)5.867 E F2(pattern)4.617 E F0 .866
(is speci\214ed,)3.607 F F1(help)3.366 E F0(gi)3.366 E -.15(ve)-.25 G
3.366(sd).15 G(etailed)-3.366 E .306(help on all commands matching)144
232.8 R F2(pattern)2.806 E F0 2.807(;o).24 G .307
(therwise help for all the b)-2.807 F .307
(uiltins and shell control struc-)-.2 F(tures is printed.)144 244.8 Q F1
<ad64>144 256.8 Q F0(Display a short description of each)24.74 E F2
(pattern)2.5 E F1(-m)146.5 268.8 Q F0(Display the description of each)
21.84 E F2(pattern)2.5 E F0(in a manpage-lik)2.5 E 2.5(ef)-.1 G(ormat)
-2.5 E F1<ad73>144 280.8 Q F0
(Display only a short usage synopsis for each)26.41 E F2(pattern)2.5 E
F0(The return status is 0 unless no command matches)108 292.8 Q F2
(pattern)2.5 E F0(.).24 E F1(history [)108 309.6 Q F2(n)A F1(])A
(history \255c)108 321.6 Q(history \255d)108 333.6 Q F2(of)2.5 E(fset)
-.18 E F1(history \255anrw)108 345.6 Q F0([)2.5 E F2(\214lename)A F0(])A
F1(history \255p)108 357.6 Q F2(ar)2.5 E(g)-.37 E F0([)2.5 E F2(ar)A 2.5
(g.)-.37 G(..)-2.5 E F0(])A F1(history \255s)108 369.6 Q F2(ar)2.5 E(g)
-.37 E F0([)2.5 E F2(ar)A 2.5(g.)-.37 G(..)-2.5 E F0(])A -.4(Wi)144
381.6 S .752
(th no options, display the command history list with line numbers.).4 F
.752(Lines listed with a)5.752 F F1(*)3.251 E F0(ha)3.251 E -.15(ve)-.2
G 1.23(been modi\214ed.)144 393.6 R 1.23(An ar)6.23 F 1.23(gument of)
-.18 F F2(n)4.09 E F0 1.231(lists only the last)3.97 F F2(n)4.091 E F0
3.731(lines. If)3.971 F 1.231(the shell v)3.731 F(ariable)-.25 E F1
(HISTTIME-)3.731 E(FORMA)144 405.6 Q(T)-.95 E F0 .25
(is set and not null, it is used as a format string for)2.75 F F2
(strftime)2.749 E F0 .249(\(3\) to display the time stamp)B .378
(associated with each displayed history entry)144 417.6 R 5.378(.N)-.65
G 2.878(oi)-5.378 G(nterv)-2.878 E .379
(ening blank is printed between the format-)-.15 F .815
(ted time stamp and the history line.)144 429.6 R(If)5.814 E F2
(\214lename)3.314 E F0 .814
(is supplied, it is used as the name of the history)3.314 F
(\214le; if not, the v)144 441.6 Q(alue of)-.25 E/F3 9/Times-Bold@0 SF
(HISTFILE)2.5 E F0(is used.)2.25 E(Options, if supplied, ha)5 E .3 -.15
(ve t)-.2 H(he follo).15 E(wing meanings:)-.25 E F1<ad63>144 453.6 Q F0
(Clear the history list by deleting all the entries.)25.86 E F1<ad64>144
465.6 Q F2(of)2.5 E(fset)-.18 E F0(Delete the history entry at position)
180 477.6 Q F2(of)2.5 E(fset)-.18 E F0(.)A F1<ad61>144 489.6 Q F0 .598
(Append the `)25.3 F(`ne)-.74 E(w')-.25 E 3.098('h)-.74 G .598
(istory lines \(history lines entered since the be)-3.098 F .599
(ginning of the current)-.15 F F1(bash)180 501.6 Q F0
(session\) to the history \214le.)2.5 E F1<ad6e>144 513.6 Q F0 .854(Rea\
d the history lines not already read from the history \214le into the c\
urrent history list.)24.74 F .772
(These are lines appended to the history \214le since the be)180 525.6 R
.773(ginning of the current)-.15 F F1(bash)3.273 E F0(ses-)3.273 E
(sion.)180 537.6 Q F1<ad72>144 549.6 Q F0(Read the contents of the hist\
ory \214le and use them as the current history)25.86 E(.)-.65 E F1<ad77>
144 561.6 Q F0(Write the current history to the history \214le, o)23.08
E -.15(ve)-.15 G(rwriting the history \214le').15 E 2.5(sc)-.55 G
(ontents.)-2.5 E F1<ad70>144 573.6 Q F0 .626
(Perform history substitution on the follo)24.74 F(wing)-.25 E F2(ar)
3.125 E(gs)-.37 E F0 .625(and display the result on the standard)3.125 F
2.975(output. Does)180 585.6 R .475
(not store the results in the history list.)2.975 F(Each)5.475 E F2(ar)
2.975 E(g)-.37 E F0 .475(must be quoted to disable)2.975 F
(normal history e)180 597.6 Q(xpansion.)-.15 E F1<ad73>144 609.6 Q F0
.363(Store the)26.41 F F2(ar)3.193 E(gs)-.37 E F0 .363
(in the history list as a single entry)3.133 F 5.363(.T)-.65 G .362
(he last command in the history list is)-5.363 F(remo)180 621.6 Q -.15
(ve)-.15 G 2.5(db).15 G(efore the)-2.5 E F2(ar)2.83 E(gs)-.37 E F0
(are added.)2.77 E .28(If the)144 638.4 R F1(HISTTIMEFORMA)2.78 E(T)-.95
E F0 .28
(is set, the time stamp information associated with each history entry)
2.78 F .54(is written to the history \214le, mark)144 650.4 R .539
(ed with the history comment character)-.1 F 5.539(.W)-.55 G .539
(hen the history \214le is)-5.539 F 1.778(read, lines be)144 662.4 R
1.778(ginning with the history comment character follo)-.15 F 1.779
(wed immediately by a digit are)-.25 F 1.424
(interpreted as timestamps for the pre)144 674.4 R 1.424
(vious history line.)-.25 F 1.424(The return v)6.424 F 1.424
(alue is 0 unless an in)-.25 F -.25(va)-.4 G(lid).25 E .499(option is e\
ncountered, an error occurs while reading or writing the history \214le\
, an in)144 686.4 R -.25(va)-.4 G(lid).25 E F2(of)3 E(fset)-.18 E F0(is)
3 E(supplied as an ar)144 698.4 Q(gument to)-.18 E F1<ad64>2.5 E F0 2.5
(,o)C 2.5(rt)-2.5 G(he history e)-2.5 E(xpansion supplied as an ar)-.15
E(gument to)-.18 E F1<ad70>2.5 E F0 -.1(fa)2.5 G(ils.).1 E(GNU Bash-4.0)
72 768 Q(2004 Apr 20)148.735 E(9)203.725 E 0 Cg EP
%%Page: 10 10
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
/Times-Bold@0 SF(jobs)108 84 Q F0([)2.5 E F1(\255lnprs)A F0 2.5(][)C/F2
10/Times-Italic@0 SF(jobspec)A F0(... ])2.5 E F1(jobs \255x)108 96 Q F2
(command)2.5 E F0([)2.5 E F2(ar)2.5 E(gs)-.37 E F0(... ])2.5 E
(The \214rst form lists the acti)144 108 Q .3 -.15(ve j)-.25 H 2.5
(obs. The).15 F(options ha)2.5 E .3 -.15(ve t)-.2 H(he follo).15 E
(wing meanings:)-.25 E F1<ad6c>144 120 Q F0
(List process IDs in addition to the normal information.)27.52 E F1
<ad70>144 132 Q F0(List only the process ID of the job')24.74 E 2.5(sp)
-.55 G(rocess group leader)-2.5 E(.)-.55 E F1<ad6e>144 144 Q F0 .194
(Display information only about jobs that ha)24.74 F .494 -.15(ve c)-.2
H .193(hanged status since the user w).15 F .193(as last noti-)-.1 F
(\214ed of their status.)180 156 Q F1<ad72>144 168 Q F0
(Restrict output to running jobs.)25.86 E F1<ad73>144 180 Q F0
(Restrict output to stopped jobs.)26.41 E(If)144 196.8 Q F2(jobspec)
4.553 E F0 .313(is gi)3.123 F -.15(ve)-.25 G .313
(n, output is restricted to information about that job).15 F 5.314(.T)
-.4 G .314(he return status is 0 unless)-5.314 F(an in)144 208.8 Q -.25
(va)-.4 G(lid option is encountered or an in).25 E -.25(va)-.4 G(lid).25
E F2(jobspec)4.24 E F0(is supplied.)2.81 E .395(If the)144 225.6 R F1
<ad78>2.895 E F0 .394(option is supplied,)2.894 F F1(jobs)2.894 E F0
.394(replaces an)2.894 F(y)-.15 E F2(jobspec)4.634 E F0 .394(found in)
3.204 F F2(command)3.094 E F0(or)3.664 E F2(ar)3.224 E(gs)-.37 E F0 .394
(with the corre-)3.164 F(sponding process group ID, and e)144 237.6 Q
-.15(xe)-.15 G(cutes).15 E F2(command)2.7 E F0(passing it)3.27 E F2(ar)
2.5 E(gs)-.37 E F0 2.5(,r).27 G(eturning its e)-2.5 E(xit status.)-.15 E
F1(kill)108 254.4 Q F0([)2.5 E F1<ad73>A F2(sigspec)2.5 E F0(|)2.5 E F1
<ad6e>2.5 E F2(signum)2.5 E F0(|)2.5 E F1<ad>2.5 E F2(sigspec)A F0 2.5
(][)C F2(pid)-2.5 E F0(|)2.5 E F2(jobspec)2.5 E F0 2.5(].)C(..)-2.5 E F1
(kill \255l)108 266.4 Q F0([)2.5 E F2(sigspec)A F0(|)2.5 E F2 -.2(ex)2.5
G(it_status).2 E F0(])A .119(Send the signal named by)144 278.4 R F2
(sigspec)2.959 E F0(or)2.929 E F2(signum)2.959 E F0 .119
(to the processes named by)2.939 F F2(pid)3.87 E F0(or)3.39 E F2
(jobspec)2.62 E F0(.).31 E F2(sigspec)5.46 E F0(is)2.93 E .319
(either a case-insensiti)144 290.4 R .619 -.15(ve s)-.25 H .319
(ignal name such as).15 F/F3 9/Times-Bold@0 SF(SIGKILL)2.819 E F0 .318
(\(with or without the)2.569 F F3(SIG)2.818 E F0 .318
(pre\214x\) or a signal)2.568 F(number;)144 302.4 Q F2(signum)4.188 E F0
1.349(is a signal number)4.168 F 6.349(.I)-.55 G(f)-6.349 E F2(sigspec)
4.189 E F0 1.349(is not present, then)4.159 F F3(SIGTERM)3.849 E F0
1.349(is assumed.)3.599 F(An)6.349 E(ar)144 314.4 Q .523(gument of)-.18
F F1<ad6c>3.023 E F0 .523(lists the signal names.)3.023 F .523(If an)
5.523 F 3.023(ya)-.15 G -.18(rg)-3.023 G .523(uments are supplied when)
.18 F F1<ad6c>3.023 E F0 .523(is gi)3.023 F -.15(ve)-.25 G .523
(n, the names).15 F .28(of the signals corresponding to the ar)144 326.4
R .28(guments are listed, and the return status is 0.)-.18 F(The)5.28 E
F2 -.2(ex)2.78 G(it_status).2 E F0(ar)144 338.4 Q .378(gument to)-.18 F
F1<ad6c>2.878 E F0 .378
(is a number specifying either a signal number or the e)2.878 F .377
(xit status of a process termi-)-.15 F .593(nated by a signal.)144 350.4
R F1(kill)5.593 E F0 .593(returns true if at least one signal w)3.093 F
.593(as successfully sent, or f)-.1 F .594(alse if an error)-.1 F
(occurs or an in)144 362.4 Q -.25(va)-.4 G(lid option is encountered.)
.25 E F1(let)108 379.2 Q F2(ar)2.5 E(g)-.37 E F0([)2.5 E F2(ar)A(g)-.37
E F0(...])2.5 E(Each)144 391.2 Q F2(ar)3.965 E(g)-.37 E F0 1.135
(is an arithmetic e)3.855 F 1.134(xpression to be e)-.15 F -.25(va)-.25
G 1.134(luated \(see).25 F F3 1.134(ARITHMETIC EV)3.634 F(ALU)-1.215 E
-.855(AT)-.54 G(ION).855 E/F4 9/Times-Roman@0 SF(\).)A F0 1.134(If the)
5.634 F(last)144 403.2 Q F2(ar)2.83 E(g)-.37 E F0 -.25(eva)2.72 G
(luates to 0,).25 E F1(let)2.5 E F0(returns 1; 0 is returned otherwise.)
2.5 E F1(local)108 420 Q F0([)2.5 E F2(option)A F0 2.5(][)C F2(name)-2.5
E F0([=)A F2(value)A F0 2.5(].)C(..])-2.5 E -.15(Fo)144 432 S 2.56(re)
.15 G .06(ach ar)-2.56 F .06(gument, a local v)-.18 F .06(ariable named)
-.25 F F2(name)2.92 E F0 .06(is created, and assigned)2.74 F F2(value)
2.56 E F0 5.06(.T).18 G(he)-5.06 E F2(option)2.56 E F0 .06(can be)2.56 F
(an)144 444 Q 3.153(yo)-.15 G 3.153(ft)-3.153 G .653
(he options accepted by)-3.153 F F1(declar)3.153 E(e)-.18 E F0 5.652(.W)
C(hen)-5.652 E F1(local)3.152 E F0 .652
(is used within a function, it causes the v)3.152 F(ari-)-.25 E(able)144
456 Q F2(name)3.72 E F0 .86(to ha)3.54 F 1.16 -.15(ve a v)-.2 H .861
(isible scope restricted to that function and its children.).15 F -.4
(Wi)5.861 G .861(th no operands,).4 F F1(local)144 468 Q F0 1.165
(writes a list of local v)3.665 F 1.165
(ariables to the standard output.)-.25 F 1.165(It is an error to use)
6.165 F F1(local)3.664 E F0 1.164(when not)3.664 F .232
(within a function.)144 480 R .233(The return status is 0 unless)5.232 F
F1(local)2.733 E F0 .233(is used outside a function, an in)2.733 F -.25
(va)-.4 G(lid).25 E F2(name)3.093 E F0(is)2.913 E(supplied, or)144 492 Q
F2(name)2.5 E F0(is a readonly v)2.5 E(ariable.)-.25 E F1(logout)108
508.8 Q F0(Exit a login shell.)9.33 E F1(map\214le)108 525.6 Q F0([)2.5
E F1<ad6e>A F2(count)2.5 E F0 2.5(][)C F1<ad4f>-2.5 E F2(origin)2.5 E F0
2.5(][)C F1<ad73>-2.5 E F2(count)2.5 E F0 2.5(][)C F1<ad74>-2.5 E F0 2.5
(][)C F1<ad75>-2.5 E F2(fd)2.5 E F0 2.5(][)C F1<ad43>-2.5 E F2(callbac)
2.5 E(k)-.2 E F0 2.5(][)C F1<ad63>-2.5 E F2(quantum)2.5 E F0 2.5(][)C F2
(arr)-2.5 E(ay)-.15 E F0(])A 1.006
(Read lines from the standard input into array v)144 537.6 R(ariable)
-.25 E F2(arr)3.506 E(ay)-.15 E F0 3.506(,o).32 G 3.506(rf)-3.506 G
1.006(rom \214le descriptor)-3.506 F F2(fd)3.506 E F0 1.005(if the)3.506
F F1<ad75>3.505 E F0 1.086(option is supplied.)144 549.6 R 1.086(The v)
6.086 F(ariable)-.25 E F1(MAPFILE)3.586 E F0 1.086(is the def)3.586 F
(ault)-.1 E F2(arr)3.587 E(ay)-.15 E F0 6.087(.O)C 1.087
(ptions, if supplied, ha)-6.087 F 1.387 -.15(ve t)-.2 H(he).15 E(follo)
144 561.6 Q(wing meanings:)-.25 E F1<ad6e>144 573.6 Q F0(Cop)24.74 E 2.5
(ya)-.1 G 2.5(tm)-2.5 G(ost)-2.5 E F2(count)2.7 E F0 2.5(lines. If)3.18
F F2(count)2.5 E F0(is 0, all lines are copied.)2.5 E F1<ad4f>144 585.6
Q F0(Be)22.52 E(gin assigning to)-.15 E F2(arr)2.83 E(ay)-.15 E F0
(at inde)2.82 E(x)-.15 E F2(origin)2.5 E F0 5(.T).24 G(he def)-5 E
(ault inde)-.1 E 2.5(xi)-.15 G 2.5(s0)-2.5 G(.)-2.5 E F1<ad73>144 597.6
Q F0(Discard the \214rst)26.41 E F2(count)2.5 E F0(lines read.)2.5 E F1
<ad74>144 609.6 Q F0(Remo)26.97 E .3 -.15(ve a t)-.15 H
(railing line from each line read.).15 E F1<ad75>144 621.6 Q F0
(Read lines from \214le descriptor)24.74 E F2(fd)2.5 E F0
(instead of the standard input.)2.5 E F1<ad43>144 633.6 Q F0(Ev)23.08 E
(aluate)-.25 E F2(callbac)2.7 E(k)-.2 E F0(each time)3.17 E F2(quantum)
2.5 E F0(lines are read.)2.5 E(The)5 E F1<ad63>2.5 E F0
(option speci\214es)2.5 E F2(quantum)2.5 E F0(.).32 E F1<ad63>144 645.6
Q F0(Specify the number of lines read between each call to)25.86 E F2
(callbac)2.5 E(k)-.2 E F0(.).67 E(If)144 662.4 Q F1<ad43>2.5 E F0
(is speci\214ed without)2.5 E F1<ad63>2.5 E F0 2.5(,t)C(he def)-2.5 E
(ault quantum is 5000.)-.1 E(If not supplied with an e)144 679.2 Q
(xplicit origin,)-.15 E F1(map\214le)2.5 E F0(will clear)2.5 E F2(arr)
2.5 E(ay)-.15 E F0(before assigning to it.)2.5 E F1(map\214le)144 696 Q
F0 .996(returns successfully unless an in)3.496 F -.25(va)-.4 G .996
(lid option or option ar).25 F .995(gument is supplied, or)-.18 F F2
(arr)3.495 E(ay)-.15 E F0(is)3.495 E(in)144 708 Q -.25(va)-.4 G
(lid or unassignable.).25 E(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E
(10)198.725 E 0 Cg EP
%%Page: 11 11
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
/Times-Bold@0 SF(popd)108 84 Q F0<5bad>2.5 E F1(n)A F0 2.5(][)C(+)-2.5 E
/F2 10/Times-Italic@0 SF(n)A F0 2.5(][)C<ad>-2.5 E F2(n)A F0(])A(Remo)
144 96 Q -.15(ve)-.15 G 2.799(se).15 G .299
(ntries from the directory stack.)-2.799 F -.4(Wi)5.299 G .299(th no ar)
.4 F .299(guments, remo)-.18 F -.15(ve)-.15 G 2.799(st).15 G .3
(he top directory from the)-2.799 F 1.479(stack, and performs a)144 108
R F1(cd)3.979 E F0 1.479(to the ne)3.979 F 3.979(wt)-.25 G 1.479
(op directory)-3.979 F 6.479(.A)-.65 G -.18(rg)-6.479 G 1.478
(uments, if supplied, ha).18 F 1.778 -.15(ve t)-.2 H 1.478(he follo).15
F(wing)-.25 E(meanings:)144 120 Q F1<ad6e>144 132 Q F0 .551
(Suppresses the normal change of directory when remo)24.74 F .551
(ving directories from the stack, so)-.15 F
(that only the stack is manipulated.)180 144 Q F1(+)144 156 Q F2(n)A F0
(Remo)25.3 E -.15(ve)-.15 G 2.64(st).15 G(he)-2.64 E F2(n)2.64 E F0 .14
(th entry counting from the left of the list sho)B .14(wn by)-.25 F F1
(dirs)2.64 E F0 2.64(,s)C .14(tarting with zero.)-2.64 F -.15(Fo)180 168
S 2.5(re).15 G(xample:)-2.65 E/F3 10/Courier@0 SF(popd +0)2.5 E F0(remo)
2.5 E -.15(ve)-.15 G 2.5(st).15 G(he \214rst directory)-2.5 E(,)-.65 E
F3(popd +1)2.5 E F0(the second.)2.5 E F1<ad>144 180 Q F2(n)A F0(Remo)
25.3 E -.15(ve)-.15 G 3.759(st).15 G(he)-3.759 E F2(n)3.759 E F0 1.259
(th entry counting from the right of the list sho)B 1.26(wn by)-.25 F F1
(dirs)3.76 E F0 3.76(,s)C 1.26(tarting with)-3.76 F 2.5(zero. F)180 192
R(or e)-.15 E(xample:)-.15 E F3(popd -0)2.5 E F0(remo)2.5 E -.15(ve)-.15
G 2.5(st).15 G(he last directory)-2.5 E(,)-.65 E F3(popd -1)2.5 E F0
(the ne)2.5 E(xt to last.)-.15 E .644(If the)144 208.8 R F1(popd)3.144 E
F0 .644(command is successful, a)3.144 F F1(dirs)3.143 E F0 .643
(is performed as well, and the return status is 0.)3.143 F F1(popd)5.643
E F0 .415(returns f)144 220.8 R .415(alse if an in)-.1 F -.25(va)-.4 G
.415(lid option is encountered, the directory stack is empty).25 F 2.916
(,an)-.65 G(on-e)-2.916 E .416(xistent direc-)-.15 F
(tory stack entry is speci\214ed, or the directory change f)144 232.8 Q
(ails.)-.1 E F1(printf)108 249.6 Q F0([)2.5 E F1<ad76>A F2(var)2.5 E F0
(])A F2(format)2.5 E F0([)2.5 E F2(ar)A(guments)-.37 E F0(])A .372
(Write the formatted)144 261.6 R F2(ar)2.872 E(guments)-.37 E F0 .372
(to the standard output under the control of the)2.872 F F2(format)2.872
E F0 5.372(.T)C(he)-5.372 E F2(format)2.872 E F0 1.804(is a character s\
tring which contains three types of objects: plain characters, which ar\
e simply)144 273.6 R .159
(copied to standard output, character escape sequences, which are con)
144 285.6 R -.15(ve)-.4 G .158(rted and copied to the stan-).15 F .499(\
dard output, and format speci\214cations, each of which causes printing\
 of the ne)144 297.6 R .5(xt successi)-.15 F -.15(ve)-.25 G F2(ar)3.15 E
(gu-)-.37 E(ment)144 309.6 Q F0 5.424(.I)C 2.924(na)-5.424 G .424
(ddition to the standard)-2.924 F F2(printf)2.924 E F0 .424
(\(1\) formats,)B F1(%b)2.924 E F0(causes)2.923 E F1(printf)2.923 E F0
.423(to e)2.923 F .423(xpand backslash escape)-.15 F .976
(sequences in the corresponding)144 321.6 R F2(ar)3.476 E(gument)-.37 E
F0(\(e)3.476 E .976(xcept that)-.15 F F1(\\c)3.476 E F0 .976
(terminates output, backslashes in)3.476 F F1<5c08>3.477 E F0(,)A F1
(\\")3.477 E F0(,)A(and)144 333.6 Q F1(\\?)3.422 E F0 .922(are not remo)
3.422 F -.15(ve)-.15 G .922(d, and octal escapes be).15 F .922
(ginning with)-.15 F F1(\\0)3.422 E F0 .921
(may contain up to four digits\), and)3.422 F F1(%q)144 345.6 Q F0
(causes)3.63 E F1(printf)3.63 E F0 1.13(to output the corresponding)3.63
F F2(ar)3.631 E(gument)-.37 E F0 1.131
(in a format that can be reused as shell)3.631 F(input.)144 357.6 Q(The)
144 381.6 Q F1<ad76>2.904 E F0 .404
(option causes the output to be assigned to the v)2.904 F(ariable)-.25 E
F2(var)2.904 E F0 .404(rather than being printed to the)2.904 F
(standard output.)144 393.6 Q(The)144 417.6 Q F2(format)3.423 E F0 .923
(is reused as necessary to consume all of the)3.423 F F2(ar)3.423 E
(guments)-.37 E F0 5.923(.I)C 3.423(ft)-5.923 G(he)-3.423 E F2(format)
3.423 E F0 .924(requires more)3.424 F F2(ar)144 429.6 Q(guments)-.37 E
F0 .033(than are supplied, the e)2.534 F .033
(xtra format speci\214cations beha)-.15 F .333 -.15(ve a)-.2 H 2.533(si)
.15 G 2.533(faz)-2.533 G .033(ero v)-2.533 F .033(alue or null string,)
-.25 F(as appropriate, had been supplied.)144 441.6 Q(The return v)5 E
(alue is zero on success, non-zero on f)-.25 E(ailure.)-.1 E F1(pushd)
108 458.4 Q F0([)2.5 E F1<ad6e>A F0 2.5(][)C(+)-2.5 E F2(n)A F0 2.5(][)C
<ad>-2.5 E F2(n)A F0(])A F1(pushd)108 470.4 Q F0([)2.5 E F1<ad6e>A F0
2.5(][)C F2(dir)-2.5 E F0(])A .639(Adds a directory to the top of the d\
irectory stack, or rotates the stack, making the ne)144 482.4 R 3.14(wt)
-.25 G .64(op of the)-3.14 F 1.316(stack the current w)144 494.4 R 1.316
(orking directory)-.1 F 6.316(.W)-.65 G 1.315(ith no ar)-6.716 F 1.315
(guments, e)-.18 F 1.315(xchanges the top tw)-.15 F 3.815(od)-.1 G 1.315
(irectories and)-3.815 F .871
(returns 0, unless the directory stack is empty)144 506.4 R 5.871(.A)
-.65 G -.18(rg)-5.871 G .872(uments, if supplied, ha).18 F 1.172 -.15
(ve t)-.2 H .872(he follo).15 F .872(wing mean-)-.25 F(ings:)144 518.4 Q
F1<ad6e>144 530.4 Q F0 .902(Suppresses the normal change of directory w\
hen adding directories to the stack, so that)24.74 F
(only the stack is manipulated.)180 542.4 Q F1(+)144 554.4 Q F2(n)A F0
1.267(Rotates the stack so that the)25.3 F F2(n)3.767 E F0 1.268
(th directory \(counting from the left of the list sho)B 1.268(wn by)
-.25 F F1(dirs)180 566.4 Q F0 2.5(,s)C
(tarting with zero\) is at the top.)-2.5 E F1<ad>144 578.4 Q F2(n)A F0
.92(Rotates the stack so that the)25.3 F F2(n)3.42 E F0 .92
(th directory \(counting from the right of the list sho)B .92(wn by)-.25
F F1(dirs)180 590.4 Q F0 2.5(,s)C(tarting with zero\) is at the top.)
-2.5 E F2(dir)144.35 602.4 Q F0(Adds)23.98 E F2(dir)2.85 E F0
(to the directory stack at the top, making it the ne)3.23 E 2.5(wc)-.25
G(urrent w)-2.5 E(orking directory)-.1 E(.)-.65 E .488(If the)144 619.2
R F1(pushd)2.988 E F0 .488(command is successful, a)2.988 F F1(dirs)
2.988 E F0 .488(is performed as well.)2.988 F .489
(If the \214rst form is used,)5.488 F F1(pushd)2.989 E F0 1.04
(returns 0 unless the cd to)144 631.2 R F2(dir)3.89 E F0 -.1(fa)4.27 G
3.539(ils. W).1 F 1.039(ith the second form,)-.4 F F1(pushd)3.539 E F0
1.039(returns 0 unless the directory)3.539 F .846(stack is empty)144
643.2 R 3.346(,an)-.65 G(on-e)-3.346 E .847(xistent directory stack ele\
ment is speci\214ed, or the directory change to the)-.15 F
(speci\214ed ne)144 655.2 Q 2.5(wc)-.25 G(urrent directory f)-2.5 E
(ails.)-.1 E F1(pwd)108 672 Q F0([)2.5 E F1(\255LP)A F0(])A .845
(Print the absolute pathname of the current w)144 684 R .845
(orking directory)-.1 F 5.844(.T)-.65 G .844
(he pathname printed contains no)-5.844 F .181(symbolic links if the)144
696 R F1<ad50>2.681 E F0 .181(option is supplied or the)2.681 F F1 .181
(\255o ph)2.681 F(ysical)-.15 E F0 .181(option to the)2.681 F F1(set)
2.681 E F0 -.2(bu)2.681 G .182(iltin command is).2 F 3.264(enabled. If)
144 708 R(the)3.264 E F1<ad4c>3.264 E F0 .763
(option is used, the pathname printed may contain symbolic links.)3.264
F .763(The return)5.763 F 1.36(status is 0 unless an error occurs while\
 reading the name of the current directory or an in)144 720 R -.25(va)
-.4 G(lid).25 E(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(11)198.725 E
0 Cg EP
%%Page: 12 12
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E
(option is supplied.)144 84 Q/F1 10/Times-Bold@0 SF -.18(re)108 100.8 S
(ad).18 E F0([)2.5 E F1(\255ers)A F0 2.5(][)C F1<ad61>-2.5 E/F2 10
/Times-Italic@0 SF(aname)2.5 E F0 2.5(][)C F1<ad64>-2.5 E F2(delim)2.5 E
F0 2.5(][)C F1<ad>-2.5 E F2(te)2.5 E(xt)-.2 E F0 2.5(][)C F1<ad6e>-2.5 E
F2(nc)2.5 E(har)-.15 E(s)-.1 E F0 2.5(][)C F1<ad70>-2.5 E F2(pr)2.5 E
(ompt)-.45 E F0 2.5(][)C F1<ad74>-2.5 E F2(timeout)2.5 E F0 2.5(][)C F1
<ad75>-2.5 E F2(fd)2.5 E F0 2.5(][)C F2(name)-2.5 E F0(...])2.5 E .516(\
One line is read from the standard input, or from the \214le descriptor)
144 112.8 R F2(fd)3.016 E F0 .516(supplied as an ar)3.016 F .516
(gument to)-.18 F(the)144 124.8 Q F1<ad75>2.538 E F0 .038
(option, and the \214rst w)2.538 F .038(ord is assigned to the \214rst)
-.1 F F2(name)2.539 E F0 2.539(,t).18 G .039(he second w)-2.539 F .039
(ord to the second)-.1 F F2(name)2.539 E F0(,).18 E .42
(and so on, with lefto)144 136.8 R -.15(ve)-.15 G 2.92(rw).15 G .42
(ords and their interv)-3.02 F .42
(ening separators assigned to the last)-.15 F F2(name)2.92 E F0 5.42(.I)
.18 G 2.92(ft)-5.42 G(here)-2.92 E .54(are fe)144 148.8 R .54(wer w)-.25
F .541(ords read from the input stream than names, the remaining names \
are assigned empty)-.1 F -.25(va)144 160.8 S 2.511(lues. The).25 F .011
(characters in)2.511 F/F3 9/Times-Bold@0 SF(IFS)2.511 E F0 .011
(are used to split the line into w)2.261 F 2.511(ords. The)-.1 F .011
(backslash character \()2.511 F F1(\\)A F0 2.51(\)m)C(ay)-2.51 E 1.89
(be used to remo)144 172.8 R 2.19 -.15(ve a)-.15 H 2.19 -.15(ny s).15 H
1.891(pecial meaning for the ne).15 F 1.891
(xt character read and for line continuation.)-.15 F
(Options, if supplied, ha)144 184.8 Q .3 -.15(ve t)-.2 H(he follo).15 E
(wing meanings:)-.25 E F1<ad61>144 196.8 Q F2(aname)2.5 E F0 1.05(The w)
180 208.8 R 1.049
(ords are assigned to sequential indices of the array v)-.1 F(ariable)
-.25 E F2(aname)3.549 E F0 3.549(,s).18 G 1.049(tarting at 0.)-3.549 F
F2(aname)180.33 220.8 Q F0(is unset before an)2.68 E 2.5(yn)-.15 G .5
-.25(ew va)-2.5 H(lues are assigned.).25 E(Other)5 E F2(name)2.5 E F0
(ar)2.5 E(guments are ignored.)-.18 E F1<ad64>144 232.8 Q F2(delim)2.5 E
F0(The \214rst character of)180 244.8 Q F2(delim)2.5 E F0
(is used to terminate the input line, rather than ne)2.5 E(wline.)-.25 E
F1<ad65>144 256.8 Q F0 .372
(If the standard input is coming from a terminal,)25.86 F F1 -.18(re)
2.873 G(adline).18 E F0(\(see)2.873 E F3(READLINE)2.873 E F0(abo)2.623 E
-.15(ve)-.15 G 2.873(\)i).15 G 2.873(su)-2.873 G(sed)-2.873 E .218
(to obtain the line.)180 268.8 R .218
(Readline uses the current \(or def)5.218 F .218
(ault, if line editing w)-.1 F .218(as not pre)-.1 F(viously)-.25 E
(acti)180 280.8 Q -.15(ve)-.25 G 2.5(\)e).15 G(diting settings.)-2.5 E
F1<ad69>144 292.8 Q F2(te)2.5 E(xt)-.2 E F0(If)10.78 E F1 -.18(re)2.715
G(adline).18 E F0 .216(is being used to read the line,)2.715 F F2(te)
2.716 E(xt)-.2 E F0 .216(is placed into the editing b)2.716 F(uf)-.2 E
.216(fer before edit-)-.25 F(ing be)180 304.8 Q(gins.)-.15 E F1<ad6e>144
316.8 Q F2(nc)2.5 E(har)-.15 E(s)-.1 E F1 -.18(re)180 328.8 S(ad).18 E
F0 1.395(returns after reading)3.895 F F2(nc)3.895 E(har)-.15 E(s)-.1 E
F0 1.395(characters rather than w)3.895 F 1.394
(aiting for a complete line of)-.1 F(input.)180 340.8 Q F1<ad70>144
352.8 Q F2(pr)2.5 E(ompt)-.45 E F0(Display)180 364.8 Q F2(pr)3.66 E
(ompt)-.45 E F0 1.161(on standard error)3.66 F 3.661(,w)-.4 G 1.161
(ithout a trailing ne)-3.661 F 1.161(wline, before attempting to read)
-.25 F(an)180 376.8 Q 2.5(yi)-.15 G 2.5(nput. The)-2.5 F
(prompt is displayed only if input is coming from a terminal.)2.5 E F1
<ad72>144 388.8 Q F0 .544(Backslash does not act as an escape character)
25.86 F 5.543(.T)-.55 G .543(he backslash is considered to be part of)
-5.543 F(the line.)180 400.8 Q(In particular)5 E 2.5(,ab)-.4 G
(ackslash-ne)-2.5 E(wline pair may not be used as a line continuation.)
-.25 E F1<ad73>144 412.8 Q F0(Silent mode.)26.41 E
(If input is coming from a terminal, characters are not echoed.)5 E F1
<ad74>144 424.8 Q F2(timeout)2.5 E F0(Cause)180 436.8 Q F1 -.18(re)3.548
G(ad).18 E F0 1.048(to time out and return f)3.548 F 1.048
(ailure if a complete line of input is not read within)-.1 F F2(timeout)
180 448.8 Q F0(seconds.)3.497 E F2(timeout)5.997 E F0 .997
(may be a decimal number with a fractional portion follo)3.497 F(wing)
-.25 E .576(the decimal point.)180 460.8 R .576(This option is only ef)
5.576 F(fecti)-.25 E .876 -.15(ve i)-.25 H(f).15 E F1 -.18(re)3.076 G
(ad).18 E F0 .576(is reading input from a terminal,)3.076 F .142
(pipe, or other special \214le; it has no ef)180 472.8 R .142
(fect when reading from re)-.25 F .142(gular \214les.)-.15 F(If)5.141 E
F2(timeout)2.641 E F0 .141(is 0,)2.641 F F1 -.18(re)180 484.8 S(ad).18 E
F0 .113(returns success if input is a)2.613 F -.25(va)-.2 G .113
(ilable on the speci\214ed \214le descriptor).25 F 2.613(,f)-.4 G .114
(ailure otherwise.)-2.713 F(The e)180 496.8 Q
(xit status is greater than 128 if the timeout is e)-.15 E(xceeded.)-.15
E F1<ad75>144 508.8 Q F2(fd)2.5 E F0(Read input from \214le descriptor)
14.46 E F2(fd)2.5 E F0(.)A .192(If no)144 525.6 R F2(names)3.052 E F0
.192(are supplied, the line read is assigned to the v)2.962 F(ariable)
-.25 E F3(REPL)2.691 E(Y)-.828 E/F4 9/Times-Roman@0 SF(.)A F0 .191
(The return code is zero,)4.691 F 1.343
(unless end-of-\214le is encountered,)144 537.6 R F1 -.18(re)3.843 G(ad)
.18 E F0 1.343
(times out \(in which case the return code is greater than)3.843 F
(128\), or an in)144 549.6 Q -.25(va)-.4 G
(lid \214le descriptor is supplied as the ar).25 E(gument to)-.18 E F1
<ad75>2.5 E F0(.)A F1 -.18(re)108 566.4 S(adonly).18 E F0([)2.5 E F1
(\255aA)A(pf)-.25 E F0 2.5(][)C F2(name)-2.5 E F0([=)A F2(wor)A(d)-.37 E
F0 2.5(].)C(..])-2.5 E .77(The gi)144 578.4 R -.15(ve)-.25 G(n).15 E F2
(names)3.27 E F0 .77(are mark)3.27 F .77(ed readonly; the v)-.1 F .77
(alues of these)-.25 F F2(names)3.63 E F0 .77
(may not be changed by subse-)3.54 F 1.096(quent assignment.)144 590.4 R
1.096(If the)6.096 F F1<ad66>3.596 E F0 1.097
(option is supplied, the functions corresponding to the)3.596 F F2
(names)3.597 E F0 1.097(are so)3.597 F(mark)144 602.4 Q 3.334(ed. The)
-.1 F F1<ad61>3.334 E F0 .834(option restricts the v)3.334 F .834
(ariables to inde)-.25 F -.15(xe)-.15 G 3.334(da).15 G .834(rrays; the)
-3.334 F F1<ad41>3.334 E F0 .834(option restricts the v)3.334 F(ari-)
-.25 E .537(ables to associati)144 614.4 R .837 -.15(ve a)-.25 H 3.037
(rrays. If).15 F(no)3.038 E F2(name)3.398 E F0(ar)3.218 E .538
(guments are gi)-.18 F -.15(ve)-.25 G .538(n, or if the).15 F F1<ad70>
3.038 E F0 .538(option is supplied, a list)3.038 F .081
(of all readonly names is printed.)144 626.4 R(The)5.081 E F1<ad70>2.581
E F0 .08(option causes output to be displayed in a format that may)2.581
F 1.176(be reused as input.)144 638.4 R 1.176(If a v)6.176 F 1.176
(ariable name is follo)-.25 F 1.176(wed by =)-.25 F F2(wor)A(d)-.37 E F0
3.676(,t)C 1.176(he v)-3.676 F 1.177(alue of the v)-.25 F 1.177
(ariable is set to)-.25 F F2(wor)144 650.4 Q(d)-.37 E F0 6.206(.T)C
1.206(he return status is 0 unless an in)-6.206 F -.25(va)-.4 G 1.205
(lid option is encountered, one of the).25 F F2(names)4.065 E F0 1.205
(is not a)3.975 F -.25(va)144 662.4 S(lid shell v).25 E
(ariable name, or)-.25 E F1<ad66>2.5 E F0(is supplied with a)2.5 E F2
(name)2.86 E F0(that is not a function.)2.68 E F1 -.18(re)108 679.2 S
(tur).18 E(n)-.15 E F0([)2.5 E F2(n)A F0(])A .586
(Causes a function to e)144 691.2 R .587(xit with the return v)-.15 F
.587(alue speci\214ed by)-.25 F F2(n)3.087 E F0 5.587(.I).24 G(f)-5.587
E F2(n)3.447 E F0 .587(is omitted, the return status is)3.327 F 1.335
(that of the last command e)144 703.2 R -.15(xe)-.15 G 1.335
(cuted in the function body).15 F 6.335(.I)-.65 G 3.835(fu)-6.335 G
1.335(sed outside a function, b)-3.835 F 1.335(ut during)-.2 F -.15(exe)
144 715.2 S .794(cution of a script by the).15 F F1(.)3.294 E F0(\()
5.794 E F1(sour)A(ce)-.18 E F0 3.294(\)c)C .794
(ommand, it causes the shell to stop e)-3.294 F -.15(xe)-.15 G .795
(cuting that script).15 F 1.201(and return either)144 727.2 R F2(n)4.061
E F0 1.201(or the e)3.941 F 1.201(xit status of the last command e)-.15
F -.15(xe)-.15 G 1.2(cuted within the script as the e).15 F(xit)-.15 E
(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(12)198.725 E 0 Cg EP
%%Page: 13 13
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E .393
(status of the script.)144 84 R .393
(If used outside a function and not during e)5.393 F -.15(xe)-.15 G .393
(cution of a script by).15 F/F1 10/Times-Bold@0 SF(.)2.893 E F0 2.893
(,t).833 G .393(he return)-2.893 F 1.451(status is f)144 96 R 3.951
(alse. An)-.1 F 3.951(yc)-.15 G 1.451(ommand associated with the)-3.951
F F1(RETURN)3.951 E F0 1.451(trap is e)3.951 F -.15(xe)-.15 G 1.45
(cuted before e).15 F -.15(xe)-.15 G(cution).15 E
(resumes after the function or script.)144 108 Q F1(set)108 124.8 Q F0
([)2.5 E F1(\255\255abefhkmnptuvxBCEHPT)A F0 2.5(][)C F1<ad6f>-2.5 E/F2
10/Times-Italic@0 SF(option)2.5 E F0 2.5(][)C F2(ar)-2.5 E(g)-.37 E F0
(...])2.5 E F1(set)108 136.8 Q F0([)2.5 E F1(+abefhkmnptuvxBCEHPT)A F0
2.5(][)C F1(+o)-2.5 E F2(option)2.5 E F0 2.5(][)C F2(ar)-2.5 E(g)-.37 E
F0(...])2.5 E -.4(Wi)144 148.8 S .835(thout options, the name and v).4 F
.835(alue of each shell v)-.25 F .836
(ariable are displayed in a format that can be)-.25 F .784
(reused as input for setting or resetting the currently-set v)144 160.8
R 3.284(ariables. Read-only)-.25 F -.25(va)3.284 G .783
(riables cannot be).25 F 2.946(reset. In)144 172.8 R F2 .447(posix mode)
2.946 F F0 2.947(,o)C .447(nly shell v)-2.947 F .447
(ariables are listed.)-.25 F .447
(The output is sorted according to the current)5.447 F 3.531
(locale. When)144 184.8 R 1.031(options are speci\214ed, the)3.531 F
3.531(ys)-.15 G 1.031(et or unset shell attrib)-3.531 F 3.53(utes. An)
-.2 F 3.53(ya)-.15 G -.18(rg)-3.53 G 1.03(uments remaining).18 F 1.623
(after option processing are treated as v)144 196.8 R 1.624
(alues for the positional parameters and are assigned, in)-.25 F(order)
144 208.8 Q 2.5(,t)-.4 G(o)-2.5 E F1($1)2.5 E F0(,)A F1($2)2.5 E F0(,)A
F1 2.5(... $)2.5 F F2(n)A F0 5(.O)C(ptions, if speci\214ed, ha)-5 E .3
-.15(ve t)-.2 H(he follo).15 E(wing meanings:)-.25 E F1<ad61>144 220.8 Q
F0 .54(Automatically mark v)29.3 F .539
(ariables and functions which are modi\214ed or created for e)-.25 F
.539(xport to)-.15 F(the en)184 232.8 Q
(vironment of subsequent commands.)-.4 E F1<ad62>144 244.8 Q F0 .131
(Report the status of terminated background jobs immediately)28.74 F
2.632(,r)-.65 G .132(ather than before the ne)-2.632 F(xt)-.15 E
(primary prompt.)184 256.8 Q(This is ef)5 E(fecti)-.25 E .3 -.15(ve o)
-.25 H(nly when job control is enabled.).15 E F1<ad65>144 268.8 Q F0
1.694(Exit immediately if a)29.86 F F2 1.693(simple command)4.193 F F0
(\(see)4.193 E/F3 9/Times-Bold@0 SF 1.693(SHELL GRAMMAR)4.193 F F0(abo)
3.943 E -.15(ve)-.15 G 4.193(\)e).15 G 1.693(xits with a)-4.343 F .011
(non-zero status.)184 280.8 R .011(The shell does not e)5.011 F .011
(xit if the command that f)-.15 F .012(ails is part of the command)-.1 F
.719(list immediately follo)184 292.8 R .719(wing a)-.25 F F1(while)
3.219 E F0(or)3.219 E F1(until)3.219 E F0 -.1(ke)3.219 G(yw)-.05 E .719
(ord, part of the test in an)-.1 F F1(if)3.218 E F0(statement,)3.218 E
.378(part of a command e)184 304.8 R -.15(xe)-.15 G .379(cuted in a).15
F F1(&&)2.879 E F0(or)2.879 E/F4 10/Symbol SF<efef>2.879 E F0 .379
(list, an)2.879 F 2.879(yc)-.15 G .379(ommand in a pipeline b)-2.879 F
.379(ut the last,)-.2 F .578(or if the command')184 316.8 R 3.078(sr)
-.55 G .578(eturn v)-3.078 F .578(alue is being in)-.25 F -.15(ve)-.4 G
.578(rted via).15 F F1(!)3.078 E F0 5.578(.F)C .577
(ailing simple commands that)-5.728 F .402(are part of shell functions \
or command lists enclosed in braces or parentheses satisfying)184 328.8
R .841(the abo)184 340.8 R 1.141 -.15(ve c)-.15 H .841
(onditions do not cause the shell to e).15 F 3.341(xit. A)-.15 F .84
(trap on)3.34 F F1(ERR)3.34 E F0 3.34(,i)C 3.34(fs)-3.34 G .84(et, is e)
-3.34 F -.15(xe)-.15 G(cuted).15 E(before the shell e)184 352.8 Q(xits.)
-.15 E F1<ad66>144 364.8 Q F0(Disable pathname e)30.97 E(xpansion.)-.15
E F1<ad68>144 376.8 Q F0 2.238(Remember the location of commands as the)
28.74 F 4.738(ya)-.15 G 2.239(re look)-4.738 F 2.239(ed up for e)-.1 F
-.15(xe)-.15 G 4.739(cution. This).15 F(is)4.739 E(enabled by def)184
388.8 Q(ault.)-.1 E F1<ad6b>144 400.8 Q F0 .514(All ar)28.74 F .514
(guments in the form of assignment statements are placed in the en)-.18
F .513(vironment for a)-.4 F
(command, not just those that precede the command name.)184 412.8 Q F1
<ad6d>144 424.8 Q F0 .148(Monitor mode.)25.97 F .148
(Job control is enabled.)5.148 F .149(This option is on by def)5.148 F
.149(ault for interacti)-.1 F .449 -.15(ve s)-.25 H(hells).15 E .637
(on systems that support it \(see)184 436.8 R F3 .636(JOB CONTR)3.136 F
(OL)-.27 E F0(abo)2.886 E -.15(ve)-.15 G 3.136(\). Background).15 F .636
(processes run in a)3.136 F .641
(separate process group and a line containing their e)184 448.8 R .642
(xit status is printed upon their com-)-.15 F(pletion.)184 460.8 Q F1
<ad6e>144 472.8 Q F0 .653(Read commands b)28.74 F .653(ut do not e)-.2 F
-.15(xe)-.15 G .653(cute them.).15 F .652
(This may be used to check a shell script for)5.653 F(syntax errors.)184
484.8 Q(This is ignored by interacti)5 E .3 -.15(ve s)-.25 H(hells.).15
E F1<ad6f>144 496.8 Q F2(option\255name)2.5 E F0(The)184 508.8 Q F2
(option\255name)2.5 E F0(can be one of the follo)2.5 E(wing:)-.25 E F1
(allexport)184 520.8 Q F0(Same as)224 532.8 Q F1<ad61>2.5 E F0(.)A F1
(braceexpand)184 544.8 Q F0(Same as)224 556.8 Q F1<ad42>2.5 E F0(.)A F1
(emacs)184 568.8 Q F0 .089
(Use an emacs-style command line editing interf)13.9 F 2.589(ace. This)
-.1 F .089(is enabled by def)2.589 F(ault)-.1 E .95
(when the shell is interacti)224 580.8 R -.15(ve)-.25 G 3.45(,u).15 G
.95(nless the shell is started with the)-3.45 F F1(\255\255noediting)
3.45 E F0 2.5(option. This)224 592.8 R(also af)2.5 E
(fects the editing interf)-.25 E(ace used for)-.1 E F1 -.18(re)2.5 G
(ad \255e).18 E F0(.)A F1(errtrace)184 604.8 Q F0(Same as)5.03 E F1
<ad45>2.5 E F0(.)A F1(functrace)184 616.8 Q F0(Same as)224 628.8 Q F1
<ad54>2.5 E F0(.)A F1(err)184 640.8 Q(exit)-.18 E F0(Same as)11.31 E F1
<ad65>2.5 E F0(.)A F1(hashall)184 652.8 Q F0(Same as)9.43 E F1<ad68>2.5
E F0(.)A F1(histexpand)184 664.8 Q F0(Same as)224 676.8 Q F1<ad48>2.5 E
F0(.)A F1(history)184 688.8 Q F0 .586(Enable command history)10 F 3.087
(,a)-.65 G 3.087(sd)-3.087 G .587(escribed abo)-3.087 F .887 -.15(ve u)
-.15 H(nder).15 E F3(HIST)3.087 E(OR)-.162 E(Y)-.315 E/F5 9
/Times-Roman@0 SF(.)A F0 .587(This option is)5.087 F(on by def)224 700.8
Q(ault in interacti)-.1 E .3 -.15(ve s)-.25 H(hells.).15 E(GNU Bash-4.0)
72 768 Q(2004 Apr 20)148.735 E(13)198.725 E 0 Cg EP
%%Page: 14 14
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
/Times-Bold@0 SF(ignor)184 84 Q(eeof)-.18 E F0 1.657(The ef)224 96 R
1.657(fect is as if the shell command)-.25 F/F2 10/Courier@0 SF
(IGNOREEOF=10)4.156 E F0 1.656(had been e)4.156 F -.15(xe)-.15 G(cuted)
.15 E(\(see)224 108 Q F1(Shell V)2.5 E(ariables)-.92 E F0(abo)2.5 E -.15
(ve)-.15 G(\).).15 E F1 -.1(ke)184 120 S(yw).1 E(ord)-.1 E F0(Same as)
224 132 Q F1<ad6b>2.5 E F0(.)A F1(monitor)184 144 Q F0(Same as)5.56 E F1
<ad6d>2.5 E F0(.)A F1(noclob)184 156 Q(ber)-.1 E F0(Same as)224 168 Q F1
<ad43>2.5 E F0(.)A F1(noexec)184 180 Q F0(Same as)11.12 E F1<ad6e>2.5 E
F0(.)A F1(noglob)184 192 Q F0(Same as)11.1 E F1<ad66>2.5 E F0(.)A F1
(nolog)184 204 Q F0(Currently ignored.)16.66 E F1(notify)184 216 Q F0
(Same as)15 E F1<ad62>2.5 E F0(.)A F1(nounset)184 228 Q F0(Same as)6.66
E F1<ad75>2.5 E F0(.)A F1(onecmd)184 240 Q F0(Same as)6.67 E F1<ad74>2.5
E F0(.)A F1(ph)184 252 Q(ysical)-.15 E F0(Same as)5.14 E F1<ad50>2.5 E
F0(.)A F1(pipefail)184 264 Q F0 1.029(If set, the return v)7.77 F 1.029
(alue of a pipeline is the v)-.25 F 1.03
(alue of the last \(rightmost\) com-)-.25 F 1.137(mand to e)224 276 R
1.136
(xit with a non-zero status, or zero if all commands in the pipeline)
-.15 F -.15(ex)224 288 S(it successfully).15 E 5(.T)-.65 G
(his option is disabled by def)-5 E(ault.)-.1 E F1(posix)184 300 Q F0
2.09(Change the beha)17.77 F 2.091(vior of)-.2 F F1(bash)4.591 E F0
2.091(where the def)4.591 F 2.091(ault operation dif)-.1 F 2.091
(fers from the)-.25 F(POSIX standard to match the standard \()224 312 Q
/F3 10/Times-Italic@0 SF(posix mode)A F0(\).)A F1(pri)184 324 Q(vileged)
-.1 E F0(Same as)224 336 Q F1<ad70>2.5 E F0(.)A F1 -.1(ve)184 348 S
(rbose).1 E F0(Same as)7.33 E F1<ad76>2.5 E F0(.)A F1(vi)184 360 Q F0
1.466(Use a vi-style command line editing interf)32.22 F 3.965
(ace. This)-.1 F 1.465(also af)3.965 F 1.465(fects the editing)-.25 F
(interf)224 372 Q(ace used for)-.1 E F1 -.18(re)2.5 G(ad \255e).18 E F0
(.)A F1(xtrace)184 384 Q F0(Same as)13.35 E F1<ad78>2.5 E F0(.)A(If)184
402 Q F1<ad6f>3.052 E F0 .552(is supplied with no)3.052 F F3
(option\255name)3.053 E F0 3.053(,t)C .553(he v)-3.053 F .553
(alues of the current options are printed.)-.25 F(If)5.553 E F1(+o)184
414 Q F0 1.072(is supplied with no)3.572 F F3(option\255name)3.572 E F0
3.572(,a)C 1.071(series of)-.001 F F1(set)3.571 E F0 1.071
(commands to recreate the current)3.571 F
(option settings is displayed on the standard output.)184 426 Q F1<ad70>
144 438 Q F0 -.45(Tu)28.74 G 1.071(rn on).45 F F3(privile)4.821 E -.1
(ge)-.4 G(d).1 E F0 3.572(mode. In)4.341 F 1.072(this mode, the)3.572 F
/F4 9/Times-Bold@0 SF($ENV)3.572 E F0(and)3.322 E F4($B)3.572 E(ASH_ENV)
-.27 E F0 1.072(\214les are not pro-)3.322 F 1.501
(cessed, shell functions are not inherited from the en)184 450 R 1.5
(vironment, and the)-.4 F F4(SHELLOPTS)4 E/F5 9/Times-Roman@0 SF(,)A F1
(CDP)184 462 Q -.95(AT)-.74 G(H).95 E F0 5.603(,a)C(nd)-5.603 E F1
(GLOBIGNORE)5.603 E F0 -.25(va)5.603 G 3.103(riables, if the).25 F 5.603
(ya)-.15 G 3.103(ppear in the en)-5.603 F 3.103(vironment, are)-.4 F
2.618(ignored. If)184 474 R .118(the shell is started with the ef)2.618
F(fecti)-.25 E .418 -.15(ve u)-.25 H .117
(ser \(group\) id not equal to the real user).15 F 1.018
(\(group\) id, and the)184 486 R F1<ad70>3.518 E F0 1.018
(option is not supplied, these actions are tak)3.518 F 1.018
(en and the ef)-.1 F(fecti)-.25 E -.15(ve)-.25 G .287
(user id is set to the real user id.)184 498 R .286(If the)5.286 F F1
<ad70>2.786 E F0 .286(option is supplied at startup, the ef)2.786 F
(fecti)-.25 E .586 -.15(ve u)-.25 H(ser).15 E .102(id is not reset.)184
510 R -.45(Tu)5.102 G .102(rning this option of).45 F 2.602(fc)-.25 G
.102(auses the ef)-2.602 F(fecti)-.25 E .402 -.15(ve u)-.25 H .103
(ser and group ids to be set to).15 F(the real user and group ids.)184
522 Q F1<ad74>144 534 Q F0(Exit after reading and e)30.97 E -.15(xe)-.15
G(cuting one command.).15 E F1<ad75>144 546 Q F0 -.35(Tr)28.74 G .445
(eat unset v).35 F .444
(ariables as an error when performing parameter e)-.25 F 2.944
(xpansion. If)-.15 F -.15(ex)2.944 G .444(pansion is).15 F .519
(attempted on an unset v)184 558 R .519
(ariable, the shell prints an error message, and, if not interacti)-.25
F -.15(ve)-.25 G(,).15 E -.15(ex)184 570 S(its with a non-zero status.)
.15 E F1<ad76>144 582 Q F0(Print shell input lines as the)29.3 E 2.5(ya)
-.15 G(re read.)-2.5 E F1<ad78>144 594 Q F0 .315(After e)29.3 F .315
(xpanding each)-.15 F F3 .315(simple command)2.815 F F0(,)A F1 -.25(fo)
2.815 G(r).25 E F0(command,)2.815 E F1(case)2.815 E F0(command,)2.815 E
F1(select)2.815 E F0(command,)2.815 E 1.235(or arithmetic)184 606 R F1
-.25(fo)3.736 G(r).25 E F0 1.236(command, display the e)3.736 F 1.236
(xpanded v)-.15 F 1.236(alue of)-.25 F F4(PS4)3.736 E F5(,)A F0(follo)
3.486 E 1.236(wed by the com-)-.25 F(mand and its e)184 618 Q
(xpanded ar)-.15 E(guments or associated w)-.18 E(ord list.)-.1 E F1
<ad42>144 630 Q F0 2.579(The shell performs brace e)27.63 F 2.578
(xpansion \(see)-.15 F F1 2.578(Brace Expansion)5.078 F F0(abo)5.078 E
-.15(ve)-.15 G 5.078(\). This).15 F 2.578(is on by)5.078 F(def)184 642 Q
(ault.)-.1 E F1<ad43>144 654 Q F0 .213(If set,)27.08 F F1(bash)2.713 E
F0 .213(does not o)2.713 F -.15(ve)-.15 G .214(rwrite an e).15 F .214
(xisting \214le with the)-.15 F F1(>)2.714 E F0(,)A F1(>&)2.714 E F0
2.714(,a)C(nd)-2.714 E F1(<>)2.714 E F0 .214(redirection opera-)2.714 F
3.054(tors. This)184 666 R .553(may be o)3.053 F -.15(ve)-.15 G .553
(rridden when creating output \214les by using the redirection opera-)
.15 F(tor)184 678 Q F1(>|)2.5 E F0(instead of)2.5 E F1(>)2.5 E F0(.)A F1
<ad45>144 690 Q F0 .103(If set, an)27.63 F 2.603(yt)-.15 G .103(rap on)
-2.603 F F1(ERR)2.603 E F0 .104
(is inherited by shell functions, command substitutions, and com-)2.603
F .839(mands e)184 702 R -.15(xe)-.15 G .839(cuted in a subshell en).15
F 3.339(vironment. The)-.4 F F1(ERR)3.338 E F0 .838
(trap is normally not inherited in)3.338 F(such cases.)184 714 Q
(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(14)198.725 E 0 Cg EP
%%Page: 15 15
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
/Times-Bold@0 SF<ad48>144 84 Q F0(Enable)26.52 E F1(!)3.031 E F0 .531
(style history substitution.)5.531 F .531(This option is on by def)5.531
F .532(ault when the shell is inter)-.1 F(-)-.2 E(acti)184 96 Q -.15(ve)
-.25 G(.).15 E F1<ad50>144 108 Q F0 1.165
(If set, the shell does not follo)28.19 F 3.664(ws)-.25 G 1.164
(ymbolic links when e)-3.664 F -.15(xe)-.15 G 1.164
(cuting commands such as).15 F F1(cd)3.664 E F0 2.821
(that change the current w)184 120 R 2.822(orking directory)-.1 F 7.822
(.I)-.65 G 5.322(tu)-7.822 G 2.822(ses the ph)-5.322 F 2.822
(ysical directory structure)-.05 F 2.686(instead. By)184 132 R(def)2.686
E(ault,)-.1 E F1(bash)2.686 E F0(follo)2.686 E .186
(ws the logical chain of directories when performing com-)-.25 F
(mands which change the current directory)184 144 Q(.)-.65 E F1<ad54>144
156 Q F0 .89(If set, an)27.63 F 3.39(yt)-.15 G .89(raps on)-3.39 F F1
(DEB)3.39 E(UG)-.1 E F0(and)3.39 E F1(RETURN)3.39 E F0 .89
(are inherited by shell functions, command)3.39 F 1.932
(substitutions, and commands e)184 168 R -.15(xe)-.15 G 1.932
(cuted in a subshell en).15 F 4.432(vironment. The)-.4 F F1(DEB)4.432 E
(UG)-.1 E F0(and)4.432 E F1(RETURN)184 180 Q F0
(traps are normally not inherited in such cases.)2.5 E F1<adad>144 192 Q
F0 .4(If no ar)28.6 F .401(guments follo)-.18 F 2.901(wt)-.25 G .401
(his option, then the positional parameters are unset.)-2.901 F
(Otherwise,)5.401 E(the positional parameters are set to the)184 204 Q
/F2 10/Times-Italic@0 SF(ar)2.5 E(g)-.37 E F0(s, e)A -.15(ve)-.25 G 2.5
(ni).15 G 2.5(fs)-2.5 G(ome of them be)-2.5 E(gin with a)-.15 E F1<ad>
2.5 E F0(.)A F1<ad>144 216 Q F0 1.945
(Signal the end of options, cause all remaining)34.3 F F2(ar)4.444 E(g)
-.37 E F0 4.444(st)C 4.444(ob)-4.444 G 4.444(ea)-4.444 G 1.944
(ssigned to the positional)-4.444 F 3.445(parameters. The)184 228 R F1
<ad78>3.445 E F0(and)3.445 E F1<ad76>3.445 E F0 .945
(options are turned of)3.445 F 3.445(f. If)-.25 F .946(there are no)
3.445 F F2(ar)3.446 E(g)-.37 E F0 .946(s, the positional)B
(parameters remain unchanged.)184 240 Q .425(The options are of)144
256.8 R 2.925(fb)-.25 G 2.925(yd)-2.925 G(ef)-2.925 E .425
(ault unless otherwise noted.)-.1 F .425
(Using + rather than \255 causes these options)5.425 F .177
(to be turned of)144 268.8 R 2.677(f. The)-.25 F .178
(options can also be speci\214ed as ar)2.678 F .178(guments to an in)
-.18 F -.2(vo)-.4 G .178(cation of the shell.).2 F(The)5.178 E .066
(current set of options may be found in)144 280.8 R F1<24ad>2.566 E F0
5.066(.T)C .066(he return status is al)-5.066 F -.1(wa)-.1 G .066
(ys true unless an in).1 F -.25(va)-.4 G .066(lid option).25 F
(is encountered.)144 292.8 Q F1(shift)108 309.6 Q F0([)2.5 E F2(n)A F0
(])A .428(The positional parameters from)144 321.6 R F2(n)2.928 E F0
.429(+1 ... are renamed to)B F1 .429($1 ....)2.929 F F0 -.15(Pa)5.429 G
.429(rameters represented by the num-).15 F(bers)144 333.6 Q F1($#)2.583
E F0(do)2.583 E .083(wn to)-.25 F F1($#)2.583 E F0<ad>A F2(n)A F0 .083
(+1 are unset.)B F2(n)5.443 E F0 .083(must be a non-ne)2.823 F -.05(ga)
-.15 G(ti).05 E .382 -.15(ve n)-.25 H .082(umber less than or equal to)
.15 F F1($#)2.582 E F0 5.082(.I)C(f)-5.082 E F2(n)2.942 E F0 .06
(is 0, no parameters are changed.)144 345.6 R(If)5.06 E F2(n)2.92 E F0
.06(is not gi)2.8 F -.15(ve)-.25 G .06(n, it is assumed to be 1.).15 F
(If)5.06 E F2(n)2.92 E F0 .06(is greater than)2.8 F F1($#)2.56 E F0 2.56
(,t)C(he)-2.56 E .144(positional parameters are not changed.)144 357.6 R
.144(The return status is greater than zero if)5.144 F F2(n)3.003 E F0
.143(is greater than)2.883 F F1($#)2.643 E F0
(or less than zero; otherwise 0.)144 369.6 Q F1(shopt)108 386.4 Q F0([)
2.5 E F1(\255pqsu)A F0 2.5(][)C F1<ad6f>-2.5 E F0 2.5(][)C F2(optname)
-2.5 E F0(...])2.5 E -.8(To)144 398.4 S .222(ggle the v).8 F .222
(alues of v)-.25 F .222(ariables controlling optional shell beha)-.25 F
(vior)-.2 E 5.222(.W)-.55 G .222(ith no options, or with the)-5.622 F F1
<ad70>2.722 E F0 .721(option, a list of all settable options is display\
ed, with an indication of whether or not each is set.)144 410.4 R(The)
144 422.4 Q F1<ad70>2.827 E F0 .327(option causes output to be displaye\
d in a form that may be reused as input.)2.827 F .328(Other options)
5.328 F(ha)144 434.4 Q .3 -.15(ve t)-.2 H(he follo).15 E(wing meanings:)
-.25 E F1<ad73>144 446.4 Q F0(Enable \(set\) each)26.41 E F2(optname)2.5
E F0(.)A F1<ad75>144 458.4 Q F0(Disable \(unset\) each)24.74 E F2
(optname)2.5 E F0(.)A F1<ad71>144 470.4 Q F0 .003(Suppresses normal out\
put \(quiet mode\); the return status indicates whether the)24.74 F F2
(optname)2.503 E F0(is)2.503 E .255(set or unset.)180 482.4 R .255
(If multiple)5.255 F F2(optname)2.755 E F0(ar)2.755 E .256
(guments are gi)-.18 F -.15(ve)-.25 G 2.756(nw).15 G(ith)-2.756 E F1
<ad71>2.756 E F0 2.756(,t)C .256(he return status is zero if)-2.756 F
(all)180 494.4 Q F2(optnames)2.5 E F0(are enabled; non-zero otherwise.)
2.5 E F1<ad6f>144 506.4 Q F0(Restricts the v)25.3 E(alues of)-.25 E F2
(optname)2.5 E F0(to be those de\214ned for the)2.5 E F1<ad6f>2.5 E F0
(option to the)2.5 E F1(set)2.5 E F0 -.2(bu)2.5 G(iltin.).2 E .128
(If either)144 523.2 R F1<ad73>2.628 E F0(or)2.628 E F1<ad75>2.628 E F0
.127(is used with no)2.627 F F2(optname)2.627 E F0(ar)2.627 E .127
(guments, the display is limited to those options which)-.18 F 1.023
(are set or unset, respecti)144 535.2 R -.15(ve)-.25 G(ly).15 E 6.023
(.U)-.65 G 1.024(nless otherwise noted, the)-6.023 F F1(shopt)3.524 E F0
1.024(options are disabled \(unset\) by)3.524 F(def)144 547.2 Q(ault.)
-.1 E 1.544(The return status when listing options is zero if all)144
564 R F2(optnames)4.044 E F0 1.544(are enabled, non-zero otherwise.)
4.044 F .696
(When setting or unsetting options, the return status is zero unless an)
144 576 R F2(optname)3.196 E F0 .696(is not a v)3.196 F .696(alid shell)
-.25 F(option.)144 588 Q(The list of)144 604.8 Q F1(shopt)2.5 E F0
(options is:)2.5 E F1(autocd)144 622.8 Q F0 .2
(If set, a command name that is the name of a directory is e)11.11 F
-.15(xe)-.15 G .199(cuted as if it were the ar).15 F(gu-)-.18 E
(ment to the)184 634.8 Q F1(cd)2.5 E F0 2.5(command. This)2.5 F
(option is only used by interacti)2.5 E .3 -.15(ve s)-.25 H(hells.).15 E
F1(cdable_v)144 646.8 Q(ars)-.1 E F0 .155(If set, an ar)184 658.8 R .155
(gument to the)-.18 F F1(cd)2.655 E F0 -.2(bu)2.655 G .156
(iltin command that is not a directory is assumed to be the).2 F
(name of a v)184 670.8 Q(ariable whose v)-.25 E
(alue is the directory to change to.)-.25 E F1(cdspell)144 682.8 Q F0
1.055
(If set, minor errors in the spelling of a directory component in a)
10.55 F F1(cd)3.555 E F0 1.055(command will be)3.555 F 3.987
(corrected. The)184 694.8 R 1.487(errors check)3.987 F 1.487
(ed for are transposed characters, a missing character)-.1 F 3.988(,a)
-.4 G(nd)-3.988 E .552(one character too man)184 706.8 R 4.352 -.65
(y. I)-.15 H 3.052(fac).65 G .552
(orrection is found, the corrected \214le name is printed, and)-3.052 F
(the command proceeds.)184 718.8 Q
(This option is only used by interacti)5 E .3 -.15(ve s)-.25 H(hells.)
.15 E(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(15)198.725 E 0 Cg EP
%%Page: 16 16
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
/Times-Bold@0 SF(checkhash)144 84 Q F0 2.079(If set,)184 96 R F1(bash)
4.579 E F0 2.079(checks that a command found in the hash table e)4.579 F
2.08(xists before trying to)-.15 F -.15(exe)184 108 S(cute it.).15 E
(If a hashed command no longer e)5 E
(xists, a normal path search is performed.)-.15 E F1(checkjobs)144 120 Q
F0 .449(If set,)184 132 R F1(bash)2.949 E F0 .449
(lists the status of an)2.949 F 2.949(ys)-.15 G .448
(topped and running jobs before e)-2.949 F .448(xiting an interacti)-.15
F -.15(ve)-.25 G 3.438(shell. If)184 144 R(an)3.438 E 3.438(yj)-.15 G
.938(obs are running, this causes the e)-3.438 F .938
(xit to be deferred until a second e)-.15 F .939(xit is)-.15 F 1.456
(attempted without an interv)184 156 R 1.456(ening command \(see)-.15 F
F1 1.456(JOB CONTR)3.956 F(OL)-.3 E F0(abo)3.956 E -.15(ve)-.15 G 3.956
(\). The).15 F(shell)3.956 E(al)184 168 Q -.1(wa)-.1 G(ys postpones e).1
E(xiting if an)-.15 E 2.5(yj)-.15 G(obs are stopped.)-2.5 E F1
(checkwinsize)144 180 Q F0 .796(If set,)184 192 R F1(bash)3.296 E F0
.796(checks the windo)3.296 F 3.296(ws)-.25 G .797
(ize after each command and, if necessary)-3.296 F 3.297(,u)-.65 G .797
(pdates the)-3.297 F -.25(va)184 204 S(lues of).25 E/F2 9/Times-Bold@0
SF(LINES)2.5 E F0(and)2.25 E F2(COLUMNS)2.5 E/F3 9/Times-Roman@0 SF(.)A
F1(cmdhist)144 216 Q F0 1.202(If set,)6.11 F F1(bash)3.702 E F0 1.202
(attempts to sa)3.702 F 1.502 -.15(ve a)-.2 H 1.202
(ll lines of a multiple-line command in the same history).15 F(entry)184
228 Q 5(.T)-.65 G(his allo)-5 E
(ws easy re-editing of multi-line commands.)-.25 E F1(compat31)144 240 Q
F0 .419(If set,)184 252 R F1(bash)2.919 E F0 .419(changes its beha)2.919
F .419(vior to that of v)-.2 F .42(ersion 3.1 with respect to quoted ar)
-.15 F(guments)-.18 E(to the conditional command')184 264 Q 2.5(s=)-.55
G 2.5(~o)-2.5 G(perator)-2.5 E(.)-.55 E F1(dirspell)144 276 Q F0 .859
(If set,)7.77 F F1(bash)3.359 E F0 .858
(attempts spelling correction on directory names during w)3.359 F .858
(ord completion if)-.1 F
(the directory name initially supplied does not e)184 288 Q(xist.)-.15 E
F1(dotglob)144 300 Q F0 .165(If set,)7.77 F F1(bash)2.665 E F0 .165
(includes \214lenames be)2.665 F .165(ginning with a `.)-.15 F 2.665('i)
-.7 G 2.665(nt)-2.665 G .165(he results of pathname e)-2.665 F
(xpansion.)-.15 E F1(execfail)144 312 Q F0 1.387
(If set, a non-interacti)7.79 F 1.687 -.15(ve s)-.25 H 1.386
(hell will not e).15 F 1.386(xit if it cannot e)-.15 F -.15(xe)-.15 G
1.386(cute the \214le speci\214ed as an).15 F(ar)184 324 Q
(gument to the)-.18 E F1(exec)2.5 E F0 -.2(bu)2.5 G(iltin command.).2 E
(An interacti)5 E .3 -.15(ve s)-.25 H(hell does not e).15 E(xit if)-.15
E F1(exec)2.5 E F0 -.1(fa)2.5 G(ils.).1 E F1(expand_aliases)144 336 Q F0
.716(If set, aliases are e)184 348 R .717(xpanded as described abo)-.15
F 1.017 -.15(ve u)-.15 H(nder).15 E F2(ALIASES)3.217 E F3(.)A F0 .717
(This option is enabled)5.217 F(by def)184 360 Q(ault for interacti)-.1
E .3 -.15(ve s)-.25 H(hells.).15 E F1(extdeb)144 372 Q(ug)-.2 E F0
(If set, beha)184 384 Q(vior intended for use by deb)-.2 E
(uggers is enabled:)-.2 E F1(1.)184 396 Q F0(The)28.5 E F1<ad46>4.251 E
F0 1.751(option to the)4.251 F F1(declar)4.251 E(e)-.18 E F0 -.2(bu)
4.251 G 1.751(iltin displays the source \214le name and line).2 F
(number corresponding to each function name supplied as an ar)220 408 Q
(gument.)-.18 E F1(2.)184 420 Q F0 1.667(If the command run by the)28.5
F F1(DEB)4.167 E(UG)-.1 E F0 1.667(trap returns a non-zero v)4.167 F
1.667(alue, the ne)-.25 F(xt)-.15 E(command is skipped and not e)220 432
Q -.15(xe)-.15 G(cuted.).15 E F1(3.)184 444 Q F0 .841
(If the command run by the)28.5 F F1(DEB)3.341 E(UG)-.1 E F0 .841
(trap returns a v)3.341 F .84(alue of 2, and the shell is)-.25 F -.15
(exe)220 456 S .488
(cuting in a subroutine \(a shell function or a shell script e).15 F
-.15(xe)-.15 G .488(cuted by the).15 F F1(.)2.988 E F0(or)2.988 E F1
(sour)220 468 Q(ce)-.18 E F0 -.2(bu)2.5 G(iltins\), a call to).2 E F1
-.18(re)2.5 G(tur).18 E(n)-.15 E F0(is simulated.)2.5 E F1 26(4. B)184
480 R(ASH_ARGC)-.3 E F0(and)3.776 E F1 -.3(BA)3.776 G(SH_ARGV).3 E F0
1.275(are updated as described in their descrip-)3.776 F(tions abo)220
492 Q -.15(ve)-.15 G(.).15 E F1(5.)184 504 Q F0 1.359
(Function tracing is enabled:)28.5 F 1.359
(command substitution, shell functions, and sub-)6.359 F(shells in)220
516 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(dw).1 G(ith)-2.5 E F1(\()2.5 E/F4 10
/Times-Italic@0 SF(command)2.5 E F1(\))2.5 E F0(inherit the)2.5 E F1
(DEB)2.5 E(UG)-.1 E F0(and)2.5 E F1(RETURN)2.5 E F0(traps.)2.5 E F1(6.)
184 528 Q F0 .805(Error tracing is enabled:)28.5 F .804
(command substitution, shell functions, and subshells)5.805 F(in)220 540
Q -.2(vo)-.4 G -.1(ke).2 G 2.5(dw).1 G(ith)-2.5 E F1(\()2.5 E F4
(command)2.5 E F1(\))2.5 E F0(inherit the)2.5 E F1(ERR)2.5 E(OR)-.3 E F0
(trap.)2.5 E F1(extglob)144 552 Q F0 .4(If set, the e)8.89 F .4
(xtended pattern matching features described abo)-.15 F .7 -.15(ve u)
-.15 H(nder).15 E F1 -.1(Pa)2.9 G .4(thname Expan-).1 F(sion)184 564 Q
F0(are enabled.)2.5 E F1(extquote)144 576 Q F0 2.473(If set,)184 588 R
F1($)4.973 E F0<08>A F4(string)A F0 4.973<0861>C(nd)-4.973 E F1($)4.973
E F0(")A F4(string)A F0 4.973("q)C 2.473(uoting is performed within)
-4.973 F F1(${)4.973 E F4(par)A(ameter)-.15 E F1(})A F0 -.15(ex)4.973 G
(pansions).15 E(enclosed in double quotes.)184 600 Q
(This option is enabled by def)5 E(ault.)-.1 E F1(failglob)144 612 Q F0
1.424(If set, patterns which f)7.77 F 1.425
(ail to match \214lenames during pathname e)-.1 F 1.425
(xpansion result in an)-.15 F -.15(ex)184 624 S(pansion error).15 E(.)
-.55 E F1 -.25(fo)144 636 S -.18(rc).25 G(e_\214gnor).18 E(e)-.18 E F0
.585(If set, the suf)184 648 R<8c78>-.25 E .585(es speci\214ed by the)
-.15 F F1(FIGNORE)3.085 E F0 .585(shell v)3.085 F .585(ariable cause w)
-.25 F .585(ords to be ignored)-.1 F .32(when performing w)184 660 R .32
(ord completion e)-.1 F -.15(ve)-.25 G 2.82(ni).15 G 2.82(ft)-2.82 G .32
(he ignored w)-2.82 F .32(ords are the only possible com-)-.1 F 3.33
(pletions. See)184 672 R F2 .83(SHELL V)3.33 F(ARIABLES)-1.215 E F0(abo)
3.08 E 1.13 -.15(ve f)-.15 H .829(or a description of).15 F F1(FIGNORE)
3.329 E F0 5.829(.T)C .829(his option)-5.829 F(is enabled by def)184 684
Q(ault.)-.1 E F1(globstar)144 696 Q F0 .439(If set, the pattern)5 F F1
(**)2.939 E F0 .439(used in a \214lename e)2.939 F .439(xpansion conte)
-.15 F .44(xt will match a \214les and zero or)-.15 F 1.298
(more directories and subdirectories.)184 708 R 1.298
(If the pattern is follo)6.298 F 1.298(wed by a)-.25 F F1(/)3.797 E F0
3.797(,o)C 1.297(nly directories)-3.797 F(and subdirectories match.)184
720 Q(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(16)198.725 E 0 Cg EP
%%Page: 17 17
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
/Times-Bold@0 SF(gnu_errfmt)144 84 Q F0(If set, shell error messages ar\
e written in the standard GNU error message format.)184 96 Q F1
(histappend)144 108 Q F0 .383
(If set, the history list is appended to the \214le named by the v)184
120 R .384(alue of the)-.25 F F1(HISTFILE)2.884 E F0 -.25(va)2.884 G
(ri-).25 E(able when the shell e)184 132 Q(xits, rather than o)-.15 E
-.15(ve)-.15 G(rwriting the \214le.).15 E F1(histr)144 144 Q(eedit)-.18
E F0 .576(If set, and)184 156 R F1 -.18(re)3.076 G(adline).18 E F0 .575
(is being used, a user is gi)3.076 F -.15(ve)-.25 G 3.075(nt).15 G .575
(he opportunity to re-edit a f)-3.075 F .575(ailed his-)-.1 F
(tory substitution.)184 168 Q F1(histv)144 180 Q(erify)-.1 E F0 .402
(If set, and)184 192 R F1 -.18(re)2.903 G(adline).18 E F0 .403
(is being used, the results of history substitution are not immediately)
2.903 F .662(passed to the shell parser)184 204 R 5.662(.I)-.55 G .661
(nstead, the resulting line is loaded into the)-5.662 F F1 -.18(re)3.161
G(adline).18 E F0(editing)3.161 E -.2(bu)184 216 S -.25(ff).2 G(er).25 E
2.5(,a)-.4 G(llo)-2.5 E(wing further modi\214cation.)-.25 E F1
(hostcomplete)144 228 Q F0 1.181(If set, and)184 240 R F1 -.18(re)3.681
G(adline).18 E F0 1.181(is being used,)3.681 F F1(bash)3.682 E F0 1.182
(will attempt to perform hostname completion)3.682 F 1.381(when a w)184
252 R 1.381(ord containing a)-.1 F F1(@)3.881 E F0 1.381
(is being completed \(see)3.881 F F1(Completing)3.88 E F0(under)3.88 E
/F2 9/Times-Bold@0 SF(READLINE)3.88 E F0(abo)184 264 Q -.15(ve)-.15 G
2.5(\). This).15 F(is enabled by def)2.5 E(ault.)-.1 E F1(huponexit)144
276 Q F0(If set,)184 288 Q F1(bash)2.5 E F0(will send)2.5 E F2(SIGHUP)
2.5 E F0(to all jobs when an interacti)2.25 E .3 -.15(ve l)-.25 H
(ogin shell e).15 E(xits.)-.15 E F1(interacti)144 300 Q -.1(ve)-.1 G
(_comments).1 E F0 .33(If set, allo)184 312 R 2.83(waw)-.25 G .33
(ord be)-2.93 F .33(ginning with)-.15 F F1(#)2.83 E F0 .33
(to cause that w)2.83 F .33(ord and all remaining characters on)-.1 F
.967(that line to be ignored in an interacti)184 324 R 1.267 -.15(ve s)
-.25 H .967(hell \(see).15 F F2(COMMENTS)3.467 E F0(abo)3.217 E -.15(ve)
-.15 G 3.467(\). This).15 F .967(option is)3.467 F(enabled by def)184
336 Q(ault.)-.1 E F1(lithist)144 348 Q F0 .654(If set, and the)15.55 F
F1(cmdhist)3.154 E F0 .654
(option is enabled, multi-line commands are sa)3.154 F -.15(ve)-.2 G
3.155(dt).15 G 3.155(ot)-3.155 G .655(he history)-3.155 F
(with embedded ne)184 360 Q
(wlines rather than using semicolon separators where possible.)-.25 E F1
(login_shell)144 372 Q F0 .486
(The shell sets this option if it is started as a login shell \(see)184
384 R F2(INV)2.986 E(OCA)-.405 E(TION)-.855 E F0(abo)2.736 E -.15(ve)
-.15 G 2.986(\). The).15 F -.25(va)184 396 S(lue may not be changed.).25
E F1(mailwar)144 408 Q(n)-.15 E F0 .814(If set, and a \214le that)184
420 R F1(bash)3.314 E F0 .815
(is checking for mail has been accessed since the last time it)3.314 F
-.1(wa)184 432 S 2.5(sc).1 G(heck)-2.5 E(ed, the message `)-.1 E
(`The mail in)-.74 E/F3 10/Times-Italic@0 SF(mail\214le)2.5 E F0
(has been read')2.5 E 2.5('i)-.74 G 2.5(sd)-2.5 G(isplayed.)-2.5 E F1
(no_empty_cmd_completion)144 444 Q F0 .146(If set, and)184 456 R F1 -.18
(re)2.646 G(adline).18 E F0 .146(is being used,)2.646 F F1(bash)2.646 E
F0 .145(will not attempt to search the)2.646 F F1 -.74(PA)2.645 G(TH)
-.21 E F0 .145(for possible)2.645 F
(completions when completion is attempted on an empty line.)184 468 Q F1
(nocaseglob)144 480 Q F0 .436(If set,)184 492 R F1(bash)2.936 E F0 .436
(matches \214lenames in a case\255insensiti)2.936 F .737 -.15(ve f)-.25
H .437(ashion when performing pathname).05 F -.15(ex)184 504 S
(pansion \(see).15 E F1 -.1(Pa)2.5 G(thname Expansion).1 E F0(abo)2.5 E
-.15(ve)-.15 G(\).).15 E F1(nocasematch)144 516 Q F0 1.194(If set,)184
528 R F1(bash)3.694 E F0 1.194(matches patterns in a case\255insensiti)
3.694 F 1.493 -.15(ve f)-.25 H 1.193(ashion when performing matching).05
F(while e)184 540 Q -.15(xe)-.15 G(cuting).15 E F1(case)2.5 E F0(or)2.5
E F1([[)2.5 E F0(conditional commands.)2.5 E F1(nullglob)144 552 Q F0
.854(If set,)184 564 R F1(bash)3.354 E F0(allo)3.354 E .855
(ws patterns which match no \214les \(see)-.25 F F1 -.1(Pa)3.355 G .855
(thname Expansion).1 F F0(abo)3.355 E -.15(ve)-.15 G 3.355(\)t).15 G(o)
-3.355 E -.15(ex)184 576 S(pand to a null string, rather than themselv)
.15 E(es.)-.15 E F1(pr)144 588 Q(ogcomp)-.18 E F0 .677
(If set, the programmable completion f)184 600 R .677(acilities \(see)
-.1 F F1(Pr)3.176 E .676(ogrammable Completion)-.18 F F0(abo)3.176 E
-.15(ve)-.15 G(\)).15 E(are enabled.)184 612 Q
(This option is enabled by def)5 E(ault.)-.1 E F1(pr)144 624 Q(omptv)
-.18 E(ars)-.1 E F0 1.447(If set, prompt strings under)184 636 R 1.448
(go parameter e)-.18 F 1.448(xpansion, command substitution, arithmetic)
-.15 F -.15(ex)184 648 S .171(pansion, and quote remo).15 F -.25(va)-.15
G 2.67(la).25 G .17(fter being e)-2.67 F .17(xpanded as described in)
-.15 F F2(PR)2.67 E(OMPTING)-.27 E F0(abo)2.42 E -.15(ve)-.15 G(.).15 E
(This option is enabled by def)184 660 Q(ault.)-.1 E F1 -.18(re)144 672
S(stricted_shell).18 E F0 1.069
(The shell sets this option if it is started in restricted mode \(see)
184 684 R F2 1.069(RESTRICTED SHELL)3.569 F F0(belo)184 696 Q 4.178
(w\). The)-.25 F -.25(va)4.178 G 1.678(lue may not be changed.).25 F
1.678(This is not reset when the startup \214les are)6.678 F -.15(exe)
184 708 S(cuted, allo).15 E(wing the startup \214les to disco)-.25 E
-.15(ve)-.15 G 2.5(rw).15 G(hether or not a shell is restricted.)-2.5 E
(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(17)198.725 E 0 Cg EP
%%Page: 18 18
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
/Times-Bold@0 SF(shift_v)144 84 Q(erbose)-.1 E F0 .501(If set, the)184
96 R F1(shift)3.001 E F0 -.2(bu)3.001 G .501
(iltin prints an error message when the shift count e).2 F .502
(xceeds the number)-.15 F(of positional parameters.)184 108 Q F1(sour)
144 120 Q(cepath)-.18 E F0 .771(If set, the)184 132 R F1(sour)3.271 E
(ce)-.18 E F0(\()3.271 E F1(.)A F0 3.271(\)b)C .771(uiltin uses the v)
-3.471 F .771(alue of)-.25 F/F2 9/Times-Bold@0 SF -.666(PA)3.27 G(TH)
-.189 E F0 .77(to \214nd the directory containing the)3.02 F
(\214le supplied as an ar)184 144 Q 2.5(gument. This)-.18 F
(option is enabled by def)2.5 E(ault.)-.1 E F1(xpg_echo)144 156 Q F0
(If set, the)184 168 Q F1(echo)2.5 E F0 -.2(bu)2.5 G(iltin e).2 E
(xpands backslash-escape sequences by def)-.15 E(ault.)-.1 E F1(suspend)
108 180 Q F0([)2.5 E F1<ad66>A F0(])A 1.001(Suspend the e)144 192 R -.15
(xe)-.15 G 1.001(cution of this shell until it recei).15 F -.15(ve)-.25
G 3.501(sa).15 G F2(SIGCONT)A F0 3.502(signal. A)3.252 F 1.002
(login shell cannot be)3.502 F .023(suspended; the)144 204 R F1<ad66>
2.523 E F0 .023(option can be used to o)2.523 F -.15(ve)-.15 G .022
(rride this and force the suspension.).15 F .022(The return status is)
5.022 F 2.5(0u)144 216 S(nless the shell is a login shell and)-2.5 E F1
<ad66>2.5 E F0(is not supplied, or if job control is not enabled.)2.5 E
F1(test)108 228 Q/F3 10/Times-Italic@0 SF -.2(ex)2.5 G(pr).2 E F1([)108
240 Q F3 -.2(ex)2.5 G(pr).2 E F1(])2.5 E F0 1.15
(Return a status of 0 or 1 depending on the e)6.77 F -.25(va)-.25 G 1.15
(luation of the conditional e).25 F(xpression)-.15 E F3 -.2(ex)3.65 G
(pr).2 E F0 6.15(.E).73 G(ach)-6.15 E 1.188
(operator and operand must be a separate ar)144 252 R 3.688
(gument. Expressions)-.18 F 1.187(are composed of the primaries)3.688 F
1.889(described abo)144 264 R 2.189 -.15(ve u)-.15 H(nder).15 E F2
(CONDITION)4.389 E 1.889(AL EXPRESSIONS)-.18 F/F4 9/Times-Roman@0 SF(.)A
F1(test)6.389 E F0 1.89(does not accept an)4.389 F 4.39(yo)-.15 G 1.89
(ptions, nor)-4.39 F(does it accept and ignore an ar)144 276 Q
(gument of)-.18 E F1<adad>2.5 E F0(as signifying the end of options.)2.5
E .786(Expressions may be combined using the follo)144 294 R .785
(wing operators, listed in decreasing order of prece-)-.25 F 2.5
(dence. The)144 306 R -.25(eva)2.5 G
(luation depends on the number of ar).25 E(guments; see belo)-.18 E -.65
(w.)-.25 G F1(!)144 318 Q F3 -.2(ex)2.5 G(pr).2 E F0 -.35(Tr)12.6 G
(ue if).35 E F3 -.2(ex)2.5 G(pr).2 E F0(is f)3.23 E(alse.)-.1 E F1(\()
144 330 Q F3 -.2(ex)2.5 G(pr).2 E F1(\))2.5 E F0 .26(Returns the v)6.77
F .26(alue of)-.25 F F3 -.2(ex)2.76 G(pr).2 E F0 5.26(.T)C .26
(his may be used to o)-5.26 F -.15(ve)-.15 G .26
(rride the normal precedence of opera-).15 F(tors.)180 342 Q F3 -.2(ex)
144 354 S(pr1).2 E F0<ad>2.5 E F1(a)A F3 -.2(ex)2.5 G(pr2).2 E F0 -.35
(Tr)180 366 S(ue if both).35 E F3 -.2(ex)2.5 G(pr1).2 E F0(and)2.5 E F3
-.2(ex)2.5 G(pr2).2 E F0(are true.)2.52 E F3 -.2(ex)144 378 S(pr1).2 E
F0<ad>2.5 E F1(o)A F3 -.2(ex)2.5 G(pr2).2 E F0 -.35(Tr)180 390 S
(ue if either).35 E F3 -.2(ex)2.5 G(pr1).2 E F0(or)2.5 E F3 -.2(ex)2.5 G
(pr2).2 E F0(is true.)2.52 E F1(test)144 406.8 Q F0(and)2.5 E F1([)2.5 E
F0 -.25(eva)2.5 G(luate conditional e).25 E
(xpressions using a set of rules based on the number of ar)-.15 E
(guments.)-.18 E 2.5(0a)144 424.8 S -.18(rg)-2.5 G(uments).18 E(The e)
180 436.8 Q(xpression is f)-.15 E(alse.)-.1 E 2.5(1a)144 448.8 S -.18
(rg)-2.5 G(ument).18 E(The e)180 460.8 Q
(xpression is true if and only if the ar)-.15 E(gument is not null.)-.18
E 2.5(2a)144 472.8 S -.18(rg)-2.5 G(uments).18 E .37(If the \214rst ar)
180 484.8 R .37(gument is)-.18 F F1(!)2.87 E F0 2.87(,t)C .37(he e)-2.87
F .37(xpression is true if and only if the second ar)-.15 F .37
(gument is null.)-.18 F .379(If the \214rst ar)180 496.8 R .38
(gument is one of the unary conditional operators listed abo)-.18 F .68
-.15(ve u)-.15 H(nder).15 E F2(CONDI-)2.88 E(TION)180 508.8 Q .553
(AL EXPRESSIONS)-.18 F F4(,)A F0 .552(the e)2.802 F .552
(xpression is true if the unary test is true.)-.15 F .552
(If the \214rst ar)5.552 F(gu-)-.18 E(ment is not a v)180 520.8 Q
(alid unary conditional operator)-.25 E 2.5(,t)-.4 G(he e)-2.5 E
(xpression is f)-.15 E(alse.)-.1 E 2.5(3a)144 532.8 S -.18(rg)-2.5 G
(uments).18 E .023(If the second ar)180 544.8 R .023
(gument is one of the binary conditional operators listed abo)-.18 F
.324 -.15(ve u)-.15 H(nder).15 E F2(CON-)2.524 E(DITION)180 556.8 Q
1.478(AL EXPRESSIONS)-.18 F F4(,)A F0 1.477(the result of the e)3.727 F
1.477(xpression is the result of the binary test)-.15 F .513
(using the \214rst and third ar)180 568.8 R .513(guments as operands.)
-.18 F(The)5.513 E F1<ad61>3.013 E F0(and)3.013 E F1<ad6f>3.013 E F0
.513(operators are considered)3.013 F .972
(binary operators when there are three ar)180 580.8 R 3.472(guments. If)
-.18 F .972(the \214rst ar)3.472 F .972(gument is)-.18 F F1(!)3.472 E F0
3.472(,t)C .972(he v)-3.472 F .972(alue is)-.25 F .883(the ne)180 592.8
R -.05(ga)-.15 G .883(tion of the tw).05 F(o-ar)-.1 E .884
(gument test using the second and third ar)-.18 F 3.384(guments. If)-.18
F .884(the \214rst)3.384 F(ar)180 604.8 Q .875(gument is e)-.18 F
(xactly)-.15 E F1(\()3.375 E F0 .875(and the third ar)3.375 F .875
(gument is e)-.18 F(xactly)-.15 E F1(\))3.375 E F0 3.374(,t)C .874
(he result is the one-ar)-3.374 F(gument)-.18 E(test of the second ar)
180 616.8 Q 2.5(gument. Otherwise,)-.18 F(the e)2.5 E(xpression is f)
-.15 E(alse.)-.1 E 2.5(4a)144 628.8 S -.18(rg)-2.5 G(uments).18 E .384
(If the \214rst ar)180 640.8 R .384(gument is)-.18 F F1(!)2.884 E F0
2.885(,t)C .385(he result is the ne)-2.885 F -.05(ga)-.15 G .385
(tion of the three-ar).05 F .385(gument e)-.18 F .385(xpression com-)
-.15 F 1.648(posed of the remaining ar)180 652.8 R 4.147
(guments. Otherwise,)-.18 F 1.647(the e)4.147 F 1.647
(xpression is parsed and e)-.15 F -.25(va)-.25 G(luated).25 E
(according to precedence using the rules listed abo)180 664.8 Q -.15(ve)
-.15 G(.).15 E 2.5(5o)144 676.8 S 2.5(rm)-2.5 G(ore ar)-2.5 E(guments)
-.18 E 1.635(The e)180 688.8 R 1.635(xpression is parsed and e)-.15 F
-.25(va)-.25 G 1.635
(luated according to precedence using the rules listed).25 F(abo)180
700.8 Q -.15(ve)-.15 G(.).15 E F1(times)108 717.6 Q F0 1.229(Print the \
accumulated user and system times for the shell and for processes run f\
rom the shell.)13.23 F(The return status is 0.)144 729.6 Q(GNU Bash-4.0)
72 768 Q(2004 Apr 20)148.735 E(18)198.725 E 0 Cg EP
%%Page: 19 19
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
/Times-Bold@0 SF(trap)108 84 Q F0([)2.5 E F1(\255lp)A F0 2.5(][)C([)-2.5
E/F2 10/Times-Italic@0 SF(ar)A(g)-.37 E F0(])A F2(sigspec)2.5 E F0(...])
2.5 E .702(The command)144 96 R F2(ar)3.532 E(g)-.37 E F0 .702
(is to be read and e)3.422 F -.15(xe)-.15 G .702
(cuted when the shell recei).15 F -.15(ve)-.25 G 3.203(ss).15 G
(ignal\(s\))-3.203 E F2(sigspec)3.203 E F0 5.703(.I).31 G(f)-5.703 E F2
(ar)3.533 E(g)-.37 E F0(is)3.423 E .609(absent \(and there is a single)
144 108 R F2(sigspec)3.108 E F0 3.108(\)o)C(r)-3.108 E F1<ad>3.108 E F0
3.108(,e)C .608
(ach speci\214ed signal is reset to its original disposition)-3.108 F
.658(\(the v)144 120 R .658(alue it had upon entrance to the shell\).)
-.25 F(If)5.658 E F2(ar)3.488 E(g)-.37 E F0 .659
(is the null string the signal speci\214ed by each)3.378 F F2(sigspec)
144.34 132 Q F0 .581(is ignored by the shell and by the commands it in)
3.391 F -.2(vo)-.4 G -.1(ke).2 G 3.08(s. If).1 F F2(ar)3.41 E(g)-.37 E
F0 .58(is not present and)3.3 F F1<ad70>3.08 E F0(has)3.08 E 1.214
(been supplied, then the trap commands associated with each)144 144 R F2
(sigspec)4.054 E F0 1.215(are displayed.)4.024 F 1.215(If no ar)6.215 F
(gu-)-.18 E .86(ments are supplied or if only)144 156 R F1<ad70>3.36 E
F0 .86(is gi)3.36 F -.15(ve)-.25 G(n,).15 E F1(trap)3.36 E F0 .86
(prints the list of commands associated with each)3.36 F 2.83
(signal. The)144 168 R F1<ad6c>2.83 E F0 .33(option causes the shell to\
 print a list of signal names and their corresponding num-)2.83 F 4.311
(bers. Each)144 180 R F2(sigspec)4.651 E F0 1.811
(is either a signal name de\214ned in <)4.621 F F2(signal.h)A F0 1.81
(>, or a signal number)B 6.81(.S)-.55 G(ignal)-6.81 E .745
(names are case insensiti)144 192 R 1.045 -.15(ve a)-.25 H .745
(nd the SIG pre\214x is optional.).15 F .745(If a)5.745 F F2(sigspec)
3.585 E F0(is)3.555 E/F3 9/Times-Bold@0 SF(EXIT)3.245 E F0 .745
(\(0\) the command)2.995 F F2(ar)144.33 204 Q(g)-.37 E F0 1.63(is e)4.35
F -.15(xe)-.15 G 1.63(cuted on e).15 F 1.63(xit from the shell.)-.15 F
1.63(If a)6.63 F F2(sigspec)4.47 E F0(is)4.44 E F3(DEB)4.13 E(UG)-.09 E
/F4 9/Times-Roman@0 SF(,)A F0 1.629(the command)3.88 F F2(ar)4.459 E(g)
-.37 E F0 1.629(is e)4.349 F -.15(xe)-.15 G(cuted).15 E 1.206(before e)
144 216 R -.15(ve)-.25 G(ry).15 E F2 1.206(simple command)3.706 F F0(,)A
F2(for)3.706 E F0(command,)3.706 E F2(case)3.706 E F0(command,)3.706 E
F2(select)3.707 E F0 1.207(command, e)3.707 F -.15(ve)-.25 G 1.207
(ry arithmetic).15 F F2(for)144 228 Q F0 .412
(command, and before the \214rst command e)2.913 F -.15(xe)-.15 G .412
(cutes in a shell function \(see).15 F F3 .412(SHELL GRAMMAR)2.912 F F0
(abo)144 240 Q -.15(ve)-.15 G 2.665(\). Refer).15 F .166
(to the description of the)2.665 F F1(extdeb)2.666 E(ug)-.2 E F0 .166
(option to the)2.666 F F1(shopt)2.666 E F0 -.2(bu)2.666 G .166
(iltin for details of its ef).2 F(fect)-.25 E .509(on the)144 252 R F1
(DEB)3.009 E(UG)-.1 E F0 3.009(trap. If)3.009 F(a)3.009 E F2(sigspec)
3.348 E F0(is)3.318 E F3(ERR)3.008 E F4(,)A F0 .508(the command)2.758 F
F2(ar)3.338 E(g)-.37 E F0 .508(is e)3.228 F -.15(xe)-.15 G .508
(cuted whene).15 F -.15(ve)-.25 G 3.008(ras).15 G .508(imple com-)-3.008
F 2.506(mand has a non\255zero e)144 264 R 2.506
(xit status, subject to the follo)-.15 F 2.506(wing conditions.)-.25 F
(The)7.506 E F3(ERR)5.006 E F0 2.506(trap is not)4.756 F -.15(exe)144
276 S .105(cuted if the f).15 F .105
(ailed command is part of the command list immediately follo)-.1 F .105
(wing a)-.25 F F1(while)2.605 E F0(or)2.605 E F1(until)2.605 E F0 -.1
(ke)144 288 S(yw)-.05 E .549(ord, part of the test in an)-.1 F F2(if)
3.059 E F0 .549(statement, part of a command e)5.009 F -.15(xe)-.15 G
.549(cuted in a).15 F F1(&&)3.049 E F0(or)3.049 E/F5 10/Symbol SF<efef>
3.049 E F0 .549(list, or if)3.049 F .578(the command')144 300 R 3.078
(sr)-.55 G .578(eturn v)-3.078 F .578(alue is being in)-.25 F -.15(ve)
-.4 G .578(rted via).15 F F1(!)3.078 E F0 5.577(.T)C .577
(hese are the same conditions obe)-5.577 F .577(yed by the)-.15 F F1
(err)144 312 Q(exit)-.18 E F0 3.03(option. If)3.03 F(a)3.03 E F2
(sigspec)3.37 E F0(is)3.341 E F3(RETURN)3.031 E F4(,)A F0 .531
(the command)2.781 F F2(ar)3.361 E(g)-.37 E F0 .531(is e)3.251 F -.15
(xe)-.15 G .531(cuted each time a shell function).15 F .317
(or a script e)144 324 R -.15(xe)-.15 G .317(cuted with the).15 F F1(.)
2.817 E F0(or)2.817 E F1(sour)2.817 E(ce)-.18 E F0 -.2(bu)2.817 G .317
(iltins \214nishes e).2 F -.15(xe)-.15 G 2.817(cuting. Signals).15 F
.316(ignored upon entry to)2.817 F .787
(the shell cannot be trapped or reset.)144 336 R -.35(Tr)5.787 G .787
(apped signals that are not being ignored are reset to their).35 F 1.1
(original v)144 348 R 1.1(alues in a child process when it is created.)
-.25 F 1.1(The return status is f)6.1 F 1.1(alse if an)-.1 F(y)-.15 E F2
(sigspec)3.94 E F0(is)3.91 E(in)144 360 Q -.25(va)-.4 G(lid; otherwise)
.25 E F1(trap)2.5 E F0(returns true.)2.5 E F1(type)108 376.8 Q F0([)2.5
E F1(\255aftpP)A F0(])A F2(name)2.5 E F0([)2.5 E F2(name)A F0(...])2.5 E
-.4(Wi)144 388.8 S .173(th no options, indicate ho).4 F 2.673(we)-.25 G
(ach)-2.673 E F2(name)3.033 E F0 -.1(wo)2.853 G .174
(uld be interpreted if used as a command name.).1 F .174(If the)5.174 F
F1<ad74>144 400.8 Q F0 .843(option is used,)3.343 F F1(type)3.343 E F0
.843(prints a string which is one of)3.343 F F2(alias)3.343 E F0(,).27 E
F2 -.1(ke)3.343 G(ywor)-.2 E(d)-.37 E F0(,).77 E F2(function)3.343 E F0
(,).24 E F2 -.2(bu)3.342 G(iltin).2 E F0 3.342(,o).24 G(r)-3.342 E F2
(\214le)5.252 E F0(if)3.522 E F2(name)144.36 412.8 Q F0 .086
(is an alias, shell reserv)2.766 F .086(ed w)-.15 F .086
(ord, function, b)-.1 F .087(uiltin, or disk \214le, respecti)-.2 F -.15
(ve)-.25 G(ly).15 E 5.087(.I)-.65 G 2.587(ft)-5.087 G(he)-2.587 E F2
(name)2.947 E F0 .087(is not)2.767 F .119
(found, then nothing is printed, and an e)144 424.8 R .118
(xit status of f)-.15 F .118(alse is returned.)-.1 F .118(If the)5.118 F
F1<ad70>2.618 E F0 .118(option is used,)2.618 F F1(type)2.618 E F0 .855
(either returns the name of the disk \214le that w)144 436.8 R .855
(ould be e)-.1 F -.15(xe)-.15 G .855(cuted if).15 F F2(name)3.715 E F0
.855(were speci\214ed as a com-)3.535 F .641(mand name, or nothing if)
144 448.8 R/F6 10/Courier@0 SF .641(type -t name)3.141 F F0 -.1(wo)3.141
G .641(uld not return).1 F F2(\214le)3.14 E F0 5.64(.T).18 G(he)-5.64 E
F1<ad50>3.14 E F0 .64(option forces a)3.14 F F3 -.666(PA)3.14 G(TH)-.189
E F0 .112(search for each)144 460.8 R F2(name)2.612 E F0 2.612(,e)C -.15
(ve)-2.862 G 2.613(ni).15 G(f)-2.613 E F6 .113(type -t name)2.613 F F0
-.1(wo)2.613 G .113(uld not return).1 F F2(\214le)2.613 E F0 5.113(.I)
.18 G 2.613(fac)-5.113 G .113(ommand is hashed,)-2.613 F F1<ad70>2.613 E
F0(and)144 472.8 Q F1<ad50>2.945 E F0 .445(print the hashed v)2.945 F
.444(alue, not necessarily the \214le that appears \214rst in)-.25 F F3
-.666(PA)2.944 G(TH)-.189 E F4(.)A F0 .444(If the)4.944 F F1<ad61>2.944
E F0(option)2.944 E .265(is used,)144 484.8 R F1(type)2.765 E F0 .265
(prints all of the places that contain an e)2.765 F -.15(xe)-.15 G .265
(cutable named).15 F F2(name)2.765 E F0 5.265(.T).18 G .265
(his includes aliases)-5.265 F .427(and functions, if and only if the)
144 496.8 R F1<ad70>2.926 E F0 .426(option is not also used.)2.926 F
.426(The table of hashed commands is not)5.426 F .548
(consulted when using)144 508.8 R F1<ad61>3.048 E F0 5.548(.T)C(he)
-5.548 E F1<ad66>3.048 E F0 .549
(option suppresses shell function lookup, as with the)3.048 F F1
(command)3.049 E F0 -.2(bu)144 520.8 S(iltin.).2 E F1(type)5 E F0
(returns true if all of the ar)2.5 E(guments are found, f)-.18 E
(alse if an)-.1 E 2.5(ya)-.15 G(re not found.)-2.5 E F1(ulimit)108 537.6
Q F0([)2.5 E F1(\255HST)A(abcde\214lmnpqrstuvx)-.92 E F0([)2.5 E F2
(limit)A F0(]])A(Pro)144 549.6 Q .244(vides control o)-.15 F -.15(ve)
-.15 G 2.744(rt).15 G .244(he resources a)-2.744 F -.25(va)-.2 G .244
(ilable to the shell and to processes started by it, on systems).25 F
.943(that allo)144 561.6 R 3.443(ws)-.25 G .943(uch control.)-3.443 F
(The)5.943 E F1<ad48>3.443 E F0(and)3.443 E F1<ad53>3.444 E F0 .944
(options specify that the hard or soft limit is set for the)3.444 F(gi)
144 573.6 Q -.15(ve)-.25 G 2.709(nr).15 G 2.709(esource. A)-2.709 F .208
(hard limit cannot be increased by a non-root user once it is set; a so\
ft limit may)2.709 F .425(be increased up to the v)144 585.6 R .425
(alue of the hard limit.)-.25 F .426(If neither)5.425 F F1<ad48>2.926 E
F0(nor)2.926 E F1<ad53>2.926 E F0 .426
(is speci\214ed, both the soft and)2.926 F .139(hard limits are set.)144
597.6 R .139(The v)5.139 F .139(alue of)-.25 F F2(limit)2.729 E F0 .139
(can be a number in the unit speci\214ed for the resource or one)3.319 F
.741(of the special v)144 609.6 R(alues)-.25 E F1(hard)3.241 E F0(,)A F1
(soft)3.241 E F0 3.241(,o)C(r)-3.241 E F1(unlimited)3.241 E F0 3.241(,w)
C .741(hich stand for the current hard limit, the current)-3.241 F .78
(soft limit, and no limit, respecti)144 621.6 R -.15(ve)-.25 G(ly).15 E
5.78(.I)-.65 G(f)-5.78 E F2(limit)3.37 E F0 .78
(is omitted, the current v)3.96 F .78(alue of the soft limit of the)-.25
F .498(resource is printed, unless the)144 633.6 R F1<ad48>2.999 E F0
.499(option is gi)2.999 F -.15(ve)-.25 G 2.999(n. When).15 F .499
(more than one resource is speci\214ed, the)2.999 F
(limit name and unit are printed before the v)144 645.6 Q 2.5
(alue. Other)-.25 F(options are interpreted as follo)2.5 E(ws:)-.25 E F1
<ad61>144 657.6 Q F0(All current limits are reported)25.3 E F1<ad62>144
669.6 Q F0(The maximum sock)24.74 E(et b)-.1 E(uf)-.2 E(fer size)-.25 E
F1<ad63>144 681.6 Q F0(The maximum size of core \214les created)25.86 E
F1<ad64>144 693.6 Q F0(The maximum size of a process')24.74 E 2.5(sd)
-.55 G(ata se)-2.5 E(gment)-.15 E F1<ad65>144 705.6 Q F0
(The maximum scheduling priority \("nice"\))25.86 E F1<ad66>144 717.6 Q
F0(The maximum size of \214les written by the shell and its children)
26.97 E(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(19)198.725 E 0 Cg EP
%%Page: 20 20
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
/Times-Bold@0 SF<ad69>144 84 Q F0(The maximum number of pending signals)
27.52 E F1<ad6c>144 96 Q F0(The maximum size that may be lock)27.52 E
(ed into memory)-.1 E F1<ad6d>144 108 Q F0
(The maximum resident set size)21.97 E F1<ad6e>144 120 Q F0 .791(The ma\
ximum number of open \214le descriptors \(most systems do not allo)24.74
F 3.29(wt)-.25 G .79(his v)-3.29 F .79(alue to)-.25 F(be set\))180 132 Q
F1<ad70>144 144 Q F0
(The pipe size in 512-byte blocks \(this may not be set\))24.74 E F1
<ad71>144 156 Q F0(The maximum number of bytes in POSIX message queues)
24.74 E F1<ad72>144 168 Q F0(The maximum real-time scheduling priority)
25.86 E F1<ad73>144 180 Q F0(The maximum stack size)26.41 E F1<ad74>144
192 Q F0(The maximum amount of cpu time in seconds)26.97 E F1<ad75>144
204 Q F0(The maximum number of processes a)24.74 E -.25(va)-.2 G
(ilable to a single user).25 E F1<ad76>144 216 Q F0
(The maximum amount of virtual memory a)25.3 E -.25(va)-.2 G
(ilable to the shell).25 E F1<ad78>144 228 Q F0
(The maximum number of \214le locks)25.3 E F1<ad54>144 240 Q F0
(The maximum number of threads)23.63 E(If)144 256.8 Q/F2 10
/Times-Italic@0 SF(limit)2.933 E F0 .343(is gi)3.523 F -.15(ve)-.25 G
.343(n, it is the ne).15 F 2.843(wv)-.25 G .343
(alue of the speci\214ed resource \(the)-3.093 F F1<ad61>2.843 E F0 .343
(option is display only\).)2.843 F .343(If no)5.343 F .176(option is gi)
144 268.8 R -.15(ve)-.25 G .176(n, then).15 F F1<ad66>2.676 E F0 .175
(is assumed.)2.676 F -1.11(Va)5.175 G .175
(lues are in 1024-byte increments, e)1.11 F .175(xcept for)-.15 F F1
<ad74>2.675 E F0 2.675(,w)C .175(hich is in)-2.675 F(seconds,)144 280.8
Q F1<ad70>2.515 E F0 2.515(,w)C .015
(hich is in units of 512-byte blocks, and)-2.515 F F1<ad54>2.516 E F0(,)
A F1<ad62>2.516 E F0(,)A F1<ad6e>2.516 E F0 2.516(,a)C(nd)-2.516 E F1
<ad75>2.516 E F0 2.516(,w)C .016(hich are unscaled v)-2.516 F(al-)-.25 E
3.788(ues. The)144 292.8 R 1.287(return status is 0 unless an in)3.787 F
-.25(va)-.4 G 1.287(lid option or ar).25 F 1.287
(gument is supplied, or an error occurs)-.18 F(while setting a ne)144
304.8 Q 2.5(wl)-.25 G(imit.)-2.5 E F1(umask)108 321.6 Q F0([)2.5 E F1
<ad70>A F0 2.5(][)C F1<ad53>-2.5 E F0 2.5(][)C F2(mode)-2.5 E F0(])A .2
(The user \214le-creation mask is set to)144 333.6 R F2(mode)2.7 E F0
5.2(.I).18 G(f)-5.2 E F2(mode)3.08 E F0(be)2.88 E .2
(gins with a digit, it is interpreted as an octal)-.15 F .066(number; o\
therwise it is interpreted as a symbolic mode mask similar to that acce\
pted by)144 345.6 R F2 -.15(ch)2.566 G(mod).15 E F0(\(1\).).77 E(If)144
357.6 Q F2(mode)3.262 E F0 .382(is omitted, the current v)3.062 F .382
(alue of the mask is printed.)-.25 F(The)5.382 E F1<ad53>2.882 E F0 .382
(option causes the mask to be)2.882 F .547
(printed in symbolic form; the def)144 369.6 R .547
(ault output is an octal number)-.1 F 5.547(.I)-.55 G 3.047(ft)-5.547 G
(he)-3.047 E F1<ad70>3.047 E F0 .547(option is supplied, and)3.047 F F2
(mode)144.38 381.6 Q F0 .551
(is omitted, the output is in a form that may be reused as input.)3.231
F .552(The return status is 0 if the)5.552 F(mode w)144 393.6 Q
(as successfully changed or if no)-.1 E F2(mode)2.5 E F0(ar)2.5 E
(gument w)-.18 E(as supplied, and f)-.1 E(alse otherwise.)-.1 E F1
(unalias)108 410.4 Q F0<5bad>2.5 E F1(a)A F0 2.5(][)C F2(name)-2.5 E F0
(...])2.5 E(Remo)144 422.4 Q 1.955 -.15(ve e)-.15 H(ach).15 E F2(name)
4.155 E F0 1.655(from the list of de\214ned aliases.)4.155 F(If)6.655 E
F1<ad61>4.155 E F0 1.655(is supplied, all alias de\214nitions are)4.155
F(remo)144 434.4 Q -.15(ve)-.15 G 2.5(d. The).15 F(return v)2.5 E
(alue is true unless a supplied)-.25 E F2(name)2.86 E F0
(is not a de\214ned alias.)2.68 E F1(unset)108 451.2 Q F0<5bad>2.5 E F1
(fv)A F0 2.5(][)C F2(name)-2.5 E F0(...])2.5 E -.15(Fo)144 463.2 S 3.106
(re).15 G(ach)-3.106 E F2(name)3.106 E F0 3.106(,r).18 G(emo)-3.106 E
.906 -.15(ve t)-.15 H .606(he corresponding v).15 F .607
(ariable or function.)-.25 F .607(If no options are supplied, or the)
5.607 F F1<ad76>144 475.2 Q F0 .305(option is gi)2.805 F -.15(ve)-.25 G
.305(n, each).15 F F2(name)3.165 E F0 .305(refers to a shell v)2.985 F
2.805(ariable. Read-only)-.25 F -.25(va)2.805 G .304
(riables may not be unset.).25 F(If)5.304 E F1<ad66>144 487.2 Q F0 .459
(is speci\214ed, each)2.959 F F2(name)3.319 E F0 .459
(refers to a shell function, and the function de\214nition is remo)3.139
F -.15(ve)-.15 G 2.96(d. Each).15 F .903(unset v)144 499.2 R .903
(ariable or function is remo)-.25 F -.15(ve)-.15 G 3.402(df).15 G .902
(rom the en)-3.402 F .902(vironment passed to subsequent commands.)-.4 F
(If)5.902 E(an)144 511.2 Q 4.284(yo)-.15 G(f)-4.284 E/F3 9/Times-Bold@0
SF(RANDOM)4.284 E/F4 9/Times-Roman@0 SF(,)A F3(SECONDS)4.035 E F4(,)A F3
(LINENO)4.035 E F4(,)A F3(HISTCMD)4.035 E F4(,)A F3(FUNCN)4.035 E(AME)
-.18 E F4(,)A F3(GR)4.035 E(OUPS)-.27 E F4(,)A F0(or)4.035 E F3(DIRST)
4.285 E -.495(AC)-.81 G(K).495 E F0(are)4.035 E .329(unset, the)144
523.2 R 2.829(yl)-.15 G .328(ose their special properties, e)-2.829 F
-.15(ve)-.25 G 2.828(ni).15 G 2.828(ft)-2.828 G(he)-2.828 E 2.828(ya)
-.15 G .328(re subsequently reset.)-2.828 F .328(The e)5.328 F .328
(xit status is true)-.15 F(unless a)144 535.2 Q F2(name)2.86 E F0
(is readonly)2.68 E(.)-.65 E F1(wait)108 552 Q F0([)2.5 E F2 2.5(n.)C
(..)-2.5 E F0(])A -.8(Wa)144 564 S .288
(it for each speci\214ed process and return its termination status.).8 F
(Each)5.288 E F2(n)3.148 E F0 .288(may be a process ID or a)3.028 F .722
(job speci\214cation; if a job spec is gi)144 576 R -.15(ve)-.25 G .722
(n, all processes in that job').15 F 3.222(sp)-.55 G .722(ipeline are w)
-3.222 F .722(aited for)-.1 F 5.722(.I)-.55 G(f)-5.722 E F2(n)3.582 E F0
(is)3.462 E 1.265(not gi)144 588 R -.15(ve)-.25 G 1.265
(n, all currently acti).15 F 1.565 -.15(ve c)-.25 H 1.265
(hild processes are w).15 F 1.265(aited for)-.1 F 3.765(,a)-.4 G 1.266
(nd the return status is zero.)-3.765 F(If)6.266 E F2(n)4.126 E F0 .457
(speci\214es a non-e)144 600 R .457
(xistent process or job, the return status is 127.)-.15 F .457
(Otherwise, the return status is the)5.457 F -.15(ex)144 612 S
(it status of the last process or job w).15 E(aited for)-.1 E(.)-.55 E
/F5 10.95/Times-Bold@0 SF(SEE ALSO)72 628.8 Q F0(bash\(1\), sh\(1\))108
640.8 Q(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(20)198.725 E 0 Cg EP
%%Trailer
end
%%EOF