-
Notifications
You must be signed in to change notification settings - Fork 39
/
Copy pathpycdlib-genisoimage.html
2632 lines (1964 loc) · 87.9 KB
/
pycdlib-genisoimage.html
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
<!-- Creator : groff version 1.23.0 -->
<!-- CreationDate: Sun Mar 2 21:34:04 2025 -->
<!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:9%; margin-top: 1em">pycdlib-genisoimage
- tool to master ISOs using pycdlib</p>
<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</h2>
<p style="margin-left:9%; margin-top: 1em"><b>pycdlib-genisoimage
[options] [-o filename] pathspec [pathspec ...]</b></p>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>
<p style="margin-left:9%; 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:9%; margin-top: 1em"><b>−abstract</b>
<i>file</i></p>
<p style="margin-left:18%;">Specifies the abstract
filename. There is space for 37 characters.</p>
<p style="margin-left:9%;"><b>−A</b>
<i>application_id</i> <b><br>
−appid</b> <i>application_id</i></p>
<p style="margin-left:18%;">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:9%;"><b>−allow−limited−size</b></p>
<p style="margin-left:18%;">(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>−udf.</b></p>
<p style="margin-left:9%;"><b>−allow−leading−dots</b></p>
<table width="100%" border="0" rules="none" frame="void"
cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="9%"></td>
<td width="8%">
<p><b>−ldots</b></p></td>
<td width="1%"></td>
<td width="82%">
<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:18%;">This violates the ISO9660
standard, but it happens to work on many systems. Use with
caution.</p>
<p style="margin-left:9%;"><b>−allow−lowercase</b></p>
<p style="margin-left:18%;">(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:9%;"><b>−allow−multidot</b></p>
<p style="margin-left:18%;">(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>−allow−leading−dots</b>. <br>
This violates the ISO9660 standard, but it happens to work
on many systems. Use with caution.</p>
<p style="margin-left:9%;"><b>−biblio</b>
<i>file</i></p>
<p style="margin-left:18%;">Specifies the bibliographic
filename. There is space for 37 characters.</p>
<p style="margin-left:9%;"><b>−cache−inodes
<br>
−no−cache−inodes</b></p>
<p style="margin-left:18%;">(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>−cache−inodes</b> is default on
Unix-like operating systems, but
<b>−no−cache−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
−cache−inodes</b> will not behave correctly.
<b>−no−cache−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:9%;"><b>−alpha−boot</b>
<i>alpha_boot_image</i></p>
<p style="margin-left:18%;">(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:9%;"><b>−hppa−bootloader</b>
<i>hppa_bootloader_image</i></p>
<p style="margin-left:18%;">(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:9%;"><b>−hppa−cmdline</b>
<i>hppa_boot_command_line</i></p>
<p style="margin-left:18%;">(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:9%;"><b>−hppa−kernel−32</b>
<i>hppa_kernel_32</i> <b><br>
−hppa−kernel−64</b>
<i>hppa_kernel_64</i></p>
<p style="margin-left:18%;">(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:9%;"><b>−hppa−ramdisk</b>
<i>hppa_ramdisk_image</i></p>
<p style="margin-left:18%;">(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:9%;"><b>−mips−boot</b>
<i>mips_boot_image</i></p>
<p style="margin-left:18%;">(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:9%;"><b>−mipsel−boot</b>
<i>mipsel_boot_image</i></p>
<p style="margin-left:18%;">(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:9%;"><b>−B</b>
<i>img_sun4,img_sun4c,img_sun4m,img_sun4d,img_sun4e</i>
<b><br>
−sparc−boot</b>
<i>img_sun4,img_sun4c,img_sun4m,img_sun4d,img_sun4e</i></p>
<p style="margin-left:18%;">(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>−B</b> or
<b>−sparc−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:18%; 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:18%; 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>−G</b>
<i>image</i> <b>−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:9%;"><b>−G</b>
<i>generic_boot_image</i></p>
<p style="margin-left:18%;">(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>−sparc−boot</b>, the Sun disk label will
overlay the first 512 bytes of the generic boot image.</p>
<p style="margin-left:9%;"><b>−b</b>
<i>eltorito_boot_image</i> <b><br>
−eltorito−boot</b>
<i>eltorito_boot_image</i></p>
<p style="margin-left:18%;">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:18%; margin-top: 1em">If the boot
image is not an image of a floppy, you need to add either
<b>−hard−disk−boot</b> or
<b>−no−emul−boot</b>. If the system should
not boot off the emulated disk, use
<b>−no−boot</b>.</p>
<p style="margin-left:18%; margin-top: 1em">If
<b>−sort</b> has not been specified, the boot images
are sorted with low priority (+2) to the beginning of the
medium. If you don’t like this, you need to specify a
sort weight of 0 for the boot images.</p>
<p style="margin-left:9%;"><b>−eltorito−alt−boot</b></p>
<p style="margin-left:18%;">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:9%;"><b>−hard−disk−boot</b></p>
<p style="margin-left:18%;">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:9%;"><b>−eltorito−platform</b>
<i>id</i></p>
<p style="margin-left:18%;">(not supported by
pycdlib-genisoimage) Set the "El Torito" 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="18%"></td>
<td width="4%">
<p><b>x86</b></p></td>
<td width="5%"></td>
<td width="73%">
<p>This is the default <i>platform id</i> value and
specifies entries for the PC platform. If no
<b>−eltorito−platform</b> option appears before
the first <b>−eltorito−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="18%"></td>
<td width="4%">
<p><b>PPC</b></p></td>
<td width="5%"></td>
<td width="73%">
<p>Boot entries for the Power PC platform.</p></td></tr>
<tr valign="top" align="left">
<td width="18%"></td>
<td width="4%">
<p><b>Mac</b></p></td>
<td width="5%"></td>
<td width="73%">
<p>Boot entries for the Apple Mac platform.</p></td></tr>
<tr valign="top" align="left">
<td width="18%"></td>
<td width="4%">
<p><b>efi</b></p></td>
<td width="5%"></td>
<td width="73%">
<p>Boot entries for EFI based PCs.</p></td></tr>
<tr valign="top" align="left">
<td width="18%"></td>
<td width="4%">
<p><b>#</b></p></td>
<td width="5%"></td>
<td width="73%">
<p>A numeric value specifying any platform id.</p></td></tr>
</table>
<p style="margin-left:18%; margin-top: 1em">If the option
<b>−eltorito−platform</b> appears before the
first <b>−eltorito−boot</b> option, it sets the
<i>platform id</i> for the default boot entry.</p>
<p style="margin-left:18%; margin-top: 1em">If the option
<b>−eltorito−platform</b> appears after an
<b>−eltorito−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:18%; 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:9%;"><b>−ignore−error</b></p>
<p style="margin-left:18%;">(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:9%;"><b>−no−emul−boot</b></p>
<p style="margin-left:18%;">Specifies that the boot image
used to create El Torito bootable CDs is a "no
emulation" image. The system will load and execute this
image without performing any disk emulation.</p>
<p style="margin-left:9%;"><b>−no−boot</b></p>
<p style="margin-left:18%;">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:9%;"><b>−boot−load−seg</b>
<i>segment_address</i></p>
<p style="margin-left:18%;">Specifies the load segment
address of the boot image for no-emulation El Torito
CDs.</p>
<p style="margin-left:9%;"><b>−boot−load−size</b>
<i>load_sectors</i></p>
<p style="margin-left:18%;">Specifies the number of
"virtual" (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:9%;"><b>−boot−info−table</b></p>
<p style="margin-left:18%;">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:9%;"><b>−C</b>
<i>last_sess_start,next_sess_start</i> <b><br>
−cdrecord−params</b>
<i>last_sess_start,next_sess_start</i></p>
<p style="margin-left:18%;">(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>−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 −msinfo ...</b> If <b>−C</b> is used in
conjunction with <b>−M</b>, <b>pycdlib-genisoimage</b>
will create a filesystem image that is intended to be a
continuation of the previous session. If <b>−C</b> is
used without <b>−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:9%;"><b>−c</b>
<i>boot_catalog</i> <b><br>
−eltorito−catalog</b> <i>boot_catalog</i></p>
<p style="margin-left:18%;">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:18%; margin-top: 1em">If
<b>−sort</b> has not been specified, the boot catalog
sorted with low priority (+1) to the beginning of the
medium. If you don’t like this, you need to specify a
sort weight of 0 for the boot catalog.</p>
<p style="margin-left:9%;"><b>−check−oldnames</b></p>
<p style="margin-left:18%;">(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:9%;"><b>−check−session</b>
<i>file</i></p>
<p style="margin-left:18%;">(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>−M</b> <i>file</i> <b>−C 0,0
−check−oldnames</b>. For the parameter
<i>file</i>, see the description of <b>−M</b>.</p>
<p style="margin-left:9%;"><b>−checksum_algorithm_iso</b>
<i>alg1,alg2,...</i></p>
<p style="margin-left:18%;">(not supported by
pycdlib-genisoimage) Specify the checksum types desired for
the output image.</p>
<p style="margin-left:9%;"><b>−checksum_algorithm_template</b>
<i>alg1,alg2,...</i></p>
<p style="margin-left:18%;">(not supported by
pycdlib-genisoimage) Specify the checksum types desired for
the output jigdo template.</p>
<p style="margin-left:9%;"><b>−copyright</b>
<i>file</i></p>
<p style="margin-left:18%;">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="9%"></td>
<td width="3%">
<p><b>−d</b></p></td>
<td width="88%">
</td></tr>
</table>
<p style="margin-left:9%; margin-top: 1em"><b>−omit−period</b></p>
<p style="margin-left:18%;">(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="9%"></td>
<td width="3%">
<p><b>−D</b></p></td>
<td width="88%">
</td></tr>
</table>
<p style="margin-left:9%; margin-top: 1em"><b>−disable−deep−relocation</b></p>
<p style="margin-left:18%;">(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:9%;"><b>−data−change−warn</b></p>
<p style="margin-left:18%;">(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="9%"></td>
<td width="8%">
<p><b>−debug</b></p></td>
<td width="1%"></td>
<td width="69%">
<p>(not supported by pycdlib-genisoimage) Set debug
flag.</p> </td>
<td width="13%">
</td></tr>
</table>
<p style="margin-left:9%;"><b>−dir−mode</b>
<i>mode</i></p>
<p style="margin-left:18%;">(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:9%;"><b>−dvd−video</b></p>
<p style="margin-left:18%;">(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:18%; 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:9%;"><b>−e</b>
<i>efi_boot_file</i> <b><br>
−efi−boot</b> <i>efi_boot_file</i></p>
<p style="margin-left:18%;">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="9%"></td>
<td width="3%">
<p><b>−f</b></p></td>
<td width="88%">
</td></tr>
</table>
<p style="margin-left:9%; margin-top: 1em"><b>−follow−links</b></p>
<p style="margin-left:18%;">(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:9%;"><b>−file−mode</b>
<i>mode</i></p>
<p style="margin-left:18%;">(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="9%"></td>
<td width="6%">
<p><b>−find</b></p></td>
<td width="3%"></td>
<td width="82%">
<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>−find</b>
option. To the right of the <b>−find</b> option,
<b>pycdlib-genisoimage</b> accepts the <b>find</b> command
line syntax only.</p></td></tr>
</table>
<p style="margin-left:18%; 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:18%; 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="18%"></td>
<td width="6%">
<p style="margin-top: 1em"><b>−help</b></p></td>
<td width="3%"></td>
<td width="45%">
<p style="margin-top: 1em">Lists the available
<b>find</b>(1) syntax.</p></td>
<td width="28%">
</td></tr>
</table>
<p style="margin-left:18%;"><b>−chgrp</b>
<i>gname</i></p>
<p style="margin-left:27%;">The primary always evaluates as
true; it sets the group of the file to <i>gname</i>.</p>
<p style="margin-left:18%;"><b>−chmod</b>
<i>mode</i></p>
<p style="margin-left:27%;">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:18%;"><b>−chown</b>
<i>uname</i></p>
<p style="margin-left:27%;">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="18%"></td>
<td width="8%">
<p><b>−false</b></p></td>
<td width="1%"></td>
<td width="73%">
<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="18%"></td>
<td width="8%">
<p><b>−true</b></p></td>
<td width="1%"></td>
<td width="73%">
<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:18%; margin-top: 1em">The command
line:</p>
<p style="margin-left:18%; margin-top: 1em"><b>pycdlib-genisoimage
-o o.iso -find . ( -type d -ls -o false ) -o ! -type
d</b></p>
<p style="margin-left:18%; margin-top: 1em">lists all
directories and puts all non-directories to the image
<b>o.iso</b>.</p>
<p style="margin-left:18%; margin-top: 1em">The command
line:</p>
<p style="margin-left:18%; margin-top: 1em"><b>pycdlib-genisoimage
-o o.iso -find . ( -type d -chown root -o true )</b></p>
<p style="margin-left:18%; 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:18%; margin-top: 1em">Note that the
<b>−ls</b>, <b>−exec</b> and the
<b>−ok</b> primary cannot be used if <b>stdin</b> or
stdout has not been redirected.</p>
<p style="margin-left:9%;"><b>−gid</b> <i>gid</i></p>
<p style="margin-left:18%;">(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="9%"></td>
<td width="5%">
<p><b>−gui</b></p></td>
<td width="4%"></td>
<td width="82%">
<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:9%;"><b>−graft−points</b></p>
<p style="margin-left:18%;">(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 ‘\’ and
‘=’ characters must be escaped with
‘\’ if <b>−graft−points</b> has been
specified.</p>
<p style="margin-left:9%;"><b>−hide</b>
<i>glob</i></p>
<p style="margin-left:18%;">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 ‘/’ character. All the
hidden files will still be written to the output CD image
file. See also <b>−hide−joliet</b>, and
<i>README.hide</i>. This option may be used multiple
times.</p>
<p style="margin-left:9%;"><b>−hide−list</b>
<i>file</i></p>
<p style="margin-left:18%;">A file containing a list of
shell wildcards to be hidden. See <b>−hide</b>.</p>
<p style="margin-left:9%;"><b>−hidden</b>
<i>glob</i></p>
<p style="margin-left:18%;">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
‘/’ character. This option may be used multiple
times.</p>
<p style="margin-left:9%;"><b>−hidden−list</b>
<i>file</i></p>
<p style="margin-left:18%;">A file containing a list of
shell wildcards to get the hidden attribute. See
<b>−hidden</b>.</p>
<p style="margin-left:9%;"><b>−hide−joliet</b>
<i>glob</i></p>
<p style="margin-left:18%;">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 ‘/’ character. All the hidden
files will still be written to the output CD image file.
This option is usually used with <b>−hide</b>. See
also <i>README.hide</i>. This option may be used multiple
times.</p>
<p style="margin-left:9%;"><b>−hide−joliet−list</b>
<i>file</i></p>
<p style="margin-left:18%;">A file containing a list of
shell wildcards to be hidden from the Joliet tree. See
<b>−hide−joliet</b>.</p>
<p style="margin-left:9%;"><b>−hide−joliet−trans−tbl</b></p>
<p style="margin-left:18%;">(not supported by
pycdlib-genisoimage) Hide the <i>TRANS.TBL</i> files from
the Joliet tree. These files usually don’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:9%;"><b>−hide−rr−moved</b></p>
<p style="margin-left:18%;">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’t know what this directory is for. If you need
to have no <i>RR_MOVED</i> directory at all, you should use
<b>−D</b>. Note that if <b>−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:9%;"><b>−hide−udf</b>
<i>glob</i></p>
<p style="margin-left:18%;">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
’/’ character. All the hidden files will still
be written to the output CD image file. Should be used with