File: pycdlib-genisoimage.html

package info (click to toggle)
python-pycdlib 1.12.0%2Bds1-7
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 3,748 kB
  • sloc: python: 36,118; makefile: 63
file content (2647 lines) | stat: -rw-r--r-- 89,999 bytes parent folder | download | duplicates (2)
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
2556
2557
2558
2559
2560
2561
2562
2563
2564
2565
2566
2567
2568
2569
2570
2571
2572
2573
2574
2575
2576
2577
2578
2579
2580
2581
2582
2583
2584
2585
2586
2587
2588
2589
2590
2591
2592
2593
2594
2595
2596
2597
2598
2599
2600
2601
2602
2603
2604
2605
2606
2607
2608
2609
2610
2611
2612
2613
2614
2615
2616
2617
2618
2619
2620
2621
2622
2623
2624
2625
2626
2627
2628
2629
2630
2631
2632
2633
2634
2635
2636
2637
2638
2639
2640
2641
2642
2643
2644
2645
2646
2647
<!-- Creator     : groff version 1.22.4 -->
<!-- CreationDate: Tue Aug 10 21:51:38 2021 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
       p       { margin-top: 0; margin-bottom: 0; vertical-align: top }
       pre     { margin-top: 0; margin-bottom: 0; vertical-align: top }
       table   { margin-top: 0; margin-bottom: 0; vertical-align: top }
       h1      { text-align: center }
</style>
<title>PYCDLIB-GENISOIMAGE</title>

</head>
<body>

<h1 align="center">PYCDLIB-GENISOIMAGE</h1>

<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#OPTIONS">OPTIONS</a><br>
<a href="#HFS OPTIONS">HFS OPTIONS</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<a href="#AUTHOR">AUTHOR</a><br>

<hr>


<h2>NAME
<a name="NAME"></a>
</h2>



<p style="margin-left:11%; margin-top: 1em">pycdlib-genisoimage
- tool to master ISOs using pycdlib</p>

<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</h2>



<p style="margin-left:11%; margin-top: 1em"><b>pycdlib-genisoimage
[options] [-o filename] pathspec [pathspec ...]</b></p>

<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>



<p style="margin-left:11%; margin-top: 1em"><b>pycdlib-genisoimage</b>
is a pre-mastering program to generate ISO9660/Joliet/HFS
hybrid filesystems. It is meant to be 100% flag-compatible
with the original <b>genisoimage</b> program so that it can
be dropped into existing scripts with no changes. Please see
the man page for <b>genisoimage</b> for more detailed
explanation of the options to this program. There are a few
differences to note between this program and the original
<b>genisoimage.</b> First, not all of the options are
implemented in this program. This means that
<b>pycdlib-genisoimage</b> will silently ignore some flags;
for the most common usage of this program, this will not
matter. However, if you are trying to do something odd and
specific, it may not work. The flags that this applies to
are noted in the OPTIONS below. In some cases these flags
can be implemented with a bit of work, and in some cases the
flags can never be implemented due to the design of pycdlib.
If in doubt, please ask on
https://github.com/clalancette/pycdlib/issues. Second,
<b>pycdlib-genisoimage</b> does not output all of the same
messages to standard out/standard error that
<b>genisoimage</b> does. Any program that relies on parsing
the output of <b>genisoimage</b> will probably not work.
Third, <b>pycdlib-genisoimage</b> will not always generate
ISOs that are 100% the same as the <b>genisoimage</b>
counterparts. This is for a variety of reasons, ranging from
bug fixing to simple differences in implementations. In
almost all cases this does not matter, but please keep it in
mind when using this program instead of
<b>genisoimage.</b></p>

<h2>OPTIONS
<a name="OPTIONS"></a>
</h2>



<p style="margin-left:11%; margin-top: 1em"><b>&minus;abstract</b>
<i>file</i></p>

<p style="margin-left:22%;">Specifies the abstract
filename. There is space for 37 characters.</p>

<p style="margin-left:11%;"><b>&minus;A</b>
<i>application_id</i> <b><br>
&minus;appid</b> <i>application_id</i></p>

<p style="margin-left:22%;">Specifies a text string that
will be written into the volume header. This should describe
the application that will be on the disc. There is space for
128 characters.</p>


<p style="margin-left:11%;"><b>&minus;allow&minus;limited&minus;size</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) When processing files larger than 2GiB
which cannot be easily represented in ISO9660, add them with
a shrunk visible file size to ISO9660 and with the correct
visible file size to the UDF system. The result is an
inconsistent filesystem and users need to make sure that
they really use UDF rather than ISO9660 driver to read a
such disk. Implies enabling <b>&minus;udf.</b></p>


<p style="margin-left:11%;"><b>&minus;allow&minus;leading&minus;dots</b></p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">


<p><b>&minus;ldots</b></p></td>
<td width="2%"></td>
<td width="78%">


<p>(not supported by pycdlib-genisoimage) Allow ISO9660
filenames to begin with a period. Usually, a leading dot is
replaced with an underscore in order to maintain MS-DOS
compatibility.</p> </td></tr>
</table>

<p style="margin-left:22%;">This violates the ISO9660
standard, but it happens to work on many systems. Use with
caution.</p>


<p style="margin-left:11%;"><b>&minus;allow&minus;lowercase</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) This options allows lowercase
characters to appear in ISO9660 filenames. <br>
This violates the ISO9660 standard, but it happens to work
on some systems. Use with caution.</p>


<p style="margin-left:11%;"><b>&minus;allow&minus;multidot</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) This options allows more than one dot
to appear in ISO9660 filenames. A leading dot is not
affected by this option, it may be allowed separately using
<b>&minus;allow&minus;leading&minus;dots</b>. <br>
This violates the ISO9660 standard, but it happens to work
on many systems. Use with caution.</p>

<p style="margin-left:11%;"><b>&minus;biblio</b>
<i>file</i></p>

<p style="margin-left:22%;">Specifies the bibliographic
filename. There is space for 37 characters.</p>

<p style="margin-left:11%;"><b>&minus;cache&minus;inodes
<br>
&minus;no&minus;cache&minus;inodes</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Enable or disable caching inode and
device numbers to find hard links to files. If
<b>pycdlib-genisoimage</b> finds a hard link (a file with
multiple names), the file will also be hard-linked on the
CD, so the file contents only appear once. This helps to
save space. <b>&minus;cache&minus;inodes</b> is default on
Unix-like operating systems, but
<b>&minus;no&minus;cache&minus;inodes</b> is default on some
other systems such as Cygwin, because it is not safe to
assume that inode numbers are unique on those systems. (Some
versions of Cygwin create fake inode numbers using a weak
hashing algorithm, which may produce duplicates.) If two
files have the same inode number but are not hard links to
the same file, <b>pycdlib-genisoimage
&minus;cache&minus;inodes</b> will not behave correctly.
<b>&minus;no&minus;cache&minus;inodes</b> is safe in all
situations, but in that case <b>pycdlib-genisoimage</b>
cannot detect hard links, so the resulting CD image may be
larger than necessary.</p>

<p style="margin-left:11%;"><b>&minus;alpha&minus;boot</b>
<i>alpha_boot_image</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specifies the path and filename of the
boot image to be used when making an Alpha/SRM bootable CD.
The pathname must be relative to the source path specified
to <b>pycdlib-genisoimage</b>.</p>


<p style="margin-left:11%;"><b>&minus;hppa&minus;bootloader</b>
<i>hppa_bootloader_image</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specifies the path and filename of the
boot image to be used when making an HPPA bootable CD. The
pathname must be relative to the source path specified to
<b>pycdlib-genisoimage</b>. Other options are required, at
the very least a kernel filename and a boot command
line.</p>


<p style="margin-left:11%;"><b>&minus;hppa&minus;cmdline</b>
<i>hppa_boot_command_line</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specifies the command line to be passed
to the HPPA boot loader when making a bootable CD. Separate
the parameters with spaces or commas. More options must be
passed to <b>pycdlib-genisoimage,</b> at the very least a
kernel filename and the boot loader filename.</p>


<p style="margin-left:11%;"><b>&minus;hppa&minus;kernel&minus;32</b>
<i>hppa_kernel_32</i> <b><br>
&minus;hppa&minus;kernel&minus;64</b>
<i>hppa_kernel_64</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specifies the path and filename of the
32-bit and/or 64-bit kernel images to be used when making an
HPPA bootable CD. The pathnames must be relative to the
source path specified to <b>pycdlib-genisoimage</b>. Other
options are required, at the very least the boot loader
filename and the boot command line.</p>


<p style="margin-left:11%;"><b>&minus;hppa&minus;ramdisk</b>
<i>hppa_ramdisk_image</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specifies the path and filename of the
ramdisk image to be used when making an HPPA bootable CD.
The pathname must be relative to the source path specified
to <b>pycdlib-genisoimage</b>. This parameter is optional.
Other options are required, at the very least a kernel
filename and the boot command line.</p>

<p style="margin-left:11%;"><b>&minus;mips&minus;boot</b>
<i>mips_boot_image</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specifies the path and filename of the
boot image to be used when making an SGI/big-endian MIPS
bootable CD. The pathname must be relative to the source
path specified to <b>pycdlib-genisoimage</b>. This option
may be specified several times, to store up to 15 boot
images.</p>


<p style="margin-left:11%;"><b>&minus;mipsel&minus;boot</b>
<i>mipsel_boot_image</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specifies the path and filename of the
boot image to be used when making an DEC/little-endian MIPS
bootable CD. The pathname must be relative to the source
path specified to <b>pycdlib-genisoimage</b>.</p>

<p style="margin-left:11%;"><b>&minus;B</b>
<i>img_sun4,img_sun4c,img_sun4m,img_sun4d,img_sun4e</i>
<b><br>
&minus;sparc&minus;boot</b>
<i>img_sun4,img_sun4c,img_sun4m,img_sun4d,img_sun4e</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specifies a comma-separated list of
boot images that are needed to make a bootable CD for SPARC
systems. Partition 0 is used for the ISO9660 image, the
first image file is mapped to partition 1. The
comma-separated list may have up to 7 fields, including
empty fields. This option is required to make a bootable CD
for Sun SPARC systems. If <b>&minus;B</b> or
<b>&minus;sparc&minus;boot</b> has been specified, the first
sector of the resulting image will contain a Sun disk label.
This disk label specifies slice 0 for the ISO9660 image and
slices 1 to 7 for the boot images that have been specified
with this option. Byte offsets 512 to 8191 within each of
the additional boot images must contain a primary boot that
works for the appropriate SPARC architecture. The rest of
each of the images usually contains a UFS filesystem used
for the primary kernel boot stage.</p>

<p style="margin-left:22%; margin-top: 1em">The implemented
boot method is the one found with SunOS 4.x and SunOS 5.x.
However, it does not depend on SunOS internals but only on
properties of the Open Boot prom, so it should be usable for
any OS for SPARC systems. For more information also see the
<b>NOTES</b> section below.</p>

<p style="margin-left:22%; margin-top: 1em">If the special
filename <b>...</b> is used, the actual and all following
boot partitions are mapped to the previous partition. If
<b>pycdlib-genisoimage</b> is called with <b>&minus;G</b>
<i>image</i> <b>&minus;B</b> <i>...</i> all boot partitions
are mapped to the partition that contains the ISO9660
filesystem image and the generic boot image that is located
in the first 16 sectors of the disc is used for all
architectures.</p>

<p style="margin-left:11%;"><b>&minus;G</b>
<i>generic_boot_image</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specifies the path and filename of the
generic boot image to be used when making a generic bootable
CD. The boot image will be placed on the first 16 sectors of
the CD, before the ISO9660 primary volume descriptor. If
this option is used together with
<b>&minus;sparc&minus;boot</b>, the Sun disk label will
overlay the first 512 bytes of the generic boot image.</p>

<p style="margin-left:11%;"><b>&minus;b</b>
<i>eltorito_boot_image</i> <b><br>
&minus;eltorito&minus;boot</b>
<i>eltorito_boot_image</i></p>

<p style="margin-left:22%;">Specifies the path and filename
of the boot image to be used when making an El Torito
bootable CD for x86 PCs. The pathname must be relative to
the source path specified to <b>pycdlib-genisoimage</b>.
This option is required to make an El Torito bootable CD.
The boot image must be exactly 1200 kB, 1440 kB or 2880 kB,
and <b>pycdlib-genisoimage</b> will use this size when
creating the output ISO9660 filesystem. The PC BIOS will use
the image to emulate a floppy disk, so the first 512-byte
sector should contain PC boot code. This will work, for
example, if the boot image is a LILO-based boot floppy.</p>

<p style="margin-left:22%; margin-top: 1em">If the boot
image is not an image of a floppy, you need to add either
<b>&minus;hard&minus;disk&minus;boot</b> or
<b>&minus;no&minus;emul&minus;boot</b>. If the system should
not boot off the emulated disk, use
<b>&minus;no&minus;boot</b>.</p>

<p style="margin-left:22%; margin-top: 1em">If
<b>&minus;sort</b> has not been specified, the boot images
are sorted with low priority (+2) to the beginning of the
medium. If you don&rsquo;t like this, you need to specify a
sort weight of 0 for the boot images.</p>


<p style="margin-left:11%;"><b>&minus;eltorito&minus;alt&minus;boot</b></p>

<p style="margin-left:22%;">Start with a new set of El
Torito boot parameters. Up to 63 El Torito boot entries may
be stored on a single CD.</p>


<p style="margin-left:11%;"><b>&minus;hard&minus;disk&minus;boot</b></p>

<p style="margin-left:22%;">Specifies that the boot image
used to create El Torito bootable CDs is a hard disk image.
The image must begin with a master boot record that contains
a single partition.</p>


<p style="margin-left:11%;"><b>&minus;eltorito&minus;platform</b>
<i>id</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Set the &quot;El Torito&quot; platform
id for a boot record or a section of boot records. The
<i>id</i> parameter may be either:</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="22%"></td>
<td width="4%">


<p><b>x86</b></p></td>
<td width="6%"></td>
<td width="68%">


<p>This is the default <i>platform id</i> value and
specifies entries for the PC platform. If no
<b>&minus;eltorito&minus;platform</b> option appears before
the first <b>&minus;eltorito&minus;boot</b> option, the
default boot entry becomes an entry for the x86 PC
platform.</p> </td></tr>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="4%">


<p><b>PPC</b></p></td>
<td width="6%"></td>
<td width="68%">


<p>Boot entries for the Power PC platform.</p></td></tr>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="4%">


<p><b>Mac</b></p></td>
<td width="6%"></td>
<td width="68%">


<p>Boot entries for the Apple Mac platform.</p></td></tr>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="4%">


<p><b>efi</b></p></td>
<td width="6%"></td>
<td width="68%">


<p>Boot entries for EFI based PCs.</p></td></tr>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="4%">


<p><b>#</b></p></td>
<td width="6%"></td>
<td width="68%">


<p>A numeric value specifying any platform id.</p></td></tr>
</table>

<p style="margin-left:22%; margin-top: 1em">If the option
<b>&minus;eltorito&minus;platform</b> appears before the
first <b>&minus;eltorito&minus;boot</b> option, it sets the
<i>platform id</i> for the default boot entry.</p>

<p style="margin-left:22%; margin-top: 1em">If the option
<b>&minus;eltorito&minus;platform</b> appears after an
<b>&minus;eltorito&minus;boot</b> option and sets the
<i>platform id</i> to a value different from the previous
value, it starts a new set of boot entries.</p>

<p style="margin-left:22%; margin-top: 1em">The second boot
entry and any new <i>platform id</i> creates a new section
header and reduces the number of boot entries per CD by
one.</p>


<p style="margin-left:11%;"><b>&minus;ignore&minus;error</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Ignore errors.
<b>pycdlib-genisoimage</b> by default aborts on several
errors, such as read errors. With this option in effect,
<b>pycdlib-genisoimage</b> tries to continue. Use with
care.</p>


<p style="margin-left:11%;"><b>&minus;no&minus;emul&minus;boot</b></p>

<p style="margin-left:22%;">Specifies that the boot image
used to create El Torito bootable CDs is a &quot;no
emulation&quot; image. The system will load and execute this
image without performing any disk emulation.</p>


<p style="margin-left:11%;"><b>&minus;no&minus;boot</b></p>

<p style="margin-left:22%;">Specifies that the created El
Torito CD should be marked as not bootable. The system will
provide an emulated drive for the image, but will boot off a
standard boot device.</p>


<p style="margin-left:11%;"><b>&minus;boot&minus;load&minus;seg</b>
<i>segment_address</i></p>

<p style="margin-left:22%;">Specifies the load segment
address of the boot image for no-emulation El Torito
CDs.</p>


<p style="margin-left:11%;"><b>&minus;boot&minus;load&minus;size</b>
<i>load_sectors</i></p>

<p style="margin-left:22%;">Specifies the number of
&quot;virtual&quot; (512-byte) sectors to load in
no-emulation mode. The default is to load the entire boot
file. Some BIOSes may have problems if this is not a
multiple of 4.</p>


<p style="margin-left:11%;"><b>&minus;boot&minus;info&minus;table</b></p>

<p style="margin-left:22%;">Specifies that a 56-byte table
with information of the CD-ROM layout will be patched in at
offset 8 in the boot file.</p>

<p style="margin-left:11%;"><b>&minus;C</b>
<i>last_sess_start,next_sess_start</i> <b><br>
&minus;cdrecord&minus;params</b>
<i>last_sess_start,next_sess_start</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) This option is needed to create a CD
Extra or the image of a second session or a higher-level
session for a multisession disc. <b>&minus;C</b> takes two
numbers separated by a comma. The first is the first sector
in the last session of the disc that should be appended to.
The second number is the starting sector number of the new
session. The correct numbers may be retrieved by calling
<b>wodim &minus;msinfo ...</b> If <b>&minus;C</b> is used in
conjunction with <b>&minus;M</b>, <b>pycdlib-genisoimage</b>
will create a filesystem image that is intended to be a
continuation of the previous session. If <b>&minus;C</b> is
used without <b>&minus;M</b>, <b>pycdlib-genisoimage</b>
will create a filesystem image that is intended to be used
for a second session on a CD Extra. This is a multisession
CD that holds audio data in the first session and an ISO9660
filesystem in the second session.</p>

<p style="margin-left:11%;"><b>&minus;c</b>
<i>boot_catalog</i> <b><br>
&minus;eltorito&minus;catalog</b> <i>boot_catalog</i></p>

<p style="margin-left:22%;">Specifies the path and filename
of the boot catalog, which is required for an El Torito
bootable CD. The pathname must be relative to the source
path specified to <b>pycdlib-genisoimage</b>. This file will
be inserted into the output tree and not created in the
source filesystem, so be sure the specified filename does
not conflict with an existing file, or it will be excluded.
Usually a name like <i>boot.catalog</i> is chosen.</p>

<p style="margin-left:22%; margin-top: 1em">If
<b>&minus;sort</b> has not been specified, the boot catalog
sorted with low priority (+1) to the beginning of the
medium. If you don&rsquo;t like this, you need to specify a
sort weight of 0 for the boot catalog.</p>


<p style="margin-left:11%;"><b>&minus;check&minus;oldnames</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Check all filenames imported from the
old session for compliance with the ISO9660 file naming
rules. Without this option, only names longer than 31
characters are checked, as these files are a serious
violation of the ISO9660 standard.</p>


<p style="margin-left:11%;"><b>&minus;check&minus;session</b>
<i>file</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Check all old sessions for compliance
with actual <b>pycdlib-genisoimage</b> ISO9660 file naming
rules. This is a high-level option that combines
<b>&minus;M</b> <i>file</i> <b>&minus;C 0,0
&minus;check&minus;oldnames</b>. For the parameter
<i>file</i>, see the description of <b>&minus;M</b>.</p>


<p style="margin-left:11%;"><b>&minus;checksum_algorithm_iso</b>
<i>alg1,alg2,...</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specify the checksum types desired for
the output image.</p>


<p style="margin-left:11%;"><b>&minus;checksum_algorithm_template</b>
<i>alg1,alg2,...</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specify the checksum types desired for
the output jigdo template.</p>

<p style="margin-left:11%;"><b>&minus;copyright</b>
<i>file</i></p>

<p style="margin-left:22%;">Specifies copyright
information, typically a filename on the disc. There is
space for 37 characters.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">


<p><b>&minus;d</b></p></td>
<td width="86%">
</td></tr>
</table>


<p style="margin-left:11%;"><b>&minus;omit&minus;period</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Do not append a period to files that do
not have one. <br>
This violates the ISO9660 standard, but it happens to work
on many systems. Use with caution.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">


<p><b>&minus;D</b></p></td>
<td width="86%">
</td></tr>
</table>


<p style="margin-left:11%;"><b>&minus;disable&minus;deep&minus;relocation</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Do not use deep directory relocation,
and instead just pack them in the way we see them. <br>
If ISO9660:1999 has not been selected, this violates the
ISO9660 standard, but it happens to work on many systems.
Use with caution.</p>


<p style="margin-left:11%;"><b>&minus;data&minus;change&minus;warn</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) If the size of a file changes while the
file is being archived, treat this condition as a warning
only that does not cause <b>pycdlib-genisoimage</b> to
abort.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">


<p><b>&minus;debug</b></p></td>
<td width="2%"></td>
<td width="78%">


<p>(not supported by pycdlib-genisoimage) Set debug
flag.</p> </td></tr>
</table>

<p style="margin-left:11%;"><b>&minus;dir&minus;mode</b>
<i>mode</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Overrides the mode of directories used
to create the image to <i>mode</i>, specified as 4 digits of
permission bits as in <b>chmod</b>(1). This option
automatically enables Rock Ridge extensions.</p>


<p style="margin-left:11%;"><b>&minus;dvd&minus;video</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Generate a DVD-Video compliant UDF
filesystem. This is done by sorting the order of the content
of the appropriate files and by adding padding between the
files if needed. Note that the sorting only works if the
DVD-Video filenames include uppercase characters only.</p>

<p style="margin-left:22%; margin-top: 1em">Note that in
order to get a DVD-Video compliant filesystem image, you
need to prepare a DVD-Video compliant directory tree. This
requires a directory <b>VIDEO_TS</b> (all caps) in the root
directory of the resulting DVD, and usually another
directory <b>AUDIO_TS</b>. <b>VIDEO_TS</b> needs to include
all needed files (filenames must be all caps) for a
compliant DVD-Video filesystem.</p>

<p style="margin-left:11%;"><b>&minus;e</b>
<i>efi_boot_file</i> <b><br>
&minus;efi&minus;boot</b> <i>efi_boot_file</i></p>

<p style="margin-left:22%;">Set EFI boot image name.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">


<p><b>&minus;f</b></p></td>
<td width="86%">
</td></tr>
</table>


<p style="margin-left:11%;"><b>&minus;follow&minus;links</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Follow symbolic links when generating
the filesystem. When this option is not in use, symbolic
links will be entered using Rock Ridge if enabled, otherwise
they will be ignored.</p>

<p style="margin-left:11%;"><b>&minus;file&minus;mode</b>
<i>mode</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Overrides the mode of regular files
used to create the image to <i>mode</i>, specified as 4
digits of permission bits as in <b>chmod</b>(1). This option
automatically enables Rock Ridge extensions.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="7%">


<p><b>&minus;find</b></p></td>
<td width="4%"></td>
<td width="78%">


<p>(not supported by pycdlib-genisoimage) This option acts
a separator. If it is used, all <b>pycdlib-genisoimage</b>
options must be to the left of the <b>&minus;find</b>
option. To the right of the <b>&minus;find</b> option,
<b>pycdlib-genisoimage</b> accepts the <b>find</b> command
line syntax only.</p></td></tr>
</table>

<p style="margin-left:22%; margin-top: 1em">The <b>find</b>
expression acts as a filter between the source of file names
and the consumer, which is archiving engine. If the
<b>find</b> expression evaluated as TRUE, then the related
file is selected for processing, otherwise it is omited.</p>

<p style="margin-left:22%; margin-top: 1em">In order to
make the evaluation of the <b>find</b> expression more
convenient, <b>pycdlib-genisoimage</b> implements additional
<b>find primaries</b> that have side effects on the file
meta data. <b>pycdlib-genisoimage</b> implements the
following additional <b>find</b> primaries:</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="22%"></td>
<td width="7%">


<p style="margin-top: 1em"><b>&minus;help</b></p></td>
<td width="3%"></td>
<td width="54%">


<p style="margin-top: 1em">Lists the available
<b>find</b>(1) syntax.</p></td>
<td width="14%">
</td></tr>
</table>

<p style="margin-left:22%;"><b>&minus;chgrp</b>
<i>gname</i></p>

<p style="margin-left:32%;">The primary always evaluates as
true; it sets the group of the file to <i>gname</i>.</p>

<p style="margin-left:22%;"><b>&minus;chmod</b>
<i>mode</i></p>

<p style="margin-left:32%;">The primary always evaluates as
true; it sets the permissions of the file to <i>mode</i>.
Octal and symbolic permissions are accepted for <i>mode</i>
as with <b>chmod</b>(1).</p>

<p style="margin-left:22%;"><b>&minus;chown</b>
<i>uname</i></p>

<p style="margin-left:32%;">The primary always evaluates as
true; it sets the owner of the file to <i>uname</i>.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="22%"></td>
<td width="9%">


<p><b>&minus;false</b></p></td>
<td width="1%"></td>
<td width="68%">


<p>The primary always evaluates as false; it allows to make
the result of the full expression different from the result
of a part of the expression.</p></td></tr>
<tr valign="top" align="left">
<td width="22%"></td>
<td width="9%">


<p><b>&minus;true</b></p></td>
<td width="1%"></td>
<td width="68%">


<p>The primary always evaluates as true; it allows to make
the result of the full expression different from the result
of a part of the expression.</p></td></tr>
</table>

<p style="margin-left:22%; margin-top: 1em">The command
line:</p>


<p style="margin-left:22%; margin-top: 1em"><b>pycdlib-genisoimage
-o o.iso -find . ( -type d -ls -o false ) -o ! -type
d</b></p>

<p style="margin-left:22%; margin-top: 1em">lists all
directories and puts all non-directories to the image
<b>o.iso</b>.</p>

<p style="margin-left:22%; margin-top: 1em">The command
line:</p>


<p style="margin-left:22%; margin-top: 1em"><b>pycdlib-genisoimage
-o o.iso -find . ( -type d -chown root -o true )</b></p>

<p style="margin-left:22%; margin-top: 1em">archives all
directories so they appear to be owned by root in the
archive, all non-directories are archived as they are in the
file system.</p>

<p style="margin-left:22%; margin-top: 1em">Note that the
<b>&minus;ls</b>, <b>&minus;exec</b> and the
<b>&minus;ok</b> primary cannot be used if <b>stdin</b> or
stdout has not been redirected.</p>

<p style="margin-left:11%;"><b>&minus;gid</b>
<i>gid</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Overrides the group ID read from the
source files to the value of <i>gid</i>. Specifying this
option automatically enables Rock Ridge extensions.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="6%">


<p><b>&minus;gui</b></p></td>
<td width="5%"></td>
<td width="78%">


<p>(not supported by pycdlib-genisoimage) Switch the
behaviour for a GUI. This currently makes the output more
verbose but may have other effects in the future.</p></td></tr>
</table>


<p style="margin-left:11%;"><b>&minus;graft&minus;points</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Allow use of graft points for
filenames. If this option is used, all filenames are checked
for graft points. The filename is divided at the first
unescaped equal sign. All occurrences of &lsquo;\&rsquo; and
&lsquo;=&rsquo; characters must be escaped with
&lsquo;\&rsquo; if <b>&minus;graft&minus;points</b> has been
specified.</p>

<p style="margin-left:11%;"><b>&minus;hide</b>
<i>glob</i></p>

<p style="margin-left:22%;">Hide any files matching
<i>glob</i>, a shell wildcard pattern, from being seen in
the ISO9660 or Rock Ridge directory. <i>glob</i> may match
any part of the filename or path. If <i>glob</i> matches a
directory, the contents of that directory will be hidden. In
order to match a directory name, make sure the pathname does
not include a trailing &lsquo;/&rsquo; character. All the
hidden files will still be written to the output CD image
file. See also <b>&minus;hide&minus;joliet</b>, and
<i>README.hide</i>. This option may be used multiple
times.</p>

<p style="margin-left:11%;"><b>&minus;hide&minus;list</b>
<i>file</i></p>

<p style="margin-left:22%;">A file containing a list of
shell wildcards to be hidden. See <b>&minus;hide</b>.</p>

<p style="margin-left:11%;"><b>&minus;hidden</b>
<i>glob</i></p>

<p style="margin-left:22%;">Add the hidden (existence)
ISO9660 directory attribute for files and directories
matching <i>glob</i>, a shell wildcard pattern. This
attribute will prevent the files from being shown by some
MS-DOS and Windows commands. <i>glob</i> may match any part
of the filename or path. In order to match a directory name,
make sure the pathname does not include a trailing
&lsquo;/&rsquo; character. This option may be used multiple
times.</p>


<p style="margin-left:11%;"><b>&minus;hidden&minus;list</b>
<i>file</i></p>

<p style="margin-left:22%;">A file containing a list of
shell wildcards to get the hidden attribute. See
<b>&minus;hidden</b>.</p>


<p style="margin-left:11%;"><b>&minus;hide&minus;joliet</b>
<i>glob</i></p>

<p style="margin-left:22%;">Hide files and directories
matching <i>glob</i>, a shell wildcard pattern, from being
seen in the Joliet directory. <i>glob</i> may match any part
of the filename or path. If <i>glob</i> matches a directory,
the contents of that directory will be hidden. In order to
match a directory name, make sure the pathname does not
include a trailing &lsquo;/&rsquo; character. All the hidden
files will still be written to the output CD image file.
This option is usually used with <b>&minus;hide</b>. See
also <i>README.hide</i>. This option may be used multiple
times.</p>


<p style="margin-left:11%;"><b>&minus;hide&minus;joliet&minus;list</b>
<i>file</i></p>

<p style="margin-left:22%;">A file containing a list of
shell wildcards to be hidden from the Joliet tree. See
<b>&minus;hide&minus;joliet</b>.</p>


<p style="margin-left:11%;"><b>&minus;hide&minus;joliet&minus;trans&minus;tbl</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Hide the <i>TRANS.TBL</i> files from
the Joliet tree. These files usually don&rsquo;t make sense
in the Joliet world as they list the real name and the
ISO9660 name which may both be different from the Joliet
name.</p>


<p style="margin-left:11%;"><b>&minus;hide&minus;rr&minus;moved</b></p>

<p style="margin-left:22%;">Rename the directory
<i>RR_MOVED</i> to <i>.rr_moved</i> in the Rock Ridge tree.
It seems to be impossible to completely hide the
<i>RR_MOVED</i> directory from the Rock Ridge tree. This
option only makes the visible tree less confusing for people
who don&rsquo;t know what this directory is for. If you need
to have no <i>RR_MOVED</i> directory at all, you should use
<b>&minus;D</b>. Note that if <b>&minus;D</b> has been
specified, the resulting filesystem is not ISO9660 level-1
compliant and will not be readable on MS-DOS. See also the
<b>NOTES</b> section.</p>

<p style="margin-left:11%;"><b>&minus;hide&minus;udf</b>
<i>glob</i></p>

<p style="margin-left:22%;">Hide <i>glob</i> from being
seen on the UDF directory. <i>glob</i> is a shell
wild-card-style pattern that must match any part of the
filename or path. Multiple globs may be hidden. If
<i>glob</i> matches a directory, then the contents of that
directory will be hidden. In order to match a directory
name, make sure the pathname does not include a trailing
&rsquo;/&rsquo; character. All the hidden files will still
be written to the output CD image file. Should be used with
the <b>&minus;hide</b> option.</p>


<p style="margin-left:11%;"><b>&minus;hide&minus;udf&minus;list</b>
<i>file</i></p>

<p style="margin-left:22%;">A file containing a list of
<i>globs</i> to be hidden as above.</p>


<p style="margin-left:11%;"><b>&minus;input&minus;charset</b>
<i>charset</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Input charset that defines the
characters used in local filenames. To get a list of valid
charset names, call <b>pycdlib-genisoimage
&minus;input&minus;charset help</b>. To get a 1:1 mapping,
you may use <b>default</b> as charset name. The default
initial values are <i>cp437</i> on DOS-based systems and
<i>iso8859-1</i> on all other systems.</p>


<p style="margin-left:11%;"><b>&minus;output&minus;charset</b>
<i>charset</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Output charset that defines the
characters that will be used in Rock Ridge filenames.
Defaults to the input charset. See <b>CHARACTER SETS</b>
section below for more details.</p>

<p style="margin-left:11%;"><b>&minus;iso&minus;level</b>
<i>level</i></p>

<p style="margin-left:22%;">Set the ISO9660 conformance
level. Valid numbers are 1 to 4.</p>

<p style="margin-left:22%; margin-top: 1em">With level 1,
files may only consist of one section and filenames are
restricted to 8.3 characters.</p>

<p style="margin-left:22%; margin-top: 1em">With level 2,
files may only consist of one section.</p>

<p style="margin-left:22%; margin-top: 1em">With level 3,
no restrictions (other than ISO-9660:1988) do apply.</p>

<p style="margin-left:22%; margin-top: 1em">With all
ISO9660 levels from 1 to 3, all filenames are restricted to
uppercase letters, numbers and underscores (_). Filenames
are limited to 31 characters, directory nesting is limited
to 8 levels, and pathnames are limited to 255
characters.</p>

<p style="margin-left:22%; margin-top: 1em">Level 4
officially does not exist but <b>pycdlib-genisoimage</b>
maps it to ISO-9660:1999, which is ISO9660 version 2.</p>

<p style="margin-left:22%; margin-top: 1em">With level 4,
an enhanced volume descriptor with version number and file
structure version number set to 2 is emitted. Directory
nesting is not limited to 8 levels, there is no need for a
file to contain a dot and the dot has no special meaning,
filenames do not have version numbers, and filenames can be
up to 207 characters long, or 197 characters if Rock Ridge
is used.</p>

<p style="margin-left:22%; margin-top: 1em">When creating
Version 2 images, <b>pycdlib-genisoimage</b> emits an
enhanced volume descriptor, similar but not identical to a
primary volume descriptor. Be careful not to use broken
software to make ISO9660 images bootable by assuming a
second PVD copy and patching this putative PVD copy into an
El Torito VD.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">


<p><b>&minus;J</b></p></td>
<td width="8%"></td>
<td width="78%">


<p>Generate Joliet directory records in addition to regular
ISO9660 filenames. This is primarily useful when the discs
are to be used on Windows machines. Joliet filenames are
specified in Unicode and each path component can be up to 64
Unicode characters long. Note that Joliet is not a standard
&mdash; only Microsoft Windows and Linux systems can read
Joliet extensions. For greater portability, consider using
both Joliet and Rock Ridge extensions.</p></td></tr>
</table>


<p style="margin-left:11%;"><b>&minus;joliet&minus;long</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Allow Joliet filenames to be up to 103
Unicode characters, instead of 64. This breaks the Joliet
specification, but appears to work. Use with caution.</p>

<p style="margin-left:11%;"><b>&minus;jcharset</b>
<i>charset</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) A combination of <b>&minus;J
&minus;input&minus;charset</b> <i>charset</i>.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">


<p><b>&minus;l</b></p></td>
<td width="86%">
</td></tr>
</table>


<p style="margin-left:11%;"><b>&minus;full&minus;iso9660&minus;filenames</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Allow full 31-character filenames.
Normally the ISO9660 filename will be in an 8.3 format which
is compatible with MS-DOS, even though the ISO9660 standard
allows filenames of up to 31 characters. If you use this
option, the disc may be difficult to use on a MS-DOS system,
but will work on most other systems. Use with caution.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">


<p><b>&minus;L</b></p></td>
<td width="8%"></td>
<td width="75%">


<p>Outdated option; use
<b>&minus;allow&minus;leading&minus;dots</b> instead.</p></td>
<td width="3%">
</td></tr>
</table>


<p style="margin-left:11%;"><b>&minus;jigdo&minus;jigdo</b>
<i>jigdo_file</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Produce a <b>jigdo</b> <i>.jigdo</i>
metadata file as well as the filesystem image.</p>


<p style="margin-left:11%;"><b>&minus;jigdo&minus;template</b>
<i>template_file</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Produce a <b>jigdo</b> <i>.template</i>
file as well as the filesystem image.</p>


<p style="margin-left:11%;"><b>&minus;jigdo&minus;min&minus;file&minus;size</b>
<i>size</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specify the minimum size for a file to
be listed in the <i>.jigdo</i> file. Default (and minimum
allowed) is 1KB.</p>


<p style="margin-left:11%;"><b>&minus;jigdo&minus;force&minus;md5</b>
<i>path</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specify a file pattern where files
<i>must</i> be contained in the externally-supplied MD5 list
as supplied by <b>&minus;md5&minus;list</b>.</p>


<p style="margin-left:11%;"><b>&minus;jigdo&minus;exclude</b>
<i>path</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specify a file pattern where files will
not be listed in the <i>.jigdo</i> file.</p>

<p style="margin-left:11%;"><b>&minus;jigdo&minus;map</b>
<i>path</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specify a pattern mapping for the jigdo
file (e.g. <i>Debian=/mirror/debian</i>).</p>

<p style="margin-left:11%;"><b>&minus;md5&minus;list</b>
<i>md5_file</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specify a file containing the MD5sums,
sizes and pathnames of the files to be included in the
<i>.jigdo</i> file.</p>


<p style="margin-left:11%;"><b>&minus;jigdo&minus;template&minus;compress</b>
<i>algorithm</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specify a compression algorithm to use
for template date. gzip and bzip2 are currently supported,
and gzip is the default.</p>

<p style="margin-left:11%;"><b>&minus;log&minus;file</b>
<i>log_file</i></p>

<p style="margin-left:22%;">Redirect all error, warning and
informational messages to <i>log_file</i> instead of the
standard error.</p>


<p style="margin-left:11%;"><b>&minus;long&minus;rr&minus;time</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Use the long ISO-9660 time format for
the file time stamps used in Rock Ridge. This time format
allows to represent year 0 .. year 9999 with a granularity
of 10ms.</p>

<p style="margin-left:22%; margin-top: 1em">The short
ISO-9660 time format only allows to represent year 1900 ..
year 2155 with a granularity of 1s.</p>

<p style="margin-left:11%;"><b>&minus;m</b> <i>glob</i></p>

<p style="margin-left:22%;">Exclude files matching
<i>glob</i>, a shell wildcard pattern, from being written to
CD-ROM. <i>glob</i> may match either the filename component
or the full pathname. This option may be used multiple
times. For example:</p>


<p style="margin-left:22%; margin-top: 1em">pycdlib-genisoimage
&minus;o rom &minus;m '*.o' &minus;m core &minus;m
foobar</p>

<p style="margin-left:22%; margin-top: 1em">would exclude
all files ending in &lsquo;.o&rsquo;, or called <i>core</i>
or <i>foobar</i> from the image. Note that if you had a
directory called <i>foobar</i>, it too (and of course all
its descendants) would be excluded.</p>


<p style="margin-left:11%;"><b>&minus;exclude&minus;list</b>
<i>file</i></p>

<p style="margin-left:22%;">A file containing a list of
shell wildcards to be excluded. See <b>&minus;m</b>.</p>


<p style="margin-left:11%;"><b>&minus;max&minus;iso9660&minus;filenames</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Allow ISO9660 filenames to be up to 37
characters long. This option enables <b>&minus;N</b> as the
extra name space is taken from the space reserved for file
version numbers. <br>
This violates the ISO9660 standard, but it happens to work
on many systems. Although a conforming application needs to
provide a buffer space of at least 37 characters, discs
created with this option may cause a buffer overflow in the
reading operating system. Use with extreme care.</p>

<p style="margin-left:11%;"><b>&minus;M</b> <i>path</i>
<b><br>
&minus;M</b> <i>device</i> <b><br>
&minus;dev</b> <i>device</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specifies path to existing ISO9660
image to be merged. The alternate form takes a SCSI device
specifier that uses the same syntax as the <b>dev=</b>
parameter of <b>wodim</b>. The output of
<b>pycdlib-genisoimage</b> will be a new session which
should get written to the end of the image specified in
<b>&minus;M</b>. Typically this requires multisession
capability for the CD recorder used to write the image. This
option may only be used in conjunction with
<b>&minus;C</b>.</p>


<p style="margin-left:11%;"><b>&minus;modification&minus;date</b>
<i>date-spec</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Set the <b>modification date</b> in the
primary volume descriptor (PVD) to a value different from
the current time. This allows e.g. to set up an intentional
UUID for <b>grub</b>.</p>

<p style="margin-left:22%; margin-top: 1em">The format of
<i>date-spec</i> is:</p>


<p style="margin-left:22%; margin-top: 1em"><i>yyyy</i>[<i>mm</i>[<i>dd</i>[<i>hh</i>[<i>mm</i>[<i>ss</i>]]]]][.<i>hh</i>][+-<i>ghgm</i>]</p>

<p style="margin-left:22%; margin-top: 1em">The fields are
<b>year</b>, <b>month</b>, <b>day of month</b>, <b>hour</b>,
<b>minute</b>, <b>second</b>, <b>hundreds of a second</b>,
<b>GMT offset in hours and minutes</b>. The time is
interpreted as local time.</p>

<p style="margin-left:22%; margin-top: 1em">Year and the
GMT offset are four digit fields, all other fields take two
digits. The GMT offset may be between -12 and +13 hours in
15 minute steps. Locations east to Greenwich have positive
values. The value is the sum of the time zone offset and the
effects from daylight saving time. Omited values are
replaced by the minimal possible values. If the GMT offset
is omited, it is computed from the local time value that has
been supplied.</p>

<p style="margin-left:22%; margin-top: 1em">Between year
and month as well as between month and day of month, a
separator chosen from &rsquo;/&rsquo; and &rsquo;-&rsquo;
may appear. In this case, the year may be a two digit number
with values 69..99 representing 1969..1999 and values 00..68
representing 2000..2068. Between date and time spec, an
optional space is permitted. Between hours and minutes as
well as between minutes and seconds, an optional
&rsquo;:&rsquo; separator is permitted. This allows
<b>pycdlib-genisoimage</b> to parse the popular POSIX date
format created by:</p>

<p style="margin-left:22%; margin-top: 1em"><b>date
&quot;+%Y-%m-%d %H:%M:%S %z&quot;</b></p>

<p style="margin-left:22%; margin-top: 1em">Note that the
possible range for <i>date-spec</i> for 32 bit programs is
limited to values up to 2038 Jan 19 04:14:07 GMT.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">


<p><b>&minus;N</b></p></td>
<td width="86%">
</td></tr>
</table>


<p style="margin-left:11%;"><b>&minus;omit&minus;version&minus;number</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Omit version numbers from ISO9660
filenames. <br>
This violates the ISO9660 standard, but no one really uses
the version numbers anyway. Use with caution.</p>


<p style="margin-left:11%;"><b>&minus;new&minus;dir&minus;mode</b>
<i>mode</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specify the mode, a 4-digit number as
used in <b>chmod</b>(1), to use when creating new
directories in the filesystem image. The default is
0555.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">


<p><b>&minus;nobak</b></p></td>
<td width="80%">
</td></tr>
</table>

<p style="margin-left:11%;"><b>&minus;no&minus;bak</b></p>

<p style="margin-left:22%;">Exclude backup files files on
the ISO9660 filesystem; that is, filenames that contain the
characters &lsquo;~&rsquo; or &lsquo;#&rsquo; or end in
<i>.bak</i>. These are typically backup files for Unix text
editors.</p>


<p style="margin-left:11%;"><b>&minus;no&minus;limit&minus;pathtables</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) A ISO-9660 filesystem contains path
tables that contain a list of directories. This list may
contain many directories but only 65535 of them may be
parent directories. When
<b>&minus;no&minus;limit&minus;pathtables</b> is in use,
further parent directories will be folded to the root
directory and the resulting filesystem will no longer be
usable on <b>DOS</b>.</p>


<p style="margin-left:11%;"><b>&minus;no&minus;long&minus;rr&minus;time</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Use the short ISO-9660 time format for
the file time stamps used in Rock Ridge. This time format
allows to represent year 1990 .. year 2155 with a
granularity of one second.</p>


<p style="margin-left:11%;"><b>&minus;force&minus;rr</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Do not use the automatic Rock Ridge
attributes recognition for previous sessions. This can work
around problems with images created by, e.g., NERO Burning
ROM.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">


<p><b>&minus;no&minus;rr</b></p></td>
<td width="2%"></td>
<td width="78%">


<p>(not supported by pycdlib-genisoimage) Do not use the
Rock Ridge attributes from previous sessions. This may help
to avoid problems when <b>pycdlib-genisoimage</b> finds
illegal Rock Ridge signatures on an old session.</p></td></tr>
</table>


<p style="margin-left:11%;"><b>&minus;no&minus;split&minus;symlink&minus;components</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Don&rsquo;t split the symlink
components, but begin a new Continuation Area (CE) instead.
This may waste some space, but the SunOS 4.1.4 cdrom driver
has a bug in reading split symlink components.</p>

<p style="margin-left:22%; margin-top: 1em">It is
questionable whether this option is useful nowadays.</p>


<p style="margin-left:11%;"><b>&minus;no&minus;split&minus;symlink&minus;fields</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Don&rsquo;t split the symlink fields,
but begin a new Continuation Area (CE) instead. This may
waste some space, but the SunOS 4.1.4 and Solaris 2.5.1
cdrom driver have a bug in reading split symlink fields (a
&lsquo;/&rsquo; can be dropped).</p>

<p style="margin-left:22%; margin-top: 1em">It is
questionable whether this option is useful nowadays.</p>

<p style="margin-left:11%;"><b>&minus;o</b>
<i>filename</i></p>

<p style="margin-left:22%;">Specify the output file for the
the ISO9660 filesystem image. This can be a disk file, a
tape drive, or it can correspond directly to the device name
of the optical disc writer. If not specified, stdout is
used. Note that the output can also be a block device for a
regular disk partition, in which case the ISO9660 filesystem
can be mounted normally to verify that it was generated
correctly.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="6%">


<p><b>&minus;pad</b></p></td>
<td width="5%"></td>
<td width="78%">


<p>(not supported by pycdlib-genisoimage) Pad the end of
the whole image by 150 sectors (300 kB). This option is
enabled by default. If used in combination with
<b>&minus;B</b>, padding is inserted between the ISO9660
partition and the boot partitions, such that the first boot
partition starts on a sector number that is a multiple of
16.</p> </td></tr>
</table>

<p style="margin-left:22%; margin-top: 1em">The padding is
needed as many operating systems (e.g. Linux) implement
read-ahead bugs in their filesystem I/O. These bugs result
in read errors on files that are located near the end of a
track, particularly if the disc is written in Track At Once
mode, or where a CD audio track follows the data track.</p>

<p style="margin-left:11%;"><b>&minus;no&minus;pad</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Do not pad the end by 150 sectors (300
kB) and do not make the the boot partitions start on a
multiple of 16 sectors.</p>

<p style="margin-left:11%;"><b>&minus;path&minus;list</b>
<i>file</i></p>

<p style="margin-left:22%;">A file containing a list of
<i>pathspec</i> directories and filenames to be added to the
ISO9660 filesystem. This list of pathspecs are processed
after any that appear on the command line. If the argument
is <i>&minus;</i>, the list is read from the standard
input.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">


<p><b>&minus;P</b></p></td>
<td width="8%"></td>
<td width="61%">


<p>Outdated option; use <b>&minus;publisher</b>
instead.</p> </td>
<td width="17%">
</td></tr>
</table>

<p style="margin-left:11%;"><b>&minus;publisher</b>
<i>publisher_id</i></p>

<p style="margin-left:22%;">Specifies a text string that
will be written into the volume header. This should describe
the publisher of the CD-ROM, usually with a mailing address
and phone number. There is space for 128 characters.</p>

<p style="margin-left:11%;"><b>&minus;p</b>
<i>preparer_id</i> <b><br>
&minus;preparer</b> <i>preparer_id</i></p>

<p style="margin-left:22%;">Specifies a text string that
will be written into the volume header. This should describe
the preparer of the CD-ROM, usually with a mailing address
and phone number. There is space on the disc for 128
characters of information. The related Joliet entry is
limited to 64 characters.</p>


<p style="margin-left:11%;"><b>&minus;posix&minus;H</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Follow all symbolic links encountered
on command line when generating the filesystem.</p>


<p style="margin-left:11%;"><b>&minus;posix&minus;L</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Follow all symbolic links when
generating the filesystem. When this option is not in use,
symbolic links will be entered using Rock Ridge if enabled,
otherwise the file will be ignored.</p>


<p style="margin-left:11%;"><b>&minus;posix&minus;P</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Do not follow symbolic links when
generating the filesystem (this is the default). If
<b>&minus;posix&minus;P</b> is specified after
<b>&minus;posix&minus;H</b> or <b>&minus;posix&minus;L</b>,
the effect of these options will be reset.</p>


<p style="margin-left:11%;"><b>&minus;print&minus;size</b></p>

<p style="margin-left:22%;">Print estimated filesystem size
in multiples of the sector size (2048 bytes) and exit. This
option is needed for Disk At Once mode and with some CD-R
drives when piping directly into <b>wodim</b>, cases where
<b>wodim</b> needs to know the size of the filesystem image
in advance. Old versions of <b>mkisofs</b> wrote this
information (among other information) to <i>stderr</i>. As
this turns out to be hard to parse, the number without any
other information is now printed on <i>stdout</i> too. If
you like to write a simple shell script, redirect
<i>stderr</i> and catch the number from <i>stdout</i>. This
may be done with:</p>

<p style="margin-left:22%; margin-top: 1em">cdblocks=`
pycdlib-genisoimage &minus;print&minus;size &minus;quiet ...
` <br>
pycdlib-genisoimage ... | wodim ... tsize=${cdblocks}s
&minus;</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">


<p><b>&minus;quiet</b></p></td>
<td width="2%"></td>
<td width="78%">


<p>This makes <b>pycdlib-genisoimage</b> even less verbose.
No progress output will be provided.</p></td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">


<p><b>&minus;R</b></p></td>
<td width="2%"></td>
<td width="78%">
</td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">


<p><b>&minus;rock</b></p></td>
<td width="2%"></td>
<td width="78%">


<p>Generate SUSP and RR records using the Rock Ridge
protocol to further describe the files on the ISO9660
filesystem.</p> </td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">


<p><b>&minus;r</b></p></td>
<td width="2%"></td>
<td width="78%">
</td></tr>
</table>


<p style="margin-left:11%;"><b>&minus;rational&minus;rock</b></p>

<p style="margin-left:22%;">This is like the &minus;R
option, but file ownership and modes are set to more useful
values. The uid and gid are set to zero, because they are
usually only useful on the author&rsquo;s system, and not
useful to the client. All the file read bits are set true,
so that files and directories are globally readable on the
client. If any execute bit is set for a file, set all of the
execute bits, so that executables are globally executable on
the client. If any search bit is set for a directory, set
all of the search bits, so that directories are globally
searchable on the client. All write bits are cleared,
because the filesystem will be mounted read-only in any
case. If any of the special mode bits are set, clear them,
because file locks are not useful on a read-only filesystem,
and set-id bits are not desirable for uid 0 or gid 0. When
used on Win32, the execute bit is set on <i>all</i> files.
This is a result of the lack of file permissions on Win32
and the Cygwin POSIX emulation layer. See also
<b>&minus;uid</b>, <b>&minus;gid</b>,
<b>&minus;dir&minus;mode</b>, <b>&minus;file&minus;mode</b>
and <b>&minus;new&minus;dir&minus;mode</b>.</p>


<p style="margin-left:11%;"><b>&minus;relaxed&minus;filenames</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Allows ISO9660 filenames to include all
7-bit ASCII characters except lowercase letters. <br>
This violates the ISO9660 standard, but it happens to work
on many systems. Use with caution.</p>

<p style="margin-left:11%;"><b>&minus;root</b>
<i>dir</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Moves all files and directories into
<i>dir</i> in the image. This is essentially the same as
using <b>&minus;graft&minus;points</b> and adding <i>dir</i>
in front of every pathspec, but is easier to use. <i>dir</i>
may actually be several levels deep. It is created with the
same permissions as other graft points.</p>

<p style="margin-left:11%;"><b>&minus;rrip110</b></p>

<p style="margin-left:22%;">Create ISO-9660 file system
images that follow the old Rrip Version-1.10 standard from
1993. This option may be needed if you know of systems that
do not implement the Rrip protocol correctly and like the
file system to be read by such a system. Currently no such
system is known.</p>

<p style="margin-left:22%; margin-top: 1em">If a file
system has been created with <b>&minus;rrip110</b>, the Rock
Ridge attributes do not include inode number
information.</p>

<p style="margin-left:11%;"><b>&minus;rrip112</b></p>

<p style="margin-left:22%;">Create ISO-9660 file system
images that follow the new Rrip Version-1.12 standard from
1994.</p>

<p style="margin-left:11%;"><b>&minus;old-root</b>
<i>dir</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) This option is necessary when writing a
multisession image and the previous (or even older) session
was written with <b>-root</b> <i>dir</i>. Using a directory
name not found in the previous session causes
<b>pycdlib-genisoimage</b> to abort with an error. Without
this option, <b>pycdlib-genisoimage</b> would not be able to
find unmodified files and would be forced to write their
data into the image once more. <b>&minus;root</b> and
<b>&minus;old-root</b> are meant to be used together to do
incremental backups. The initial session would e.g. use:
<b>pycdlib-genisoimage &minus;root backup_1</b> <i>dirs</i>.
The next incremental backup with <b>pycdlib-genisoimage
&minus;root backup_2 &minus;old-root backup_1</b>
<i>dirs</i> would take another snapshot of these
directories. The first snapshot would be found in
<b>backup_1</b>, the second one in <b>backup_2</b>, but only
modified or new files need to be written into the second
session. Without these options, new files would be added and
old ones would be preserved. But old ones would be
overwritten if the file was modified. Recovering the files
by copying the whole directory back from CD would also
restore files that were deleted intentionally. Accessing
several older versions of a file requires support by the
operating system to choose which sessions are to be
mounted.</p>

<p style="margin-left:11%;"><b>&minus;s</b> <i>sector
type</i> <b><br>
&minus;sectype</b> <i>sector type</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Set output sector type to e.g.
data/xa1/raw.</p>

<p style="margin-left:11%;"><b>&minus;sort</b>
<i>sort_file</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Sort file locations on the media.
Sorting is controlled by a file that contains pairs of
filenames and sorting offset weighting. If the weighting is
higher, the file will be located closer to the beginning of
the media, if the weighting is lower, the file will be
located closer to the end of the media. There must be only
one space or tabs character between the filename and the
weight and the weight must be the last characters on a line.
The filename is taken to include all the characters up to,
but not including the last space or tab character on a line.
This is to allow for space characters to be in, or at the
end of a filename. This option does <b>not</b> sort the
order of the filenames that appear in the ISO9660 directory.
It sorts the order in which the file data is written to the
CD image, which is useful in order to optimize the data
layout on a CD. See <b>README.sort</b> for more details.</p>

<p style="margin-left:11%;"><b>&minus;sparc&minus;boot</b>
<i>img_sun4,img_sun4c,img_sun4m,img_sun4d,img_sun4e</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) See <b>&minus;B</b> above.</p>


<p style="margin-left:11%;"><b>&minus;sparc&minus;label</b>
<i>label</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Set the Sun disk label name for the Sun
disk label that is created with
<b>&minus;sparc-boot</b>.</p>


<p style="margin-left:11%;"><b>&minus;split&minus;output</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Split the output image into several
files of approximately 1 GB each. This helps to create
DVD-sized ISO9660 images on operating systems without large
file support. <b>wodim</b> will concatenate more than one
file into a single track if writing to a DVD. To make
<b>&minus;split&minus;output</b> work, <b>&minus;o</b>
<i>filename</i> must be specified. The resulting output
images will be named: <i>filename_00</i>,
<i>filename_01</i>, <i>filename_02</i>....</p>


<p style="margin-left:11%;"><b>&minus;stream&minus;media&minus;size</b>
<i>#</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Select streaming operation and set the
media size to # sectors. This allows you to pipe the output
of the <b>tar</b>(1) program into <b>pycdlib-genisoimage</b>
and to create an ISO9660 filesystem without the need of an
intermediate tar archive file. If this option has been
specified, <b>pycdlib-genisoimage</b> reads from
<i>stdin</i> and creates a file with the name
<i>STREAM.IMG</i>. The maximum size of the file (with
padding) is 200 sectors less than the specified media size.
If <b>&minus;no&minus;pad</b> has been specified, the file
size is 50 sectors less than the specified media size. If
the file is smaller, <b>pycdlib-genisoimage</b> will write
padding. This may take awhile.</p>

<p style="margin-left:22%; margin-top: 1em">The option
<b>&minus;stream&minus;media&minus;size</b> creates simple
ISO9660 filesystems only and may not used together with
multisession or hybrid filesystem options.</p>


<p style="margin-left:11%;"><b>&minus;stream&minus;file&minus;name</b>
<i>name</i></p>

<p style="margin-left:22%;">Reserved for future use.</p>


<p style="margin-left:11%;"><b>&minus;sunx86&minus;boot</b>
<i>UFS_img,,,AUX1_img</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specifies a comma-separated list of
filesystem images that are needed to make a bootable CD for
Solaris x86 systems.</p>

<p style="margin-left:22%; margin-top: 1em">Note that
partition 1 is used for the ISO9660 image and that partition
2 is the whole disk, so partition 1 and 2 may not be used by
external partition data. The first image file is mapped to
partition 0. There may be empty fields in the
comma-separated list, and list entries for partition 1 and 2
must be empty. The maximum number of supported partitions is
8 (although the Solaris x86 partition table could support up
to 16 partitions), so it is impossible to specify more than
6 partition images. This option is required to make a
bootable CD for Solaris x86 systems.</p>

<p style="margin-left:22%; margin-top: 1em">If
<b>&minus;sunx86&minus;boot</b> has been specified, the
first sector of the resulting image will contain a PC fdisk
label with a Solaris type 0x82 fdisk partition that starts
at offset 512 and spans the whole CD. In addition, for the
Solaris type 0x82 fdisk partition, there is a SVr4 disk
label at offset 1024 in the first sector of the CD. This
disk label specifies slice 0 for the first (usually UFS
type) filesystem image that is used to boot the PC and slice
1 for the ISO9660 image. Slice 2 spans the whole CD slice 3
... slice 7 may be used for additional filesystem images
that have been specified with this option.</p>

<p style="margin-left:22%; margin-top: 1em">A Solaris x86
boot CD uses a 1024 byte sized primary boot that uses the
<b>El-Torito no-emulation</b> boot mode and a secondary
generic boot that is in CD sectors 1..15. For this reason,
both <b>-b</b> <i>bootimage</i>
<b>&minus;no&minus;emul&minus;boot</b> and <b>&minus;G</b>
<i>genboot</i> must be specified.</p>


<p style="margin-left:11%;"><b>&minus;sunx86&minus;label</b>
<i>label</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Set the SVr4 disk label name for the
SVr4 disk label that is created with
<b>&minus;sunx86-boot</b>.</p>

<p style="margin-left:11%;"><b>&minus;sysid</b>
<i>ID</i></p>

<p style="margin-left:22%;">Specifies the system ID. There
is space for 32 characters.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">


<p><b>&minus;T</b></p></td>
<td width="86%">
</td></tr>
</table>


<p style="margin-left:11%;"><b>&minus;translation&minus;table</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Generate a file <i>TRANS.TBL</i> in
each directory on the CD-ROM, which can be used on
non-Rock&nbsp;Ridge-capable systems to help establish the
correct filenames. There is also information present in the
file that indicates the major and minor numbers for block
and character devices, and each symlink has the name of the
link file given.</p>

<p style="margin-left:11%;"><b>&minus;table&minus;name</b>
<i>table_name</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Alternative translation table filename
(see above). Implies <b>&minus;T</b>. If you are creating a
multisession image you must use the same name as in the
previous session.</p>

<p style="margin-left:11%;"><b>&minus;ucs&minus;level</b>
<i>level</i></p>

<p style="margin-left:22%;">Set Unicode conformance level
in the Joliet SVD. The default level is 3. It may be set to
1..3 using this option.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="6%">


<p><b>&minus;UDF</b></p></td>
<td width="5%"></td>
<td width="78%">


<p>Include a <b>UDF</b> hybrid in the generated filesystem
image. As <b>pycdlib-genisoimage</b> always creates a
ISO-9660 filesystem, it is not possible to create UDF only
images. Note that <b>UDF</b> wastes the space from sector
~20 to sector 256 at the beginning of the disk in addition
to the space needed for real <b>UDF</b> data structures.</p></td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="6%">


<p><b>&minus;udf</b></p></td>
<td width="5%"></td>
<td width="78%">


<p>Rationalized UDF with user and group set to 0 and with
simplified permissions. See <b>&minus;r</b> option for more
information.</p> </td></tr>
</table>


<p style="margin-left:11%;"><b>&minus;udf&minus;symlinks</b></p>

<p style="margin-left:22%;">Support symlinks in <b>UDF</b>
filesystems. This is the default.</p>


<p style="margin-left:11%;"><b>&minus;no&minus;udf&minus;symlinks</b></p>

<p style="margin-left:22%;">Do not support symlinks in
<b>UDF</b> filesystems.</p>

<p style="margin-left:11%;"><b>&minus;uid</b>
<i>uid</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Overrides the uid read from the source
files to the value of <i>uid</i>. Specifying this option
automatically enables Rock Ridge extensions.</p>


<p style="margin-left:11%;"><b>&minus;use&minus;fileversion</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) The option
<b>&minus;use&minus;fileversion</b> allows
<b>pycdlib-genisoimage</b> to use file version numbers from
the filesystem. If the option is not specified,
<b>pycdlib-genisoimage</b> creates a version number of 1 for
all files. File versions are strings in the range <i>;1</i>
to <i>;32767</i> This option is the default on VMS.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">


<p><b>&minus;U</b></p></td>
<td width="86%">
</td></tr>
</table>


<p style="margin-left:11%;"><b>&minus;untranslated&minus;filenames</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Allows &quot;untranslated&quot;
filenames, completely violating the ISO9660 standards
described above. Enables the following flags: <b>&minus;d
&minus;l &minus;N &minus;allow&minus;leading&minus;dots
&minus;relaxed&minus;filenames &minus;allow&minus;lowercase
&minus;allow&minus;multidot
&minus;no&minus;iso&minus;translate</b>. Allows more than
one &lsquo;.&rsquo; character in the filename, as well as
mixed-case filenames. This is useful on HP-UX, where the
built-in <i>cdfs</i> filesystem does not recognize any
extensions. Use with extreme caution.</p>


<p style="margin-left:11%;"><b>&minus;no&minus;iso&minus;translate</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Do not translate the characters
&lsquo;#&rsquo; and &lsquo;~&rsquo; which are invalid for
ISO9660 filenames. Although invalid, these characters are
often used by Microsoft systems. <br>
This violates the ISO9660 standard, but it happens to work
on many systems. Use with caution.</p>

<p style="margin-left:11%;"><b>&minus;V</b>
<i>volid</i></p>

<p style="margin-left:22%;">Specifies the volume ID (volume
name or label) to be written into the master block. There is
space for 32 characters. The volume ID is used as the mount
point by the Solaris volume manager and as a label assigned
to a disc on various other platforms such as Windows and
Apple Mac OS.</p>

<p style="margin-left:11%;"><b>&minus;volset</b>
<i>ID</i></p>

<p style="margin-left:22%;">Specifies the volume set ID.
There is space for 128 characters.</p>


<p style="margin-left:11%;"><b>&minus;volset&minus;size</b>
<i>#</i></p>

<p style="margin-left:22%;">Sets the volume set size to #.
The volume set size is the number of CDs that are in a CD
volume set. A volume set is a collection of one or more
volumes, on which a set of files is recorded.</p>

<p style="margin-left:22%; margin-top: 1em">Volume Sets are
not intended to be used to create a set numbered CDs that
are part of e.g. a Operation System installation set of CDs.
Volume Sets are rather used to record a big directory tree
that would not fit on a single volume. Each volume of a
Volume Set contains a description of all the directories and
files that are recorded on the volumes where the sequence
numbers are less than, or equal to, the assigned Volume Set
Size of the current volume.</p>


<p style="margin-left:22%; margin-top: 1em"><b>pycdlib-genisoimage</b>
currently does not support a <b>&minus;volset&minus;size</b>
that is larger than 1.</p>

<p style="margin-left:22%; margin-top: 1em">The option
<b>&minus;volset&minus;size</b> must be specified before
<b>&minus;volset&minus;seqno</b> on each command line.</p>


<p style="margin-left:11%;"><b>&minus;volset&minus;seqno</b>
<i>#</i></p>

<p style="margin-left:22%;">Sets the volume set sequence
number to #. The volume set sequence number is the index
number of the current CD in a CD set. The option
<b>&minus;volset&minus;size</b> must be specified before
<b>&minus;volset&minus;seqno</b> on each command line.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">


<p><b>&minus;v</b></p></td>
<td width="86%">
</td></tr>
</table>

<p style="margin-left:11%;"><b>&minus;verbose</b></p>

<p style="margin-left:22%;">Verbose execution. If given
twice on the command line, extra debug information will be
printed.</p>

<p style="margin-left:11%;"><b>&minus;x</b> <i>glob</i></p>

<p style="margin-left:22%;">Identical to <b>&minus;m</b>
<i>glob</i>.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="4%">


<p><b>&minus;XA</b></p></td>
<td width="7%"></td>
<td width="72%">


<p>Generate XA directory attruibutes.</p></td>
<td width="6%">
</td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="4%">


<p><b>&minus;xa</b></p></td>
<td width="7%"></td>
<td width="72%">


<p>Generate rationalized XA directory attruibutes.</p></td>
<td width="6%">
</td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="4%">


<p><b>&minus;z</b></p></td>
<td width="7%"></td>
<td width="72%"></td>
<td width="6%">
</td></tr>
</table>


<p style="margin-left:11%;"><b>&minus;transparent&minus;compression</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Generate special <i>RRIP</i> records
for transparently compressed files. This is only of use and
interest for hosts that support transparent decompression,
such as Linux 2.4.14 or later. You must specify
<b>&minus;R</b> or <b>&minus;r</b> to enable Rock Ridge, and
generate compressed files using the <b>mkzftree</b> utility
before running <b>pycdlib-genisoimage</b>. Note that
transparent compression is a nonstandard Rock Ridge
extension. The resulting disks are only transparently
readable if used on Linux. On other operating systems you
will need to call <b>mkzftree</b> by hand to decompress the
files.</p>


<p style="margin-left:11%;"><b>&minus;scan&minus;for&minus;duplicates</b></p>

<p style="margin-left:22%;">Keep a running list of file
hashes, attempting to link as many files together as
possible. This results in the smallest possible ISO image,
but may be very slow, particular with large files.</p>

<h2>HFS OPTIONS
<a name="HFS OPTIONS"></a>
</h2>


<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="6%">


<p style="margin-top: 1em"><b>&minus;hfs</b></p></td>
<td width="5%"></td>
<td width="78%">


<p style="margin-top: 1em">(not supported by
pycdlib-genisoimage) Create an ISO9660/HFS hybrid CD. This
option should be used in conjunction with the
<b>&minus;map</b>, <b>&minus;magic</b> and/or the various
<i>double dash</i> options given below.</p></td></tr>
</table>

<p style="margin-left:11%;"><b>&minus;no&minus;hfs</b></p>

<p style="margin-left:22%;">Do not create an ISO-9660/HFS
hybrid CD even though other options may imply to do so.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">


<p><b>&minus;apple</b></p></td>
<td width="2%"></td>
<td width="78%">


<p>(not supported by pycdlib-genisoimage) Create an ISO9660
CD with Apple&rsquo;s extensions. Similar to
<b>&minus;hfs</b>, except that the Apple Extensions to
ISO9660 are added instead of creating an HFS hybrid volume.
Former <b>pycdlib-genisoimage</b> versions did include Rock
Ridge attributes by default if <b>&minus;apple</b> was
specified. This versions of <b>pycdlib-genisoimage</b> does
not do this anymore. If you like to have Rock Ridge
attributes, you need to specify this separately.</p></td></tr>
</table>

<p style="margin-left:11%;"><b>&minus;map</b>
<i>mapping_file</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Use the <i>mapping_file</i> to set the
CREATOR and TYPE information for a file based on the
filename&rsquo;s extension. A filename is mapped only if it
is not one of the know Apple/Unix file formats.</p>

<p style="margin-left:11%;"><b>&minus;magic</b>
<i>magic_file</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) The CREATOR and TYPE information is set
by using a file&rsquo;s <i>magic number</i> (usually the
first few bytes of a file). The <i>magic_file</i> is only
used if a file is not one of the known Apple/Unix file
formats, or the filename extension has not been mapped using
<b>&minus;map</b>.</p>


<p style="margin-left:11%;"><b>&minus;hfs&minus;creator</b>
<i>creator</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Set the default CREATOR for all files.
Must be exactly 4 characters.</p>

<p style="margin-left:11%;"><b>&minus;hfs&minus;type</b>
<i>type</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Set the default TYPE for all files.
Must be exactly 4 characters.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">


<p><b>&minus;probe</b></p></td>
<td width="2%"></td>
<td width="78%">


<p>(not supported by pycdlib-genisoimage) Search the
contents of files for all the known Apple/Unix file formats.
However, the only way to check for <i>MacBinary</i> and
<i>AppleSingle</i> files is to open and read them, so this
option may increase processing time. It is better to use one
or more <i>double dash</i> options given below if the
Apple/Unix formats in use are known.</p></td></tr>
</table>


<p style="margin-left:11%;"><b>&minus;no&minus;desktop</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Do not create (empty) Desktop files.
New HFS Desktop files will be created when the CD is used on
a Macintosh (and stored in the System Folder). By default,
empty Desktop files are added to the HFS volume.</p>


<p style="margin-left:11%;"><b>&minus;mac&minus;name</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Use the HFS filename as the starting
point for the ISO9660, Joliet and Rock Ridge filenames.</p>


<p style="margin-left:11%;"><b>&minus;boot&minus;hfs&minus;file</b>
<i>driver_file</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Installs the <i>driver_file</i> that
<i>may</i> make the CD bootable on a Macintosh.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="7%">


<p><b>&minus;part</b></p></td>
<td width="4%"></td>
<td width="78%">


<p>(not supported by pycdlib-genisoimage) Generate an HFS
partition table. By default, no partition table is
generated, but some older Macintosh CD-ROM drivers need an
HFS partition table on the CD-ROM to be able to recognize a
hybrid CD-ROM.</p></td></tr>
</table>

<p style="margin-left:11%;"><b>&minus;auto</b>
<i>AutoStart_file</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Make the HFS CD use the QuickTime 2.0
Autostart feature to launch an application or document. The
given filename must be the name of a document or application
located at the top level of the CD. The filename must be
less than 12 characters. (Alpha).</p>


<p style="margin-left:11%;"><b>&minus;cluster&minus;size</b>
<i>size</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Set the size in bytes of the cluster or
allocation units of PC Exchange files. Implies
<b>&minus;&minus;exchange</b>.</p>

<p style="margin-left:11%;"><b>&minus;hide&minus;hfs</b>
<i>glob</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Hide <i>glob</i>, a shell wildcard
pattern, from the HFS volume. The file or directory will
still exist in the ISO9660 and/or Joliet directory.
<i>glob</i> may match any part of the filename. Multiple
globs may be excluded. Example:</p>


<p style="margin-left:22%; margin-top: 1em">pycdlib-genisoimage
&minus;o rom &minus;hfs &minus;hide&minus;hfs '*.o'
&minus;hide&minus;hfs foobar</p>

<p style="margin-left:22%; margin-top: 1em">would exclude
all files ending in &lsquo;.o&rsquo; or called <i>foobar</i>
from the HFS volume. Note that if you had a directory called
<i>foobar</i>, it too (and of course all its descendants)
would be excluded. The <i>glob</i> can also be a path name
relative to the source directories given on the command
line. Example:</p>


<p style="margin-left:22%; margin-top: 1em">pycdlib-genisoimage
&minus;o rom &minus;hfs &minus;hide&minus;hfs src/html
src</p>

<p style="margin-left:22%; margin-top: 1em">would exclude
just the file or directory called <i>html</i> from the
<i>src</i> directory. Any other file or directory called
<i>html</i> in the tree will not be excluded. Should be used
with <b>&minus;hide</b> and/or
<b>&minus;hide&minus;joliet</b>. In order to match a
directory name, make sure the pattern does not include a
trailing &lsquo;/&rsquo; character. See <i>README.hide</i>
for more details.</p>


<p style="margin-left:11%;"><b>&minus;hide&minus;hfs&minus;list</b>
<i>file</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Specify a file containing a list of
wildcard patterns to be hidden as in
<b>&minus;hide&minus;hfs</b>.</p>

<p style="margin-left:11%;"><b>&minus;hfs&minus;volid</b>
<i>hfs_volid</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Volume name for the HFS partition. This
is the name that is assigned to the disc on a Macintosh and
replaces the <i>volid</i> used with <b>&minus;V</b>.</p>


<p style="margin-left:11%;"><b>&minus;icon&minus;position</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Use the icon position information, if
it exists, from the Apple/Unix file. The icons will appear
in the same position as they would on a Macintosh desktop.
Folder location and size on screen, its scroll positions,
folder View (view as Icons, Small Icons, etc.) are also
preserved. (Alpha).</p>

<p style="margin-left:11%;"><b>&minus;root&minus;info</b>
<i>file</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Set the location, size on screen,
scroll positions, folder View etc. for the root folder of an
HFS volume. See <i>README.rootinfo</i> for more information.
(Alpha)</p>

<p style="margin-left:11%;"><b>&minus;prep&minus;boot</b>
<i>file</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) PReP boot image file. Up to 4 are
allowed. See <i>README.prep_boot</i> for more information.
(Alpha)</p>


<p style="margin-left:11%;"><b>&minus;chrp&minus;boot</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Add CHRP boot header.</p>


<p style="margin-left:11%;"><b>&minus;input&minus;hfs&minus;charset</b>
<i>charset</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Input charset that defines the
characters used in HFS filenames when used with
<b>&minus;mac&minus;name</b>. The default charset is
<i>cp10000</i> (Mac Roman).</p>


<p style="margin-left:11%;"><b>&minus;output&minus;hfs&minus;charset</b>
<i>charset</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Output charset that defines the
characters that will be used in the HFS filenames. Defaults
to the input charset.</p>


<p style="margin-left:11%;"><b>&minus;hfs&minus;unlock</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) By default, <b>pycdlib-genisoimage</b>
will create an HFS volume that is locked. This option leaves
the volume unlocked so that other applications (e.g.
<b>hfsutils</b>) can modify the volume.</p>

<p style="margin-left:11%;"><b>&minus;hfs&minus;bless</b>
<i>folder_name</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) &quot;Bless&quot; the given directory
(folder). This is usually the <i>System Folder</i> and is
used in creating HFS bootable CDs. The name of the directory
must be the whole path name as <b>pycdlib-genisoimage</b>
sees it. E.g., if the given pathspec is <i>./cddata</i> and
the required folder is called <i>System Folder</i>, the
whole path name is <i>&quot;/cddata/System Folder&quot;</i>
(remember to use quotes if the name contains spaces).</p>

<p style="margin-left:11%;"><b>&minus;hfs&minus;parms</b>
<i>parameters</i></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Override certain parameters used to
create the HFS filesystem. Unlikely to be used in normal
circumstances.</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="7%">


<p><b>&minus;&minus;cap</b></p></td>
<td width="4%"></td>
<td width="78%">


<p>(not supported by pycdlib-genisoimage) Look for AUFS CAP
Macintosh files. Search for CAP Apple/Unix file formats
only. Searching for the other possible Apple/Unix file
formats is disabled, unless other <i>double dash</i> options
are given.</p></td></tr>
</table>


<p style="margin-left:11%;"><b>&minus;&minus;netatalk</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Look for NETATALK Macintosh files</p>


<p style="margin-left:11%;"><b>&minus;&minus;double</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Look for AppleDouble Macintosh
files</p>


<p style="margin-left:11%;"><b>&minus;&minus;ethershare</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Look for Helios EtherShare Macintosh
files</p>


<p style="margin-left:11%;"><b>&minus;&minus;ushare</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Look for IPT UShare Macintosh files</p>


<p style="margin-left:11%;"><b>&minus;&minus;exchange</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Look for PC Exchange Macintosh
files</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="7%">


<p><b>&minus;&minus;sgi</b></p></td>
<td width="4%"></td>
<td width="78%">


<p>(not supported by pycdlib-genisoimage) Look for SGI
Macintosh files</p></td></tr>
</table>

<p style="margin-left:11%;"><b>&minus;&minus;xinet</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Look for XINET Macintosh files</p>


<p style="margin-left:11%;"><b>&minus;&minus;macbin</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Look for MacBinary Macintosh files</p>


<p style="margin-left:11%;"><b>&minus;&minus;single</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Look for AppleSingle Macintosh
files</p>

<table width="100%" border="0" rules="none" frame="void"
       cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">


<p><b>&minus;&minus;dave</b></p></td>
<td width="2%"></td>
<td width="78%">


<p>(not supported by pycdlib-genisoimage) Look for Thursby
Software Systems DAVE Macintosh files</p></td></tr>
<tr valign="top" align="left">
<td width="11%"></td>
<td width="9%">


<p><b>&minus;&minus;sfm</b></p></td>
<td width="2%"></td>
<td width="78%">


<p>(not supported by pycdlib-genisoimage) Look for
Microsoft&rsquo;s Services for Macintosh files (NT only)
(Alpha)</p> </td></tr>
</table>


<p style="margin-left:11%;"><b>&minus;&minus;osx&minus;double</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Look for Mac OS X AppleDouble Macintosh
files</p>


<p style="margin-left:11%;"><b>&minus;&minus;osx&minus;hfs</b></p>

<p style="margin-left:22%;">(not supported by
pycdlib-genisoimage) Look for Mac OS X HFS Macintosh
files</p>

<h2>SEE ALSO
<a name="SEE ALSO"></a>
</h2>



<p style="margin-left:11%; margin-top: 1em">genisoimage(1),
pycdlib-explorer(1), pycdlib-extract-files(1)</p>

<h2>AUTHOR
<a name="AUTHOR"></a>
</h2>


<p style="margin-left:11%; margin-top: 1em">Chris
Lalancette &lt;clalancette@gmail.com&gt;</p>
<hr>
</body>
</html>