Commit 94e6000d authored by Thomas Schmitt's avatar Thomas Schmitt

New option -for_backup as shortcut for -acl -xattr -hardlinks

parent 7aee4b45
......@@ -2,7 +2,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 XORRISO 1 "May 26, 2009"
.TH XORRISO 1 "May 29, 2009"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
......@@ -683,7 +683,7 @@ Whether these numbers are respected at mount time depends on the operating
system.
.br
xorriso commands which extract files from an ISO image try to restore files
with the same inode number as hardlinks. This applies only to files which
with the same inode number as hard links. This applies only to files which
get extracted during execution of that same command. A large number of
hardlink families may exhaust -temp_mem_limit if not -osirrox option
"sort_lba_on" is in effect.
......@@ -706,6 +706,11 @@ Enable or disable processing of xattr attributes in user namespace.
If enabled, then xorriso will handle xattr similar to ACL.
See also options -getfattr, -setfattr and above paragraph about xattr.
.TP
\fB\-for_backup\fR
Enable all extra features which help to produce or to restore backups with
highest fidelity of file properties.
Currently this is a shortcut for: -hardlinks on -acl on -xattr on .
.TP
\fB\-disk_dev_ino\fR "on"|"ino_only"|"off"
Enable or disable processing of recorded file identification numbers
(dev_t and ino_t). They are eventually stored as xattr and allow
......@@ -2622,7 +2627,7 @@ are owned by the effective user who runs xorriso. This happens by temporarily
granting rwx permission to the owner.
.br
Option "sort_lba_on" may improve read performance with optical drives. It
allows to restore large numbers of hardlinks without exhausting
allows to restore large numbers of hard links without exhausting
-temp_mem_limit. It does not preserve directory mtime and it needs
-osirrox option auto_chmod_on in order to extract directories which offer no
write permission. Default is "sort_lba_off".
......@@ -2750,7 +2755,8 @@ arguments or if other start arguments pointed the output drive to
standard output.
.br
Not original mkisofs options are --quoted_path_list (see -quoted_path_list),
isolinux_mbr= (see -boot_image isolinux isohybrid=), --acl (see -acl "on"),
isolinux_mbr= (see -boot_image isolinux isohybrid=),
--hardlinks (see -hardlinks "on") --acl (see -acl "on"),
--xattr (see -xattr "on").
.br
Personalites "\fBxorrisofs\fR", "\fBgenisoimage\fR", and "\fBgenisofs\fR"
......@@ -2904,7 +2910,7 @@ Mode "on" is
\fB\-temp_mem_limit\fR number["k"|"m"]
Set the maximum size of temporary memory to be used for image dependent
buffering. Currently this applies to pattern expansion, LBA sorting,
restoring of hardlinks.
restoring of hard links.
.br
Default is 16m = 16 MiB, minimum 64k = 64 kiB, maximum 1024m = 1 GiB.
.TP
......@@ -3325,14 +3331,14 @@ in the ISO image so that they become exact copies of their disk counterparts.
ISO file objects get created, deleted or get their attributes adjusted
accordingly.
.br
ACL and xattr will be recorded. Accelerated comparison is enabled at the
expense of potentially larger backup size.
ACL, xattr and hard links will be recorded. Accelerated comparison is enabled
at the expense of potentially larger backup size.
Only media with the expected volume id or blank media are accepted.
Files with names matching *.o or *.swp get excluded explicitely.
.br
\fB$\fR xorriso \\
.br
-acl on -xattr on -disk_dev_ino on \\
-for_backup -disk_dev_ino on \\
.br
-assert_volid 'PROJECTS_MAIL_*' FATAL \\
.br
......@@ -3402,9 +3408,10 @@ First check which backup sessions are on the media:
\fB$\fR xorriso -outdev /dev/sr0 -toc
.br
Then load the desired session and copy the file trees to disk.
Enable restoring of ACL, xattr and hard links.
Avoid to eventually create /home/thomas/restored without rwx-permission.
.br
\fB$\fR xorriso -acl on -xattr on \\
\fB$\fR xorriso -for_backup \\
.br
-load volid 'PROJECTS_MAIL_2008_06_19*' \\
.br
......
......@@ -10730,9 +10730,9 @@ int Xorriso_cdrskin(struct XorrisO *xorriso, char *whom, int argc, char **argv,
"\t-isosize\tUse iso9660 file system size for next data track",
"\t-pad\t\tpadsize=30k",
"\t-nopad\t\tDo not pad",
"\t--grow_overwriteable_iso\temulate multi-session on DVD+RW",
"\twrite_start_address=#\t\twrite to given byte address on DVD+RW",
"\tstream_recording=on\t\ttry to get full speed DVD-RAM and BD-RE",
"\t--grow_overwriteable_iso\temulate multi-session on DVD+RW, BD-RE",
"\twrite_start_address=#\t\twrite to byte address on DVD+RW, BD-RE",
"\tstream_recording=on\t\ttry to get full speed on DVD-RAM, BD",
"\t-help\t\tprint this text to stderr and exit emulation",
"Actually this is the integrated ISO RockRidge filesystem manipulator xorriso",
"lending its libburn capabilities to a very limited cdrecord emulation. Only",
......@@ -11155,6 +11155,7 @@ int Xorriso_genisofs(struct XorrisO *xorriso, char *whom,
" -print-size Print estimated filesystem size and exit",
" -quiet Run quietly",
" -R, -rock Generate Rock Ridge directory information",
" --hardlinks Record eventual hard link relations of files",
" --acl Record eventual ACLs of files",
" --xattr Record eventual user space xattr of files",
" -V ID, -volid ID Set Volume ID",
......@@ -11312,6 +11313,8 @@ int Xorriso_genisofs(struct XorrisO *xorriso, char *whom,
ret= Xorriso_option_charset(xorriso, argv[i], 3);
if(ret <= 0)
goto problem_handler_1;
} else if(strcmp(argv[i], "--hardlinks")==0) {
Xorriso_option_hardlinks(xorriso, "on", 0);
} else if(strcmp(argv[i], "--acl")==0) {
Xorriso_option_acl(xorriso, "on", 0);
} else if(strcmp(argv[i], "--xattr")==0) {
......@@ -11523,6 +11526,8 @@ not_enough_args:;
} else if(strcmp(argv[i], "-output-charset")==0) {
i++;
/* was already handled in first argument scan */;
} else if(strcmp(argv[i], "--hardlinks")==0) {
/* was already handled in first argument scan */;
} else if(strcmp(argv[i], "--acl")==0) {
/* was already handled in first argument scan */;
} else if(strcmp(argv[i], "--xattr")==0) {
......@@ -15660,11 +15665,13 @@ int Xorriso_option_help(struct XorrisO *xorriso, int flag)
" -local_charset name",
" Override system assumption of the local character set name.",
" -hardlinks \"on\"|\"off\"",
" Enable resp. disable recording and restoring of hardlinks.",
" Enable resp. disable recording and restoring of hard links.",
" -acl \"on\"|\"off\"",
" Enable resp. disable reading and writing of ACLs.",
" -xattr \"on\"|\"off\"",
" Enable resp. disable reading and writing of xattr.",
" -for_backup",
" Shortcut for: -hardlinks on -acl on -xattr on",
" -disk_dev_ino \"on\"|\"ino_only\"|\"off\"",
" Enable resp. disable recording of disk file dev_t and ino_t",
" and their use in file comparison.",
......@@ -15673,7 +15680,7 @@ int Xorriso_option_help(struct XorrisO *xorriso, int flag)
" -blank \"fast\"|\"all\"|\"deformat\"|\"deformat_quickest\"",
" Blank media resp. invalidate ISO image on media.",
" -format \"as_needed\"|\"full\"|\"fast\"|\"by_index_#\"|\"by_size_#\"",
" Format BD-RE, DVD-RAM, DVD-RW, DVD+RW.",
" Format BD-RE, BD-R, DVD-RAM, DVD-RW, DVD+RW.",
" -volid volume_id",
" Specifies the volume ID text. (32 chars out of [A-Z0-9_])",
" -publisher name",
......@@ -15904,7 +15911,7 @@ int Xorriso_option_help(struct XorrisO *xorriso, int flag)
" -speed number[\"k/s\"|\"m/s\"|\"[x]CD\"|\"[x]DVD\"|\"[x]BD\"]",
" Set the burn speed. Default is 0 = maximum speed.",
" -stream_recording \"on\"|\"off\"",
" Try to circumvent slow checkread on DVD-RAM and BD-RE.",
" Try to circumvent slow checkread on DVD-RAM, BD-RE, BD-R.",
" -fs number[\"k\"|\"m\"]",
" Set the size of the fifo buffer. (Default is 4m)",
" -eject \"in\"|\"out\"|\"all\"",
......@@ -18780,7 +18787,8 @@ int Xorriso_count_args(struct XorrisO *xorriso, int argc, char **argv,
int ret, was_dashed= 0, i;
char *cmd, cmd_data[2*SfileadrL];
static char arg0_commands[][40]= {
"ban_stdio_write","close_filter_list","commit","devices","end","help",
"ban_stdio_write","close_filter_list","commit","devices","end",
"for_backup", "help",
"list_formats","no_rc","print_size","pwd","pwdi","pwdx",
"rollback","rollback_end","tell_media_space","toc","version",
""
......@@ -19185,6 +19193,13 @@ next_command:;
(*idx)++;
ret= Xorriso_option_follow(xorriso, arg1, 0);
} else if(strcmp(cmd,"for_backup")==0) {
ret= Xorriso_option_hardlinks(xorriso, "on", 0);
if(ret > 0)
ret= Xorriso_option_acl(xorriso, "on", 0);
if(ret > 0)
ret= Xorriso_option_xattr(xorriso, "on", 0);
} else if(strcmp(cmd,"format")==0) {
(*idx)++;
ret= Xorriso_option_blank(xorriso, arg1, 1);
......
......@@ -238,16 +238,21 @@ Important: -indev and -outdev have to be different drives.
</DT>
<DT>Dialog mode accepts one or more options per line. An option and all its
arguments have to be given in one single line. Command -end stops the program
run. It will write eventually pending changes to media, if that has not
already been done by a previous -commit.</DT>
arguments have to be given in one single line. Backslash may be used to mark
a line as incomplete so it gets continued by the next input line.
<BR>
Command -end stops the program run. It will write eventually pending changes
to media, if that has not already been done by a previous -commit.</DT>
<DD>$<KBD>&nbsp;xorriso -dialog on</KBD></DD>
<DD><KBD>enter option and arguments :</KBD></DD>
<DD><KBD><B>-dev /dev/sr0</B></KBD></DD>
<DD><KBD>enter option and arguments :</KBD></DD>
<DD><KBD><B>-map /home/me/prepared_for_dvd/sounds_dummy /sounds</B></KBD></DD>
<DD><KBD>enter option and arguments :</KBD></DD>
<DD><KBD><B>-map /home/me/prepared_for_dvd/movies /movies</B></KBD></DD>
<DD><KBD><B>-map /home/me/prepared_for_dvd/movies \</B></KBD></DD>
<DD><KBD>Trailing backslash : Enter rest of line (or @@@ to clear it) :
</KBD></DD>
<DD><KBD><B> /movies</B></KBD></DD>
<DD>Available navigation commands: -cd, -ls, -du, -find</DD>
<DD><KBD>enter option and arguments :</KBD></DD>
<DD><KBD><B>-commit</B></KBD></DD>
......@@ -285,7 +290,7 @@ Files with names ending by ".o" or ".swp" are excluded by options -not_leaf.
To apply zisofs compression to those data files which get newly copied from
the local filesystem, perform immediately before -commit :
<DD>
<KBD>&nbsp;&nbsp; -find / -type f -lba_range -1 2000000000 -exec set_filter --zisofs -- \</KBD></DD>
<KBD>&nbsp;&nbsp; -find / -type f -pending_data -exec set_filter --zisofs -- \</KBD></DD>
</DD>
</DT>
......@@ -353,7 +358,11 @@ Be cautious not to overwrite your hard disk instead of your USB stick:
<DT>In batch mode it is possible to operate xorriso in a pipeline
with an external consumer of the generated ISO image. Any message
output will be redirected to stderr in this case.</DT>
output will be redirected to stderr in this case.
Examples for consumers are cdrecord or growisofs on operating systems
where xorriso cannot operate the burner drive directly,
or a ssh pipe to another system which has the desired drive
and a suitable burn program.</DT>
<DD>$<KBD>&nbsp;xorriso -outdev - ...other.options... | consumer</KBD></DD>
......@@ -412,6 +421,7 @@ files or trees to disk:
<DD><A HREF="xorriso-0.3.8.pl00.tar.gz">xorriso-0.3.8.pl00.tar.gz</A>
(1220 KB).
</DD>
<DD>(Released 19 Apr 2009)</DD>
</DL>
</DD>
</DL>
......@@ -503,14 +513,23 @@ cdrecord and mkisofs.</DT>
<DT><H3>Development snapshot, version 0.3.9 :</H3></DT>
<DD>Bug fixes towards xorriso-0.3.8.pl00:
<UL>
<LI>- none yet -</LI>
<LI>SIGSEGV by dereferencing NULL with option -status and no search string</LI>
<LI>-load volid did not perform pattern search</LI>
<!--
<LI>- none yet -</LI>
-->
</UL>
</DD>
<DD>Enhancements towards stable version 0.3.8.pl00:
<UL>
<LI>Operators with option -find : -not, -or, -and, brackets, -if, -then, -else</LI>
<LI>New option -hardlinks for recording and restoring of hard link relations
</LI>
<LI>New option -for_backup as shortcut for -acl -xattr -hardlinks
</LI>
<LI>Improved read performance with -update_r and -extract
</LI>
<LI>Operators with option -find : -not, -or, -and, (, ), -if, -then, -else</LI>
<LI>New -find tests -wholename, -prune, -sort_lba</LI>
<!--
<LI>- none yet -</LI>
-->
......@@ -530,7 +549,7 @@ installation see README)
</DD>
<DD>
<A HREF="xorriso-0.3.9.tar.gz">xorriso-0.3.9.tar.gz</A>
(1220 KB).
(1250 KB).
</DD>
<DT>A dynamically linked development version of xorriso can be obtained
from repositories of
......
#define Xorriso_timestamP "2009.05.26.142912"
#define Xorriso_timestamP "2009.05.29.110831"
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment