New -as mkisofs option --projid

This commit is contained in:
Thomas Schmitt 2024-11-03 20:13:41 +01:00
parent 32bfa95973
commit 9610de83af
5 changed files with 102 additions and 72 deletions

View File

@ -641,7 +641,7 @@ int Xorriso_genisofs_count_args(struct XorrisO *xorriso, int argc, char **argv,
"-untranslated-filenames", "-verbose", "-version", "-g", "-h",
"-no-mac-files", "-chrp-boot",
"--hardlinks", "--acl", "--xattr", "--xattr-any", "--md5", "--for_backup",
"--lfa_flags",
"--lfa_flags", "--projid",
"--protective-msdos-label", "--boot-catalog-hide", "--no-emul-toc",
"--emul-toc", "-disallow_dir_id_ext", "--old-empty",
"--old-root-no-md5", "--old-root-devno", "--old-root-no-ino",
@ -993,6 +993,7 @@ int Xorriso_genisofs_help(struct XorrisO *xorriso, int flag)
" --xattr Record eventual user space xattr of files",
" --xattr-any Record xattr of any namespace, not only user.",
" --lfa_flags Record Linux file attribute flags (chattr)",
" --projid Record XFS-style project ids",
" --md5 Compute and record MD5 checksums of data files",
" --scdbackup_tag PATH NAME With --md5 record a scdbackup checksum tag",
" --for_backup Use all options which improve backup fidelity",
@ -1849,6 +1850,8 @@ int Xorriso_genisofs(struct XorrisO *xorriso, char *whom,
Xorriso_option_xattr(xorriso, "any", 0);
} else if(strcmp(argpt, "--lfa_flags")==0) {
Xorriso_option_lfa_flags(xorriso, "default:on:no_restore", 0);
} else if(strcmp(argpt, "--projid")==0) {
Xorriso_option_projid(xorriso, "on", 0);
} else if(strcmp(argpt, "--md5")==0) {
Xorriso_option_md5(xorriso, "on", 0);
} else if(strcmp(argpt, "--scdbackup_tag")==0) {
@ -1865,6 +1868,7 @@ int Xorriso_genisofs(struct XorrisO *xorriso, char *whom,
Xorriso_option_md5(xorriso, "on", 0);
if(xorriso->lfa_flags_default & 8)
Xorriso_option_lfa_flags(xorriso, "default:on:no_restore", 0);
Xorriso_option_projid(xorriso, "on", 0);
} else if(strcmp(argpt, "-z")==0 ||
strcmp(argpt, "-transparent-compression")==0) {
@ -2291,6 +2295,7 @@ not_enough_args:;
strcmp(argpt, "--xattr")==0 ||
strcmp(argpt, "--xattr-any")==0 ||
strcmp(argpt, "--lfa_flags")==0 ||
strcmp(argpt, "--projid")==0 ||
strcmp(argpt, "--md5")==0 ||
strcmp(argpt, "--for_backup")==0) {
/* was already handled in first argument scan */;

View File

@ -1 +1 @@
#define Xorriso_timestamP "2024.11.03.190355"
#define Xorriso_timestamP "2024.11.03.191323"

View File

@ -9,7 +9,7 @@
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH XORRISOFS 1 "Version 1.5.7, Oct 06, 2024"
.TH XORRISOFS 1 "Version 1.5.7, Nov 01, 2024"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
@ -680,7 +680,8 @@ Alias of \-rr_reloc_dir "/.rr_moved"
Enable all options which improve backup fidelity:
.br
\-\-acl, \-\-xattr\-any, \-\-md5,
\-\-hardlinks, and possibly \-\-lfa_flags.
\-\-hardlinks, \-\-projid,
and possibly \-\-lfa_flags.
.br
If you later restore a backup with xattr from non\-user namespaces, then make
sure that the target operating system and filesystem know what these attributes
@ -726,6 +727,10 @@ gets ended and files get restored to disk. If restoring of the attributes is
desired in this case, execute xorriso command \-lfa_flags "restore" with
possibly appended mode texts like ":restore_mask=aAcdDijmPsStTux".
.TP
\fB--projid\fR
Enable recording and loading of XFS\-style project ids as described in
man 5 xfs_quota or man 5 ext4.
.TP
\fB--md5\fR
.br
Enable recording of MD5 checksums for the overall ISO image and for each
@ -2301,13 +2306,15 @@ Programs which burn sessions to optical media
.BR cdrskin(1),
.BR xorriso(1)
.TP
ACL, xattr, Linux file attributes
ACL, xattr, Linux file attributes, project ids
.BR getfacl(1),
.BR setfacl(1),
.BR getfattr(1),
.BR setfattr(1),
.BR lsattr(1),
.BR chattr(1)
.BR chattr(1),
.BR ext4(5),
.BR xfs_quota(8)
.TP
MD5 checksums
.BR md5sum(1)

View File

@ -617,7 +617,8 @@ File: xorrisofs.info, Node: SetExtras, Next: SetHide, Prev: SetCompl, Up: Op
Alias of -rr_reloc_dir "/.rr_moved"
--for_backup
Enable all options which improve backup fidelity:
--acl, --xattr-any, --md5, --hardlinks, and possibly --lfa_flags.
--acl, --xattr-any, --md5, --hardlinks, --projid, and possibly
--lfa_flags.
If you later restore a backup with xattr from non-user namespaces,
then make sure that the target operating system and filesystem know
what these attributes mean. Possibly you will need administrator
@ -657,6 +658,9 @@ File: xorrisofs.info, Node: SetExtras, Next: SetHide, Prev: SetCompl, Up: Op
of the attributes is desired in this case, execute xorriso command
-lfa_flags "restore" with possibly appended mode texts like
":restore_mask=aAcdDijmPsStTux".
--projid
Enable recording and loading of XFS-style project ids as described
in man 5 xfs_quota or man 5 ext4.
--md5
Enable recording of MD5 checksums for the overall ISO image and for
@ -2005,8 +2009,8 @@ Other programs which produce ISO 9660 images
Programs which burn sessions to optical media
growisofs(1), cdrecord(1), wodim(1), cdrskin(1), xorriso(1)
ACL and xattr
getfacl(1), setfacl(1), getfattr(1), setfattr(1) lsattr(1),
chattr(1)
getfacl(1), setfacl(1), getfattr(1), setfattr(1), lsattr(1),
chattr(1), ext4(5), xfs_quota(8)
MD5 checksums
md5sum(1)
On FreeBSD some commands differ:
@ -2068,7 +2072,7 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
[index]
* Menu:
* --acl Recording of ACLs: SetExtras. (line 106)
* --acl Recording of ACLs: SetExtras. (line 107)
* --application_use set Application Use field: ImageId. (line 79)
* --boot-catalog-hide Hide El Torito boot catalog: Bootable. (line 121)
* --efi-boot El Torito EFI boot image: Bootable. (line 59)
@ -2082,11 +2086,11 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* --grub2-boot-info Patch El Torito boot image: Bootable. (line 109)
* --grub2-mbr Install modern GRUB2 MBR: SystemArea. (line 81)
* --grub2-sparc-core SUN SPARC core file: SystemArea. (line 325)
* --hardlinks Recording of hardlink relations: SetExtras. (line 142)
* --lfa_flags Recording of Linux file attributes: SetExtras. (line 125)
* --hardlinks Recording of hardlink relations: SetExtras. (line 146)
* --lfa_flags Recording of Linux file attributes: SetExtras. (line 126)
* --mbr-force-bootable Enforce MBR bootable/active flag: SystemArea.
(line 148)
* --md5 Recording of MD5 checksums: SetExtras. (line 134)
* --md5 Recording of MD5 checksums: SetExtras. (line 138)
* --modification-date set ISO image timestamps: ImageId. (line 70)
* --no-emul-toc no table-of-content emulation: SetProduct. (line 41)
* --norock disable Rock Ridge production: SetExtras. (line 28)
@ -2098,11 +2102,12 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* --old-root-no-ino disable disk ino with -old-root: SetInsert.
(line 103)
* --old-root-no-md5 disable MD5 with -old-root: SetInsert. (line 121)
* --projid Recording of XFS-style project ids: SetExtras. (line 135)
* --protective-msdos-label Patch System Area partition table: SystemArea.
(line 143)
* --quoted_path_list read pathspecs from disk file: SetInsert.
(line 12)
* --scdbackup_tag Recording of MD5 checksum: SetExtras. (line 150)
* --scdbackup_tag Recording of MD5 checksum: SetExtras. (line 154)
* --set_all_file_dates set all file timestamps: SetExtras. (line 35)
* --sort-weight set block address sorting weight: SetProduct. (line 45)
* --sort-weight-list set block address sorting weight: SetProduct.
@ -2111,8 +2116,8 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
(line 76)
* --stdio_sync control forced output to disk files: SetProduct.
(line 23)
* --xattr Recording of any xattr: SetExtras. (line 119)
* --xattr Recording of user xattr: SetExtras. (line 112)
* --xattr Recording of any xattr: SetExtras. (line 120)
* --xattr Recording of user xattr: SetExtras. (line 113)
* --zisofs-version-2 enable recognition of zisofs2 files: SetInsert.
(line 65)
* --zisofs2-susp-z2 produce Z2 for version 2 instead of ZF: SetInsert.
@ -2182,15 +2187,15 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
(line 44)
* -hard-disk-boot El Torito boot image emulation: Bootable. (line 83)
* -help list supported options: Miscellaneous. (line 36)
* -hfs-bless HFS+ blessing ppc_bootdir: SetExtras. (line 233)
* -hfs-bless-by HFS+ blessing: SetExtras. (line 223)
* -hfsplus enable production of HFS+ partition: SetExtras. (line 176)
* -hfsplus-block-size set APM block size: SetExtras. (line 213)
* -hfs-bless HFS+ blessing ppc_bootdir: SetExtras. (line 237)
* -hfs-bless-by HFS+ blessing: SetExtras. (line 227)
* -hfsplus enable production of HFS+ partition: SetExtras. (line 180)
* -hfsplus-block-size set APM block size: SetExtras. (line 217)
* -hfsplus-block-size set HFS+ allocation block size: SetExtras.
(line 209)
(line 213)
* -hfsplus-file-creator-type HFS+ creator-type attribute: SetExtras.
(line 220)
* -hfsplus-serial-no set HFS+ serial number: SetExtras. (line 205)
(line 224)
* -hfsplus-serial-no set HFS+ serial number: SetExtras. (line 209)
* -hide keep matching files invisible in ISO tree: SetHide. (line 8)
* -hide-hfsplus keep matching files invisible in HFS+ tree: SetHide.
(line 25)
@ -2221,7 +2226,7 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -isohybrid-mbr Install ISOLINUX isohybrid MBR: SystemArea. (line 87)
* -iso_mbr_part_type Set type of ISO MBR partition: SystemArea.
(line 129)
* -J enable production of Joliet directory tree: SetExtras. (line 159)
* -J enable production of Joliet directory tree: SetExtras. (line 163)
* -jigdo-checksum-algorithm set data file checksum algorithm: Jigdo.
(line 42)
* -jigdo-exclude add exclusion pattern for checksum file: Jigdo.
@ -2237,9 +2242,9 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -jigdo-template-compress choose compression algorithm: Jigdo.
(line 83)
* -joliet enable production of Joliet directory tree: SetExtras.
(line 163)
* -joliet-long allow longer Joliet names: SetExtras. (line 165)
* -joliet-utf16 use UTF-16 with Joliet names: SetExtras. (line 171)
(line 167)
* -joliet-long allow longer Joliet names: SetExtras. (line 169)
* -joliet-utf16 use UTF-16 with Joliet names: SetExtras. (line 175)
* -l allow 31 characters in ISO file names: SetCompl. (line 57)
* -log-file redirect stderr messages: Miscellaneous. (line 48)
* -m exclude disk files from inserting: SetInsert. (line 41)
@ -2318,7 +2323,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Menu:
* Abstract File, set path, -abstract: ImageId. (line 57)
* ACL, record and load, --acl: SetExtras. (line 106)
* ACL, record and load, --acl: SetExtras. (line 107)
* APM, mark appended partitions, -appended_part_as_apm: SystemArea.
(line 253)
* APM, _definition: SystemArea. (line 16)
@ -2421,14 +2426,14 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
(line 238)
* GPT, _definition: SystemArea. (line 13)
* Group, for all files, -gid: SetProduct. (line 83)
* HFS+, enables production: SetExtras. (line 176)
* HFS+, issue blessing ppc_bootdir, -hfs-bless: SetExtras. (line 233)
* HFS+, issue blessing, -hfs-bless-by: SetExtras. (line 223)
* HFS+, set allocation block size: SetExtras. (line 209)
* HFS+, set APM block size: SetExtras. (line 213)
* HFS+, enables production: SetExtras. (line 180)
* HFS+, issue blessing ppc_bootdir, -hfs-bless: SetExtras. (line 237)
* HFS+, issue blessing, -hfs-bless-by: SetExtras. (line 227)
* HFS+, set allocation block size: SetExtras. (line 213)
* HFS+, set APM block size: SetExtras. (line 217)
* HFS+, set creator and type of file, -hfsplus-file-creator-type: SetExtras.
(line 220)
* HFS+, set serial number: SetExtras. (line 205)
(line 224)
* HFS+, set serial number: SetExtras. (line 209)
* HFS+, _definition: Standards. (line 34)
* Hiding, by ISO RR path, -hide_iso_path: SetHide. (line 31)
* Hiding, from HFS+, -hide-hfsplus: SetHide. (line 25)
@ -2491,18 +2496,18 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Jigdo Template Extraction, -jigdo-template-compress: Jigdo. (line 83)
* Jigdo Template Extraction, -md5-list: Jigdo. (line 81)
* Jigdo Template Extraction, _definition: Jigdo. (line 6)
* Joliet, allows longer names, -joliet-long: SetExtras. (line 165)
* Joliet, enable, -J, -joliet: SetExtras. (line 159)
* Joliet, allows longer names, -joliet-long: SetExtras. (line 169)
* Joliet, enable, -J, -joliet: SetExtras. (line 163)
* Joliet, _definition: Standards. (line 21)
* Links, follow on disk, -f, -follow-links: SetInsert. (line 32)
* Links, record and load hard links, --hardlinks: SetExtras. (line 142)
* Links, record and load hard links, --hardlinks: SetExtras. (line 146)
* Linux file attributes, record and load, --lfa_flags: SetExtras.
(line 125)
(line 126)
* MBR, GPT, append partition, -append_partition: SystemArea. (line 208)
* MBR, sectors per head, -partition_sec_hd: SystemArea. (line 180)
* MBR, sectors per head, -partition_sec_hd <1>: SystemArea. (line 183)
* MBR, _definition: SystemArea. (line 9)
* MD5, record and load, --md5: SetExtras. (line 134)
* MD5, record and load, --md5: SetExtras. (line 138)
* Message output, increase frequency, -gui: Miscellaneous. (line 44)
* Message output, redirect stderr, -log-file: Miscellaneous. (line 48)
* Message output, suppress, -quiet: Miscellaneous. (line 40)
@ -2530,7 +2535,7 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
(line 16)
* Rock Ridge, disable production, --norock: SetExtras. (line 28)
* Rock Ridge, _definition: Standards. (line 14)
* scdbackup, record checksum tag, --scdbackup_tag: SetExtras. (line 150)
* scdbackup, record checksum tag, --scdbackup_tag: SetExtras. (line 154)
* Session, select path, -M, -prev-session, -dev: Loading. (line 11)
* Session, set load and write address, -C, -cdrecord-params: Loading.
(line 25)
@ -2539,12 +2544,14 @@ File: xorrisofs.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* System Id, set, -sysid: ImageId. (line 43)
* Table-of-content, emulation off, --no-emul-toc: SetProduct. (line 41)
* Table-of-content, emulation, --emul-toc: SetProduct. (line 33)
* UTF-16, for Joliet paths, -joliet-utf16: SetExtras. (line 171)
* UTF-16, for Joliet paths, -joliet-utf16: SetExtras. (line 175)
* Verbosity, high, -v, -verbose: Miscellaneous. (line 53)
* Volume Id, set, -V, -volid: ImageId. (line 13)
* Volume Set Id, set, -volset: ImageId. (line 25)
* xattr, record and load, --xattr: SetExtras. (line 112)
* xattr, record and load, --xattr-any: SetExtras. (line 119)
* xattr, record and load, --xattr: SetExtras. (line 113)
* xattr, record and load, --xattr-any: SetExtras. (line 120)
* XFS-style project ids, record and load, --projid: SetExtras.
(line 135)
* xorriso, mkisofs emulation: Xorriso. (line 6)
* xorriso, options: Options. (line 6)
* Z2 instead of ZF for version 2, -zisofs2-susp-z2: SetInsert.
@ -2570,27 +2577,27 @@ Node: SetInsert9638
Node: SetProduct15573
Node: SetCompl21145
Node: SetExtras23818
Node: SetHide36075
Node: ImageId38074
Node: Bootable42356
Node: SystemArea48642
Node: Charset68370
Node: Jigdo69395
Node: Miscellaneous74365
Node: Examples76961
Node: ExSimple77455
Node: ExGraft77938
Node: ExMkisofs79238
Node: ExGrowisofs81046
Node: ExIncBackup82236
Node: ExIncBckAcc85412
Node: ExBootable87117
Node: Files91299
Node: Environ92394
Node: Seealso93267
Node: Bugreport93944
Node: Legal94537
Node: CommandIdx95434
Node: ConceptIdx112794
Node: SetHide36210
Node: ImageId38209
Node: Bootable42491
Node: SystemArea48777
Node: Charset68505
Node: Jigdo69530
Node: Miscellaneous74500
Node: Examples77096
Node: ExSimple77590
Node: ExGraft78073
Node: ExMkisofs79373
Node: ExGrowisofs81181
Node: ExIncBackup82371
Node: ExIncBckAcc85547
Node: ExBootable87252
Node: Files91434
Node: Environ92529
Node: Seealso93402
Node: Bugreport94103
Node: Legal94696
Node: CommandIdx95593
Node: ConceptIdx113026

End Tag Table

View File

@ -50,7 +50,7 @@
@c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
@c man .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRISOFS 1 "Version 1.5.7, Oct 06, 2024"
@c man .TH XORRISOFS 1 "Version 1.5.7, Nov 01, 2024"
@c man .\" Please adjust this date whenever revising the manpage.
@c man .\"
@c man .\" Some roff macros, for reference:
@ -946,7 +946,8 @@ Alias of -rr_reloc_dir "/.rr_moved"
Enable all options which improve backup fidelity:
@*
@minus{}@minus{}acl, @minus{}@minus{}xattr-any, @minus{}@minus{}md5,
@minus{}@minus{}hardlinks, and possibly @minus{}@minus{}lfa_flags.
@minus{}@minus{}hardlinks, @minus{}@minus{}projid,
and possibly @minus{}@minus{}lfa_flags.
@*
If you later restore a backup with xattr from non-user namespaces, then make
sure that the target operating system and filesystem know what these attributes
@ -1000,6 +1001,12 @@ gets ended and files get restored to disk. If restoring of the attributes is
desired in this case, execute xorriso command -lfa_flags "restore" with
possibly appended mode texts like ":restore_mask=aAcdDijmPsStTux".
@c man .TP
@item @minus{}@minus{}projid
@kindex @minus{}@minus{}projid Recording of XFS-style project ids
@cindex XFS-style project ids, record and load, @minus{}@minus{}projid
Enable recording and loading of XFS-style project ids as described in
man 5 xfs_quota or man 5 ext4.
@c man .TP
@item @minus{}@minus{}md5
@kindex @minus{}@minus{}md5 Recording of MD5 checksums
@cindex MD5, record and load, @minus{}@minus{}md5
@ -2946,13 +2953,15 @@ Startup files and program options can override the effect of SOURCE_DATE_EPOCH.
@c man .BR cdrskin(1),
@c man .BR xorriso(1)
@c man .TP
@c man ACL, xattr, Linux file attributes
@c man ACL, xattr, Linux file attributes, project ids
@c man .BR getfacl(1),
@c man .BR setfacl(1),
@c man .BR getfattr(1),
@c man .BR setfattr(1),
@c man .BR lsattr(1),
@c man .BR chattr(1)
@c man .BR chattr(1),
@c man .BR ext4(5),
@c man .BR xfs_quota(8)
@c man .TP
@c man MD5 checksums
@c man .BR md5sum(1)
@ -2984,9 +2993,11 @@ xorriso(1)
getfacl(1),
setfacl(1),
getfattr(1),
setfattr(1)
setfattr(1),
lsattr(1),
chattr(1)
chattr(1),
ext4(5),
xfs_quota(8)
@item MD5 checksums
md5sum(1)
@item On FreeBSD some commands differ: