libburnia/libisoburn
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Reacted on complaints of lintian spelling check

Browse Source
This commit is contained in:
Thomas Schmitt 2015-09-20 12:51:53 +00:00
parent 3d36b343ce
commit 9c303135f6
19 changed files with 320 additions and 315 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
frontend/frontend_pipes_xorriso.c
View File

@ -720,7 +720,7 @@ static int Sfile_destroy_argv(int *argc, char ***argv, int flag)
The scope of a backslash (0 to 3 characters) is not affected. The scope of a backslash (0 to 3 characters) is not affected.
@param eaten returns the difference in length between input and output @param eaten returns the difference in length between input and output
@param flag bit0= only determine *eaten, do not convert @param flag bit0= only determine *eaten, do not convert
bit1= allow to convert \000 to binary 0 bit1= convert \000 to binary 0
*/ */
static int Sfile_bsl_interpreter(char *text, int upto, int *eaten, int flag) static int Sfile_bsl_interpreter(char *text, int upto, int *eaten, int flag)
{ {

16
xorriso/drive_mgt.c
View File

@ -290,7 +290,7 @@ int Xorriso_aquire_drive(struct XorrisO *xorriso, char *adr, char *show_adr,
Xorriso_msgs_submit(xorriso, 0, xorriso->info_text, 0, "FATAL", 0); Xorriso_msgs_submit(xorriso, 0, xorriso->info_text, 0, "FATAL", 0);
{ret= 0; goto ex;} {ret= 0; goto ex;}
} else { } else {
sprintf(xorriso->info_text, "No drive aquired on re-assessment"); sprintf(xorriso->info_text, "No drive acquired on re-assessment");
Xorriso_msgs_submit(xorriso, 0, xorriso->info_text, 0, "FATAL", 0); Xorriso_msgs_submit(xorriso, 0, xorriso->info_text, 0, "FATAL", 0);
{ret= 0; goto ex;} {ret= 0; goto ex;}
} }
@ -716,7 +716,7 @@ int Xorriso_give_up_drive(struct XorrisO *xorriso, int flag)
do_eject= !!(flag&4); do_eject= !!(flag&4);
if((flag & 4) && !xorriso->indev_is_exclusive) { if((flag & 4) && !xorriso->indev_is_exclusive) {
sprintf(xorriso->info_text, sprintf(xorriso->info_text,
"Will not eject medium in non-exclusively aquired input drive."); "Will not eject medium in non-exclusively acquired input drive.");
Xorriso_msgs_submit(xorriso, 0, xorriso->info_text, 0, "WARNING", 0); Xorriso_msgs_submit(xorriso, 0, xorriso->info_text, 0, "WARNING", 0);
do_eject= 0; do_eject= 0;
} }
@ -748,7 +748,7 @@ int Xorriso_give_up_drive(struct XorrisO *xorriso, int flag)
do_eject= !!(flag&4); do_eject= !!(flag&4);
if((flag & 4) && !xorriso->outdev_is_exclusive) { if((flag & 4) && !xorriso->outdev_is_exclusive) {
sprintf(xorriso->info_text, sprintf(xorriso->info_text,
"Will not eject medium in non-exclusively aquired drive."); "Will not eject medium in non-exclusively acquired drive.");
Xorriso_msgs_submit(xorriso, 0, xorriso->info_text, 0, "WARNING", 0); Xorriso_msgs_submit(xorriso, 0, xorriso->info_text, 0, "WARNING", 0);
do_eject= 0; do_eject= 0;
} }
@ -784,7 +784,7 @@ int Xorriso_may_burn(struct XorrisO *xorriso, int flag)
if(xorriso->outdev_is_exclusive) if(xorriso->outdev_is_exclusive)
return(1); return(1);
sprintf(xorriso->info_text, "The output drive was not aquired exclusively."); sprintf(xorriso->info_text, "The output drive was not acquired exclusively.");
Xorriso_msgs_submit(xorriso, 0, xorriso->info_text, 0, "FAILURE", 0); Xorriso_msgs_submit(xorriso, 0, xorriso->info_text, 0, "FAILURE", 0);
sprintf(xorriso->info_text, "A possible remedy is: -osirrox 'o_excl_on'"); sprintf(xorriso->info_text, "A possible remedy is: -osirrox 'o_excl_on'");
if(xorriso->outdev[0]) { if(xorriso->outdev[0]) {
@ -906,7 +906,7 @@ int Xorriso_toc_line(struct XorrisO *xorriso, int flag)
/* @param flag /* @param flag
bit1=report about output drive bit1=report about output drive
bit3=report to info channel (else to result channel) bit3=report to info channel (else to result channel)
bit4=do no report failure if no drive aquired bit4=do no report failure if no drive acquired
*/ */
int Xorriso_media_product(struct XorrisO *xorriso, int flag) int Xorriso_media_product(struct XorrisO *xorriso, int flag)
{ {
@ -957,7 +957,7 @@ int Xorriso_media_product(struct XorrisO *xorriso, int flag)
bit1=report about output drive bit1=report about output drive
bit2=do not try to read ISO heads bit2=do not try to read ISO heads
bit3=report to info channel (else to result channel) bit3=report to info channel (else to result channel)
bit4=do no report failure if no drive aquired bit4=do no report failure if no drive acquired
bit5=only report "Drive current" and "Drive type" bit5=only report "Drive current" and "Drive type"
bit6=report "Media product" with bit0 bit6=report "Media product" with bit0
bit7=only report "Drive current" bit7=only report "Drive current"
@ -1841,7 +1841,7 @@ int Xorriso_list_speeds(struct XorrisO *xorriso, int flag)
if(xorriso->out_drive_handle == NULL && xorriso->in_drive_handle == NULL) { if(xorriso->out_drive_handle == NULL && xorriso->in_drive_handle == NULL) {
Xorriso_msgs_submit(xorriso, 0, Xorriso_msgs_submit(xorriso, 0,
"No drive aquired on attempt to list speeds", 0, "FAILURE", 0); "No drive acquired on attempt to list speeds", 0, "FAILURE", 0);
return(0); return(0);
} }
if(xorriso->in_drive_handle != NULL) { if(xorriso->in_drive_handle != NULL) {
@ -3314,7 +3314,7 @@ int Xorriso_get_drive_handles(struct XorrisO *xorriso,
*dinfo= (struct burn_drive_info *) xorriso->in_drive_handle; *dinfo= (struct burn_drive_info *) xorriso->in_drive_handle;
if(*dinfo==NULL && !(flag & 16)) { if(*dinfo==NULL && !(flag & 16)) {
Xorriso_process_msg_queues(xorriso,0); Xorriso_process_msg_queues(xorriso,0);
sprintf(xorriso->info_text, "No %s drive aquired %s", sprintf(xorriso->info_text, "No %s drive acquired %s",
(flag&2 ? "output" : "input"), attempt); (flag&2 ? "output" : "input"), attempt);
Xorriso_msgs_submit(xorriso, 0, xorriso->info_text, 0, "FAILURE", 0); Xorriso_msgs_submit(xorriso, 0, xorriso->info_text, 0, "FAILURE", 0);
} }

4
xorriso/iso_img.c
View File

@ -369,7 +369,7 @@ int Xorriso_get_volid(struct XorrisO *xorriso, char volid[33], int flag)
bit1= do only report to fp bit1= do only report to fp
bit2= is_default bit2= is_default
bit3= append -boot_image any next bit3= append -boot_image any next
bit4= eventually concentrate boot options bit4= concentrate boot options
*/ */
int Xorriso_boot_item_status(struct XorrisO *xorriso, char *cat_path, int Xorriso_boot_item_status(struct XorrisO *xorriso, char *cat_path,
char *bin_path, int platform_id, char *bin_path, int platform_id,
@ -389,7 +389,7 @@ int Xorriso_boot_item_status(struct XorrisO *xorriso, char *cat_path,
line= xorriso->result_line; line= xorriso->result_line;
if((flag & 16) && bin_path[0] != 0) { if((flag & 16) && bin_path[0] != 0) {
/* Allow to concentrate boot options. */ /* Concentrate boot options. */
memset(zeros, 0, 28); memset(zeros, 0, 28);
if(memcmp(id_string, zeros, 28) == 0 && if(memcmp(id_string, zeros, 28) == 0 &&
memcmp(selection_crit, zeros, 20) == 0) memcmp(selection_crit, zeros, 20) == 0)

4
xorriso/opts_a_c.c
View File

@ -652,7 +652,7 @@ unusable_size:;
ret= Xorriso_blank_media(xorriso, mode_flag&3); ret= Xorriso_blank_media(xorriso, mode_flag&3);
if(ret==0) if(ret==0)
return(ret); return(ret);
if(ret <= 0) { /* in case of success, above functions will have re-aquired */ if(ret <= 0) { /* in case of success, above functions will have re-acquired */
aq_ret= Xorriso_reaquire_outdev(xorriso, 0); /* actually give up drive */ aq_ret= Xorriso_reaquire_outdev(xorriso, 0); /* actually give up drive */
if(ret<aq_ret) if(ret<aq_ret)
return(ret); return(ret);
@ -2039,7 +2039,7 @@ int Xorriso_option_close_filter_list(struct XorrisO *xorriso, int flag)
/* Option -commit */ /* Option -commit */
/* @param flag bit0= leave indrive and outdrive aquired as they were, /* @param flag bit0= leave indrive and outdrive acquired as they were,
i.e. do not aquire outdrive as new in-out-drive i.e. do not aquire outdrive as new in-out-drive
bit1= do not perform eventual -reassure bit1= do not perform eventual -reassure
@return <=0 error , 1 success, 2 revoked by -reassure , 3 no change pending @return <=0 error , 1 success, 2 revoked by -reassure , 3 no change pending

6
xorriso/opts_d_h.c
View File

@ -65,7 +65,7 @@ int Xorriso_option_data_cache_size(struct XorrisO *xorriso, char *num_tiles,
bit3= regard overwriteable media as blank bit3= regard overwriteable media as blank
bit4= if the drive is a regular disk file: truncate it to bit4= if the drive is a regular disk file: truncate it to
the write start address the write start address
bit5= do not print toc of aquired drive bit5= do not print toc of acquired drive
bit6= do not calm down drive after aquiring it bit6= do not calm down drive after aquiring it
@return <=0 error , 1 success, 2 revoked by -reassure @return <=0 error , 1 success, 2 revoked by -reassure
*/ */
@ -2165,9 +2165,9 @@ int Xorriso_option_help(struct XorrisO *xorriso, int flag)
" local filesystem which match one of the shell parser", " local filesystem which match one of the shell parser",
" patterns.", " patterns.",
" -dus pattern [***] like -du but summing up subdirectories without", " -dus pattern [***] like -du but summing up subdirectories without",
" listing them explicitely.", " listing them explicitly.",
" -dusx pattern [***] like -dux but summing up subdirectories without", " -dusx pattern [***] like -dux but summing up subdirectories without",
" listing them explicitely.", " listing them explicitly.",
"", "",
" -findx disk_path [-name pattern] [-type t] [-exec action [params]]", " -findx disk_path [-name pattern] [-type t] [-exec action [params]]",
" Like -find but operating on local filesystem. Most -exec", " Like -find but operating on local filesystem. Most -exec",

7
xorriso/opts_p_z.c
View File

@ -1608,21 +1608,22 @@ int Xorriso_option_toc_of(struct XorrisO *xorriso, char *which, int flag)
toc_flag|= 1; toc_flag|= 1;
if(strncmp(which, "in", 2) == 0) { if(strncmp(which, "in", 2) == 0) {
if(xorriso->indev[0] == 0) { if(xorriso->indev[0] == 0) {
Xorriso_msgs_submit(xorriso, 0, "-toc_of 'in' : No input drive aquired", Xorriso_msgs_submit(xorriso, 0, "-toc_of 'in' : No input drive acquired",
0, "NOTE", 0); 0, "NOTE", 0);
return(2); return(2);
} }
ret= Xorriso_toc(xorriso, toc_flag | 0); ret= Xorriso_toc(xorriso, toc_flag | 0);
} else if(strncmp(which, "out", 3) == 0) { } else if(strncmp(which, "out", 3) == 0) {
if(xorriso->outdev[0] == 0) { if(xorriso->outdev[0] == 0) {
Xorriso_msgs_submit(xorriso, 0, "-toc_of 'out' : No output drive aquired", Xorriso_msgs_submit(xorriso, 0,
"-toc_of 'out' : No output drive acquired",
0, "NOTE", 0); 0, "NOTE", 0);
return(2); return(2);
} }
ret= Xorriso_toc(xorriso, toc_flag | 2); ret= Xorriso_toc(xorriso, toc_flag | 2);
} else if(strncmp(which, "all", 3) == 0) { } else if(strncmp(which, "all", 3) == 0) {
if(xorriso->indev[0] == 0 && xorriso->outdev[0] == 0) { if(xorriso->indev[0] == 0 && xorriso->outdev[0] == 0) {
Xorriso_msgs_submit(xorriso, 0, "-toc_of 'all' : No drive aquired", Xorriso_msgs_submit(xorriso, 0, "-toc_of 'all' : No drive acquired",
0, "NOTE", 0); 0, "NOTE", 0);
return(2); return(2);
} }

2
xorriso/sfile.c
View File

@ -461,7 +461,7 @@ int Sfile_off_t_text(char text[80], off_t num, int flag)
The scope of a backslash (0 to 3 characters) is not affected. The scope of a backslash (0 to 3 characters) is not affected.
@param eaten returns the difference in length between input and output @param eaten returns the difference in length between input and output
@param flag bit0= only determine *eaten, do not convert @param flag bit0= only determine *eaten, do not convert
bit1= allow to convert \000 to binary 0 bit1= convert \000 to binary 0
*/ */
int Sfile_bsl_interpreter(char *text, int upto, int *eaten, int flag) int Sfile_bsl_interpreter(char *text, int upto, int *eaten, int flag)
{ {

2
xorriso/sfile.h
View File

@ -129,7 +129,7 @@ char *Sfile_datestr(time_t tim, short int flag);
The scope of a backslash (0 to 3 characters) is not affected. The scope of a backslash (0 to 3 characters) is not affected.
@param eaten returns the difference in length between input and output @param eaten returns the difference in length between input and output
@param flag bit0= only determine *eaten, do not convert @param flag bit0= only determine *eaten, do not convert
bit1= allow to convert \000 to binary 0 bit1= convert \000 to binary 0
*/ */
int Sfile_bsl_interpreter(char *text, int upto, int *eaten, int flag); int Sfile_bsl_interpreter(char *text, int upto, int *eaten, int flag);

21
xorriso/xorrecord.1
View File

@ -9,7 +9,7 @@
.\" First parameter, NAME, should be all caps .\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1) .\" other parameters are allowed: see man(7), man(1)
.TH XORRECORD 1 "Version 1.4.1, Jul 30, 2015" .TH XORRECORD 1 "Version 1.4.1, Sep 20, 2015"
.\" Please adjust this date whenever revising the manpage. .\" Please adjust this date whenever revising the manpage.
.\" .\"
.\" Some roff macros, for reference: .\" Some roff macros, for reference:
@ -412,18 +412,18 @@ The same as padsize=15s. This was once sufficient with older GNU/Linux
kernels. Meanwhile one should at least use padsize=128k, if not padsize=300k. kernels. Meanwhile one should at least use padsize=128k, if not padsize=300k.
.TP .TP
\fB\-data\fR \fB\-data\fR
Explicitely announce that the track source shall be recorded as data track, Explicitly announce that the track source shall be recorded as data track,
and not as audio track. This option has no effect with \fBxorrecord\fR, and not as audio track. This option has no effect with \fBxorrecord\fR,
because there is no support for other track formats anyway. because there is no support for other track formats anyway.
.TP .TP
\fB\-tao\fR \fB\-tao\fR
Explicitely demand that write type TAO shall be used for CD, or Incremental Explicitly demand that write type TAO shall be used for CD, or Incremental
for DVD\-R. Normally the program will choose the write type according to the for DVD\-R. Normally the program will choose the write type according to the
given medium state, option \-multi, and track source. Demanding it explicitely given medium state, option \-multi, and track source. Demanding it explicitely
prevents the start of a write run, if it is not appropriate to the situation. prevents the start of a write run, if it is not appropriate to the situation.
.TP .TP
\fB\-sao\fR \fB\-sao\fR
Explicitely demand that write type SAO shall be used for CD, or DAO for DVD\-R. Explicitly demand that write type SAO shall be used for CD, or DAO for DVD\-R.
This might prevent the write run, if it is not appropriate to the situation. This might prevent the write run, if it is not appropriate to the situation.
.TP .TP
\fB\-dao\fR \fB\-dao\fR
@ -607,15 +607,20 @@ E.g.: modesty_on_drive=75
.br .br
The optimal values depend on the buffer behavior of the drive. The optimal values depend on the buffer behavior of the drive.
.br .br
There are also timing parameters "timeout_sec=", "min_usec=", "max_usec=". Parameter "timeout_sec=" defines after which time of unsuccessful waiting
Read the description of burn_drive_set_buffer_waiting() in libburn.h, the modesty shall be disabled because it does not work.
before setting them to non\-default values. .br
Parameter "min_usec=" defines the initial sleeping period in microseconds.
If the drive buffer appears to be too full for sending more data, the
program will wait the given time and inquire the buffer fill state again.
If repeated inquiry shows not enough free space, the sleep time will
slowly be increased to what parameter "max_usec=" defines.
.br .br
Parameters, which are not mentioned with a modesty_on_drive= option, Parameters, which are not mentioned with a modesty_on_drive= option,
stay unchanged. stay unchanged.
Default is: Default is:
.br .br
modesty_on_drive=off:min_percent=65:max_percent=95 modesty_on_drive=off:min_percent=90:max_percent=95:timeout_sec=120:min_usec=5000:max_usec=25000
.TP .TP
\fBwrite_start_address=value\fR \fBwrite_start_address=value\fR
Set the block address on overwritable media where to start writing the track. Set the block address on overwritable media where to start writing the track.

66
xorriso/xorrecord.info
View File

@ -397,18 +397,18 @@ padsize=size
GNU/Linux kernels. Meanwhile one should at least use padsize=128k, GNU/Linux kernels. Meanwhile one should at least use padsize=128k,
if not padsize=300k. if not padsize=300k.
-data -data
Explicitely announce that the track source shall be recorded as Explicitly announce that the track source shall be recorded as data
data track, and not as audio track. This option has no effect with track, and not as audio track. This option has no effect with
'xorrecord', because there is no support for other track formats 'xorrecord', because there is no support for other track formats
anyway. anyway.
-tao -tao
Explicitely demand that write type TAO shall be used for CD, or Explicitly demand that write type TAO shall be used for CD, or
Incremental for DVD-R. Normally the program will choose the write Incremental for DVD-R. Normally the program will choose the write
type according to the given medium state, option -multi, and track type according to the given medium state, option -multi, and track
source. Demanding it explicitely prevents the start of a write source. Demanding it explicitely prevents the start of a write
run, if it is not appropriate to the situation. run, if it is not appropriate to the situation.
-sao -sao
Explicitely demand that write type SAO shall be used for CD, or DAO Explicitly demand that write type SAO shall be used for CD, or DAO
for DVD-R. This might prevent the write run, if it is not for DVD-R. This might prevent the write run, if it is not
appropriate to the situation. appropriate to the situation.
-dao -dao
@ -566,13 +566,17 @@ modesty_on_drive=parameter[:parameters]
are interpreted as "on:min_percent=". are interpreted as "on:min_percent=".
E.g.: modesty_on_drive=75 E.g.: modesty_on_drive=75
The optimal values depend on the buffer behavior of the drive. The optimal values depend on the buffer behavior of the drive.
There are also timing parameters "timeout_sec=", "min_usec=", Parameter "timeout_sec=" defines after which time of unsuccessful
"max_usec=". Read the description of waiting the modesty shall be disabled because it does not work.
burn_drive_set_buffer_waiting() in libburn.h, before setting them Parameter "min_usec=" defines the initial sleeping period in
to non-default values. microseconds. If the drive buffer appears to be too full for
sending more data, the program will wait the given time and inquire
the buffer fill state again. If repeated inquiry shows not enough
free space, the sleep time will slowly be increased to what
parameter "max_usec=" defines.
Parameters, which are not mentioned with a modesty_on_drive= Parameters, which are not mentioned with a modesty_on_drive=
option, stay unchanged. Default is: option, stay unchanged. Default is:
modesty_on_drive=off:min_percent=65:max_percent=95 modesty_on_drive=off:min_percent=90:max_percent=95:timeout_sec=120:min_usec=5000:max_usec=25000
write_start_address=value write_start_address=value
Set the block address on overwritable media where to start writing Set the block address on overwritable media where to start writing
the track. With DVD+RW, DVD-RAM or BD-RE, byte_offset must be the track. With DVD+RW, DVD-RAM or BD-RE, byte_offset must be
@ -881,12 +885,12 @@ File: xorrecord.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* minbuf= keep drive buffer hungry: SetBurn. (line 205) * minbuf= keep drive buffer hungry: SetBurn. (line 205)
* padsize= add bytes to end of track: SetBurn. (line 144) * padsize= add bytes to end of track: SetBurn. (line 144)
* speed= set write speed: SetBurn. (line 189) * speed= set write speed: SetBurn. (line 189)
* stdio_sync= control stdio buffer: NonCdrecord. (line 93) * stdio_sync= control stdio buffer: NonCdrecord. (line 97)
* stream_recording= try to get full speed on DVD-RAM, BD: NonCdrecord. * stream_recording= try to get full speed on DVD-RAM, BD: NonCdrecord.
(line 39) (line 39)
* tsize= set a fixed track size: SetBurn. (line 126) * tsize= set a fixed track size: SetBurn. (line 126)
* write_start_address= set block address for write start: NonCdrecord. * write_start_address= set block address for write start: NonCdrecord.
(line 87) (line 91)
 
File: xorrecord.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top File: xorrecord.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
@ -943,11 +947,11 @@ File: xorrecord.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Version, report, -version: Verbous. (line 8) * Version, report, -version: Verbous. (line 8)
* Write simulation , control, -dummy: SetBurn. (line 106) * Write simulation , control, -dummy: SetBurn. (line 106)
* Write start address, set, write_start_address=: NonCdrecord. * Write start address, set, write_start_address=: NonCdrecord.
(line 87) (line 91)
* Write type, SAO/DAO, -dao: SetBurn. (line 172) * Write type, SAO/DAO, -dao: SetBurn. (line 172)
* Write type, SAO/DAO, -sao: SetBurn. (line 168) * Write type, SAO/DAO, -sao: SetBurn. (line 168)
* Write type, TAO, -tao: SetBurn. (line 162) * Write type, TAO, -tao: SetBurn. (line 162)
* Write, buffer syncing, stdio_sync=: NonCdrecord. (line 93) * Write, buffer syncing, stdio_sync=: NonCdrecord. (line 97)
* Write, drive buffer, -immed: SetBurn. (line 208) * Write, drive buffer, -immed: SetBurn. (line 208)
* Write, drive buffer, minbuf=: SetBurn. (line 205) * Write, drive buffer, minbuf=: SetBurn. (line 205)
* Write, drive buffer, modesty_on_drive=: NonCdrecord. (line 56) * Write, drive buffer, modesty_on_drive=: NonCdrecord. (line 56)
@ -966,23 +970,23 @@ Node: Options5885
Node: DriveAddr6253 Node: DriveAddr6253
Node: Inquire7618 Node: Inquire7618
Node: SetBurn10487 Node: SetBurn10487
Node: Verbous20940 Node: Verbous20937
Node: NonCdrecord22490 Node: NonCdrecord22487
Node: Examples27889 Node: Examples28241
Node: ExDevices28550 Node: ExDevices28902
Node: ExMedium28768 Node: ExMedium29120
Node: ExBlank29031 Node: ExBlank29383
Node: ExFormat29252 Node: ExFormat29604
Node: ExDeformat29770 Node: ExDeformat30122
Node: ExIsoSingle30037 Node: ExIsoSingle30389
Node: ExIsoMulti30321 Node: ExIsoMulti30673
Node: ExIsoFly31955 Node: ExIsoFly32307
Node: ExAfio32626 Node: ExAfio32978
Node: Files33624 Node: Files33976
Node: Seealso34180 Node: Seealso34532
Node: Bugreport34543 Node: Bugreport34895
Node: Legal35134 Node: Legal35486
Node: CommandIdx36063 Node: CommandIdx36415
Node: ConceptIdx39339 Node: ConceptIdx39691
 
End Tag Table End Tag Table

8
xorriso/xorrecord.texi
View File

@ -50,7 +50,7 @@
@c man .\" First parameter, NAME, should be all caps @c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection @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 .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRECORD 1 "Version 1.4.1, Aug 29, 2015" @c man .TH XORRECORD 1 "Version 1.4.1, Sep 20, 2015"
@c man .\" Please adjust this date whenever revising the manpage. @c man .\" Please adjust this date whenever revising the manpage.
@c man .\" @c man .\"
@c man .\" Some roff macros, for reference: @c man .\" Some roff macros, for reference:
@ -579,14 +579,14 @@ kernels. Meanwhile one should at least use padsize=128k, if not padsize=300k.
@item -data @item -data
@kindex -data explicitely announce a data track @kindex -data explicitely announce a data track
@cindex Data track, announce, -data @cindex Data track, announce, -data
Explicitely announce that the track source shall be recorded as data track, Explicitly announce that the track source shall be recorded as data track,
and not as audio track. This option has no effect with @command{xorrecord}, and not as audio track. This option has no effect with @command{xorrecord},
because there is no support for other track formats anyway. because there is no support for other track formats anyway.
@c man .TP @c man .TP
@item -tao @item -tao
@kindex -tao explicitely set write type TAO @kindex -tao explicitely set write type TAO
@cindex Write type, TAO, -tao @cindex Write type, TAO, -tao
Explicitely demand that write type TAO shall be used for CD, or Incremental Explicitly demand that write type TAO shall be used for CD, or Incremental
for DVD-R. Normally the program will choose the write type according to the for DVD-R. Normally the program will choose the write type according to the
given medium state, option -multi, and track source. Demanding it explicitely given medium state, option -multi, and track source. Demanding it explicitely
prevents the start of a write run, if it is not appropriate to the situation. prevents the start of a write run, if it is not appropriate to the situation.
@ -594,7 +594,7 @@ prevents the start of a write run, if it is not appropriate to the situation.
@item -sao @item -sao
@kindex -sao explicitely set write type SAO/DAO @kindex -sao explicitely set write type SAO/DAO
@cindex Write type, SAO/DAO, -sao @cindex Write type, SAO/DAO, -sao
Explicitely demand that write type SAO shall be used for CD, or DAO for DVD-R. Explicitly demand that write type SAO shall be used for CD, or DAO for DVD-R.
This might prevent the write run, if it is not appropriate to the situation. This might prevent the write run, if it is not appropriate to the situation.
@c man .TP @c man .TP
@item -dao @item -dao

80
xorriso/xorriso.1
View File

@ -9,7 +9,7 @@
.\" First parameter, NAME, should be all caps .\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1) .\" other parameters are allowed: see man(7), man(1)
.TH XORRISO 1 "Version 1.4.1, Sep 16, 2015" .TH XORRISO 1 "Version 1.4.1, Sep 20, 2015"
.\" Please adjust this date whenever revising the manpage. .\" Please adjust this date whenever revising the manpage.
.\" .\"
.\" Some roff macros, for reference: .\" Some roff macros, for reference:
@ -34,7 +34,7 @@ with Rock Ridge extensions.
.PP .PP
\fBxorriso\fR \fBxorriso\fR
is a program which copies file objects from POSIX compliant is a program which copies file objects from POSIX compliant
filesystems into Rock Ridge enhanced ISO 9660 filesystems and allows filesystems into Rock Ridge enhanced ISO 9660 filesystems and performs
session\-wise manipulation of such filesystems. It can load the management session\-wise manipulation of such filesystems. It can load the management
information of existing ISO images and it writes the session results to information of existing ISO images and it writes the session results to
optical media or to filesystem objects. optical media or to filesystem objects.
@ -126,7 +126,7 @@ represent arbitrary media or from regular disk files.
.PP .PP
This session usage model has been extended on CD media by the concept of This session usage model has been extended on CD media by the concept of
\fBmulti\-session\fR , \fBmulti\-session\fR ,
which allows to add information to the CD and gives the mount programs which adds information to the CD and gives the mount programs
of the operating systems the addresses of the entry points of each of the operating systems the addresses of the entry points of each
session. The mount programs recognize block devices which represent session. The mount programs recognize block devices which represent
CD media and will by default mount the image in the last session. CD media and will by default mount the image in the last session.
@ -151,7 +151,7 @@ See paragraph Creating, Growing, Modifying, Blind Growing below.
.PP .PP
\fBxorriso\fR adopts the concept of multi\-session by loading an \fBxorriso\fR adopts the concept of multi\-session by loading an
image directory tree if present, image directory tree if present,
by allowing to manipulate it by several actions, by offering to manipulate it by several actions,
and by writing the new image to the target medium. and by writing the new image to the target medium.
.br .br
The first session of a \fBxorriso\fR run begins by the definition of The first session of a \fBxorriso\fR run begins by the definition of
@ -177,11 +177,11 @@ unformatted DVD\-RW. These media provide a table of content which
describes their existing sessions. See command \fB\-toc\fR. describes their existing sessions. See command \fB\-toc\fR.
.br .br
Similar to multi\-session media are DVD\-R DL and minimally blanked DVD\-RW. Similar to multi\-session media are DVD\-R DL and minimally blanked DVD\-RW.
They allow only a single session of which the size must be known in advance. They record only a single session of which the size must be known in advance.
\fBxorriso\fR will write onto them only if command \-close is set to "on". \fBxorriso\fR will write onto them only if command \-close is set to "on".
.br .br
\fBOverwriteable media\fR are DVD\-RAM, DVD+RW, BD\-RE, and formatted DVD\-RW. \fBOverwriteable media\fR are DVD\-RAM, DVD+RW, BD\-RE, and formatted DVD\-RW.
They allow random write access but do not provide information about their They offer random write access but do not provide information about their
session history. If they contain one or more ISO 9660 sessions and if the session history. If they contain one or more ISO 9660 sessions and if the
first session was written by \fBxorriso\fR, then a table of content can first session was written by \fBxorriso\fR, then a table of content can
be emulated. Else only a single overall session will be visible. be emulated. Else only a single overall session will be visible.
@ -330,8 +330,8 @@ their path in the filesystem. E.g.:
.br .br
\-dev stdio:/dev/sdc \-dev stdio:/dev/sdc
.br .br
The default setting of \-drive_class allows to address files outside the The default setting of \-drive_class allows the user to address files outside
/dev tree without that prefix. E.g.: the /dev tree without that prefix. E.g.:
.br .br
\-dev /tmp/pseudo_drive \-dev /tmp/pseudo_drive
.br .br
@ -369,7 +369,7 @@ drive.
.br .br
One may use command One may use command
\fB\-ban_stdio_write\fR \fB\-ban_stdio_write\fR
to surely prevent this risk and to allow only MMC drives. to surely prevent this risk and to restrict drive usage to MMC drives.
.br .br
One may prepend "mmc:" to a path to surely disallow any automatic "stdio:". One may prepend "mmc:" to a path to surely disallow any automatic "stdio:".
.br .br
@ -458,8 +458,7 @@ only on GNU/Linux and FreeBSD.
.PP .PP
\fBxattr\fR (aka EA, or extattr) \fBxattr\fR (aka EA, or extattr)
are pairs of name and value which can be attached to file objects. AAIP is are pairs of name and value which can be attached to file objects. AAIP is
able to represent them and \fBxorriso\fR allows to record and restore able to represent them and \fBxorriso\fR can record and restore pairs which
pairs which
have names out of the user namespace. I.e. those which begin with "user.", have names out of the user namespace. I.e. those which begin with "user.",
like "user.x" or "user.whatever". Name has to be a 0 terminated string. like "user.x" or "user.whatever". Name has to be a 0 terminated string.
Value may be any array of bytes which does not exceed the size of 4095 bytes. Value may be any array of bytes which does not exceed the size of 4095 bytes.
@ -533,7 +532,7 @@ quotations or an open quotation cause the next input line to be appended.
Quoted input accepts any 8\-bit character except NUL (0) as the content of Quoted input accepts any 8\-bit character except NUL (0) as the content of
the quotes. the quotes.
Nevertheless it can be cumbersome for the user to produce those characters Nevertheless it can be cumbersome for the user to produce those characters
directly. Therefore quoted input and program arguments allow optional directly. Therefore quoted input and program arguments offer optional
\fBBackslash Interpretation\fR \fBBackslash Interpretation\fR
which can represent all 8\-bit characters except NUL (0) via backslash codes which can represent all 8\-bit characters except NUL (0) via backslash codes
as in $'...' of bash. as in $'...' of bash.
@ -562,7 +561,7 @@ availability
of package readline\-dev at the time when \fBxorriso\fR was built from of package readline\-dev at the time when \fBxorriso\fR was built from
its sourcecode. its sourcecode.
.br .br
Readline allows to move the cursor over the text in the line by help of the Readline lets the user move the cursor over the text in the line by help of the
Left and the Right arrow keys. Left and the Right arrow keys.
Text may be inserted at the cursor position. The Delete key removes the Text may be inserted at the cursor position. The Delete key removes the
character under the cursor. Up and Down arrow keys navigate through character under the cursor. Up and Down arrow keys navigate through
@ -951,8 +950,8 @@ if any occur despite the prescriptions of ECMA\-119.
.TP .TP
\fB\-disk_dev_ino\fR "on"|"ino_only"|"off" \fB\-disk_dev_ino\fR "on"|"ino_only"|"off"
Enable or disable processing of recorded file identification numbers Enable or disable processing of recorded file identification numbers
(dev_t and ino_t). If enabled they are stored as xattr and allow (dev_t and ino_t). If enabled they are stored as xattr and can
to substantially accelerate file comparison. The root node gets a global start substantially accelerate file comparison. The root node gets a global start
timestamp. If during comparison a file with younger timestamps is found in the timestamp. If during comparison a file with younger timestamps is found in the
ISO image, then it is suspected to have inconsistent content. ISO image, then it is suspected to have inconsistent content.
.br .br
@ -983,7 +982,7 @@ leading bytes replaced by '_'.
iso_rr_paths with the long components will still be able to access the iso_rr_paths with the long components will still be able to access the
file paths with truncated components. To avoid confusion by having both file paths with truncated components. To avoid confusion by having both
truncated and untrancated names in the same directory, it is not possible truncated and untrancated names in the same directory, it is not possible
to change this setting after a drive was aquired. All file names get to change this setting after a drive was acquired. All file names get
truncated by the same length. truncated by the same length.
.br .br
File name patterns will only work if they match the truncated name. File name patterns will only work if they match the truncated name.
@ -1450,13 +1449,13 @@ It also disables \-disk_pattern expansion for command \-add.
and re\-enables \-disk_pattern expansion. and re\-enables \-disk_pattern expansion.
.TP .TP
\fB\-overwrite\fR "on"|"nondir"|"off" \fB\-overwrite\fR "on"|"nondir"|"off"
Allow or disallow to overwrite existing files in the Allow or disallow overwriting of existing files in the
ISO image by files with the same name. ISO image by files with the same name.
.br .br
With setting "off", name collisions cause FAILURE events. With setting "off", name collisions cause FAILURE events.
With setting "nondir", only directories are protected by such events, other With setting "nondir", only directories are protected by such events, other
existing file types get treated with \-rm before the new file gets added. existing file types get treated with \-rm before the new file gets added.
Setting "on" allows automatic \-rm_r. I.e. a non\-directory can replace an Setting "on" enables automatic \-rm_r. I.e. a non\-directory can replace an
existing directory and all its subordinates. existing directory and all its subordinates.
.br .br
If restoring of files is enabled, then the overwrite rule applies to the If restoring of files is enabled, then the overwrite rule applies to the
@ -2272,7 +2271,7 @@ prevent any suffix renaming.
.br .br
Attaching or detaching filters will not alter the state of \-changes_pending. Attaching or detaching filters will not alter the state of \-changes_pending.
If the filter manipulations shall be the only changes in a write run, then If the filter manipulations shall be the only changes in a write run, then
explicitely execute \-changes_pending "yes". explicitly execute \-changes_pending "yes".
.TP .TP
\fB\-set_filter_r\fR name iso_rr_path [***] \fB\-set_filter_r\fR name iso_rr_path [***]
Like \-set_filter but affecting all data files below eventual directories. Like \-set_filter but affecting all data files below eventual directories.
@ -2967,7 +2966,7 @@ its option \-multi is missing.
Set the write type for the next burn run. "auto" will select SAO with blank Set the write type for the next burn run. "auto" will select SAO with blank
CD media, DAO with blank DVD\-R[W] if \-close is "on", and elsewise CD TAO or the CD media, DAO with blank DVD\-R[W] if \-close is "on", and elsewise CD TAO or the
equivalent write type of the particular DVD/BD media. equivalent write type of the particular DVD/BD media.
Choosing TAO or SAO/DAO explicitely might cause the burn run to fail if the Choosing TAO or SAO/DAO explicitly might cause the burn run to fail if the
desired write type is not possible with the given media state. desired write type is not possible with the given media state.
.TP .TP
\fB\-padding\fR number["k"|"m"]|"included"|"appended" \fB\-padding\fR number["k"|"m"]|"included"|"appended"
@ -3330,7 +3329,7 @@ the partition table. 0 chooses a default value. Maximum is 255.
the partition table. 0 chooses a default value. Maximum is 63. the partition table. 0 chooses a default value. Maximum is 63.
.br .br
The product partition_sec_hd * partition_hd_cyl * 512 is the cylinder size. The product partition_sec_hd * partition_hd_cyl * 512 is the cylinder size.
It should be divisible by 2048 in order to allow exact alignment. It should be divisible by 2048 in order to make exact alignment possible.
With appended partitions and "appended_part_as=gpt" there With appended partitions and "appended_part_as=gpt" there
is no limit for the number of cylinders. Else there may be at most 1024 is no limit for the number of cylinders. Else there may be at most 1024
of them. of them.
@ -3368,9 +3367,8 @@ It will overwrite the first 512 bytes of any data provided by system_area=.
Only a single boot file can be declared by mipsel_path=. Only a single boot file can be declared by mipsel_path=.
.br .br
\fBsparc_label=\fRtext causes the production of a SUN Disk Label with the \fBsparc_label=\fRtext causes the production of a SUN Disk Label with the
given text as ASCII label. This boot block format allows to append images given text as ASCII label. Partitions 2 to 8 may occupied by appended images.
for partitions 2 to 8. Partition 1 will always be the ISO image. Partition 1 will always be the ISO image. See command \-append_partition.
See command \-append_partition.
The first 512 bytes of any data provided by system_area= will be overwritten. The first 512 bytes of any data provided by system_area= will be overwritten.
.br .br
\fBgrub2_sparc_core=\fRiso_rr_path causes the content address and size \fBgrub2_sparc_core=\fRiso_rr_path causes the content address and size
@ -3885,11 +3883,11 @@ to be the most recent real session then.
Some read\-only drives and media show no usable session history at all. Some read\-only drives and media show no usable session history at all.
Command \-rom_toc_scan might help. Command \-rom_toc_scan might help.
.br .br
If input device and output device are both aquired and not the same, If input device and output device are both acquired and not the same,
then both tables\-of\-content get shown. then both tables\-of\-content get shown.
.TP .TP
\fB\-toc_of\fR "in"|"out"|"all"[":short"] \fB\-toc_of\fR "in"|"out"|"all"[":short"]
Like command \-toc but explicitely choosing which drive's table\-of\-content Like command \-toc but explicitly choosing which drive's table\-of\-content
to show. "in" shows \-indev or \-dev, "out" shows \-outdev or \-dev, to show. "in" shows \-indev or \-dev, "out" shows \-outdev or \-dev,
"all" shows the same as \-toc. "all" shows the same as \-toc.
.br .br
@ -3897,7 +3895,7 @@ If ":short" is appended to the drive choosing word, then only a short
summary of drive state and medium content is printed. summary of drive state and medium content is printed.
.br .br
As further difference to \-toc, this command does not emit FAILURE events As further difference to \-toc, this command does not emit FAILURE events
if the desired drive is not aquired. if the desired drive is not acquired.
.TP .TP
\fB\-mount_cmd\fR drive entity id path \fB\-mount_cmd\fR drive entity id path
Emit an appropriate command line for mounting the ISO session Emit an appropriate command line for mounting the ISO session
@ -3922,7 +3920,7 @@ for direct execution of this command.
Set options which influence \-mount and \-mount_cmd. Currently there is only Set options which influence \-mount and \-mount_cmd. Currently there is only
option "exclusive" which is default and its counterpart "shared". The latter option "exclusive" which is default and its counterpart "shared". The latter
causes \fBxorriso\fR not to give up the affected drive with command \-mount. causes \fBxorriso\fR not to give up the affected drive with command \-mount.
On GNU/Linux it adds mount option "loop" which may allow to mount several On GNU/Linux it adds mount option "loop" which may enable mounting of several
sessions of the same block device at the same time. One should not write sessions of the same block device at the same time. One should not write
to a mounted optical medium, of course. Take care to umount all sessions to a mounted optical medium, of course. Take care to umount all sessions
before ejecting. before ejecting.
@ -4361,10 +4359,10 @@ recorded MD5 checksums. Severity "ALL" disables this event.
tries to read the file given by disk_path as tries to read the file given by disk_path as
sector bitmap and to store such a map file after the scan run. sector bitmap and to store such a map file after the scan run.
The bitmap tells which blocks have been read successfully in previous runs. The bitmap tells which blocks have been read successfully in previous runs.
It allows to do several scans on the same medium, even with intermediate It is the persistent memory for several scans on the same medium, even with
eject, in order to collect readable blocks whenever the drive is lucky enough intermediate eject, in order to collect readable blocks whenever the drive
to produce them. The stored file contains a human readable TOC of tracks is lucky enough to produce them. The stored file contains a human readable
and their start block addresses, followed by binary bitmap data. TOC of tracks and their start block addresses, followed by binary bitmap data.
.br .br
By default, untested blocks are not considered bad, but rather as intentionally By default, untested blocks are not considered bad, but rather as intentionally
unread. If you expect time_limit= or item_limit= to abort the run, then unread. If you expect time_limit= or item_limit= to abort the run, then
@ -4477,7 +4475,7 @@ are owned by the effective user who runs \fBxorriso\fR. This happens
by temporarily granting rwx permission to the owner. by temporarily granting rwx permission to the owner.
.br .br
Option "sort_lba_on" may improve read performance with optical drives. It Option "sort_lba_on" may improve read performance with optical drives. It
allows to restore large numbers of hard links without exhausting can restore large numbers of hard links without exhausting
\-temp_mem_limit. It does not preserve directory mtime and it needs \-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 \-osirrox option auto_chmod_on in order to extract directories which offer no
write permission. Default is "sort_lba_off". write permission. Default is "sort_lba_off".
@ -4485,7 +4483,7 @@ write permission. Default is "sort_lba_off".
Option "o_excl_on" is the default unless the program was started with leafname Option "o_excl_on" is the default unless the program was started with leafname
"osirrox". On GNU/Linux it tries to avoid using drives which are mounted or in "osirrox". On GNU/Linux it tries to avoid using drives which are mounted or in
use by other libburn programs. use by other libburn programs.
Option "o_excl_off" allows on GNU/Linux to access such drives. Drives which Option "o_excl_off" on GNU/Linux enables access to such drives. Drives which
get acquired while "o_excl_off" will refuse to get blanked, formatted, get acquired while "o_excl_off" will refuse to get blanked, formatted,
written, or ejected. But be aware that even harmless inquiries can spoil written, or ejected. But be aware that even harmless inquiries can spoil
ongoing burns of CD\-R[W] and DVD\-R[W]. ongoing burns of CD\-R[W] and DVD\-R[W].
@ -4519,9 +4517,9 @@ composed from iso_rr_path by replacing iso_rr_prefix by disk_prefix.
\fB\-extract_cut\fR iso_rr_path byte_offset byte_count disk_path \fB\-extract_cut\fR iso_rr_path byte_offset byte_count disk_path
Copy a byte interval from a data file out of an ISO image into a newly created Copy a byte interval from a data file out of an ISO image into a newly created
disk file. disk file.
The main purpose for this is to allow handling of large files if they The main purpose for this is to offer a way of handling large files if they
are not supported by mount \-t iso9660 and if the reading system is unable are not supported by mount \-t iso9660 or if the target disk filesystem cannot
to buffer them as a whole. store large files.
.br .br
If the data bytes of iso_rr_path are stored in the loaded ISO image, If the data bytes of iso_rr_path are stored in the loaded ISO image,
and no filter is applied, and no filter is applied,
@ -4990,7 +4988,7 @@ wait for the user to hit the Enter key
or to send a line via stdin. or to send a line via stdin.
.TP .TP
\fB\-sleep\fR seconds \fB\-sleep\fR seconds
Wait for the given number of seconds before perfoming the next command. Wait for the given number of seconds before performing the next command.
Expect coarse granularity no better than 1/100 seconds. Expect coarse granularity no better than 1/100 seconds.
.TP .TP
\fB\-errfile_log\fR mode path|channel \fB\-errfile_log\fR mode path|channel
@ -5517,7 +5515,7 @@ $ xorriso \-dev stdio:/dev/sdb ...
.br .br
If /dev/sdb is to be used frequently and /dev/sda is the system disk, If /dev/sdb is to be used frequently and /dev/sda is the system disk,
then consider to place the following lines in a \fBxorriso\fR Startup File. then consider to place the following lines in a \fBxorriso\fR Startup File.
They allow to use /dev/sdb without prefix and protect disk /dev/sda They allow you to use /dev/sdb without prefix and protect disk /dev/sda
from \fBxorriso\fR: from \fBxorriso\fR:
.br .br
\-drive_class banned /dev/sda* \-drive_class banned /dev/sda*
@ -5803,8 +5801,8 @@ program name pre\-select certain settings:
.br .br
\fBxorrecord\fR starts \fBxorriso\fR with \-as cdrecord emulation. \fBxorrecord\fR starts \fBxorriso\fR with \-as cdrecord emulation.
.br .br
\fBosirrox\fR starts with \-osirrox "on:o_excl_off" which allows \fBosirrox\fR starts with \-osirrox "on:o_excl_off" which allows further
to copy files from ISO image to disk and to apply command \-mount to commands to copy files from ISO image to disk and to apply command \-mount to
one or more of the existing ISO sessions. one or more of the existing ISO sessions.
.SS .SS
.B Startup files: .B Startup files:

251
xorriso/xorriso.info
View File

@ -46,7 +46,7 @@ File: xorriso.info, Node: Overview, Next: Model, Prev: Top, Up: Top
********** **********
'xorriso' is a program which copies file objects from POSIX compliant 'xorriso' is a program which copies file objects from POSIX compliant
filesystems into Rock Ridge enhanced ISO 9660 filesystems and allows filesystems into Rock Ridge enhanced ISO 9660 filesystems and performs
session-wise manipulation of such filesystems. It can load the session-wise manipulation of such filesystems. It can load the
management information of existing ISO images and it writes the session management information of existing ISO images and it writes the session
results to optical media or to filesystem objects. results to optical media or to filesystem objects.
@ -104,8 +104,8 @@ images from devices that represent arbitrary media or from regular disk
files. files.
This session usage model has been extended on CD media by the concept This session usage model has been extended on CD media by the concept
of *multi-session* , which allows to add information to the CD and gives of *multi-session* , which adds information to the CD and gives the
the mount programs of the operating systems the addresses of the entry mount programs of the operating systems the addresses of the entry
points of each session. The mount programs recognize block devices points of each session. The mount programs recognize block devices
which represent CD media and will by default mount the image in the last which represent CD media and will by default mount the image in the last
session. session.
@ -126,7 +126,7 @@ modifications. See paragraph Creating, Growing, Modifying, Blind
Growing below. Growing below.
'xorriso' adopts the concept of multi-session by loading an image 'xorriso' adopts the concept of multi-session by loading an image
directory tree if present, by allowing to manipulate it by several directory tree if present, by offering to manipulate it by several
actions, and by writing the new image to the target medium. The first actions, and by writing the new image to the target medium. The first
session of a 'xorriso' run begins by the definition of the input drive session of a 'xorriso' run begins by the definition of the input drive
with the ISO image or by the definition of an output drive. The session with the ISO image or by the definition of an output drive. The session
@ -155,11 +155,11 @@ There are two families of media in the MMC standard:
unformatted DVD-RW. These media provide a table of content which unformatted DVD-RW. These media provide a table of content which
describes their existing sessions. See command *-toc*. describes their existing sessions. See command *-toc*.
Similar to multi-session media are DVD-R DL and minimally blanked Similar to multi-session media are DVD-R DL and minimally blanked
DVD-RW. They allow only a single session of which the size must be known DVD-RW. They record only a single session of which the size must be
in advance. 'xorriso' will write onto them only if command -close is known in advance. 'xorriso' will write onto them only if command -close
set to "on". is set to "on".
*Overwriteable media* are DVD-RAM, DVD+RW, BD-RE, and formatted DVD-RW. *Overwriteable media* are DVD-RAM, DVD+RW, BD-RE, and formatted DVD-RW.
They allow random write access but do not provide information about They offer random write access but do not provide information about
their session history. If they contain one or more ISO 9660 sessions their session history. If they contain one or more ISO 9660 sessions
and if the first session was written by 'xorriso', then a table of and if the first session was written by 'xorriso', then a table of
content can be emulated. Else only a single overall session will be content can be emulated. Else only a single overall session will be
@ -293,8 +293,8 @@ bundle the authorized users in a group like old "floppy".
Filesystem objects of nearly any type can be addressed by prefix Filesystem objects of nearly any type can be addressed by prefix
"stdio:" and their path in the filesystem. E.g.: "stdio:" and their path in the filesystem. E.g.:
-dev stdio:/dev/sdc -dev stdio:/dev/sdc
The default setting of -drive_class allows to address files outside the The default setting of -drive_class allows the user to address files
/dev tree without that prefix. E.g.: outside the /dev tree without that prefix. E.g.:
-dev /tmp/pseudo_drive -dev /tmp/pseudo_drive
If path leads to a regular file or to a block device then the emulated If path leads to a regular file or to a block device then the emulated
drive is random access readable and can be used for the method of drive is random access readable and can be used for the method of
@ -325,7 +325,7 @@ file or device by using its path with the "stdio:" prefix. By default
any address in the /dev tree without prefix "stdio:" will work only if any address in the /dev tree without prefix "stdio:" will work only if
it leads to a MMC drive. it leads to a MMC drive.
One may use command *-ban_stdio_write* to surely prevent this risk and One may use command *-ban_stdio_write* to surely prevent this risk and
to allow only MMC drives. to restrict drive usage to MMC drives.
One may prepend "mmc:" to a path to surely disallow any automatic One may prepend "mmc:" to a path to surely disallow any automatic
"stdio:". By command -drive_class one may ban certain paths or allow "stdio:". By command -drive_class one may ban certain paths or allow
access without prefix "stdio:" to other paths. access without prefix "stdio:" to other paths.
@ -398,11 +398,11 @@ only on GNU/Linux and FreeBSD.
*xattr* (aka EA, or extattr) are pairs of name and value which can be *xattr* (aka EA, or extattr) are pairs of name and value which can be
attached to file objects. AAIP is able to represent them and 'xorriso' attached to file objects. AAIP is able to represent them and 'xorriso'
allows to record and restore pairs which have names out of the user can record and restore pairs which have names out of the user namespace.
namespace. I.e. those which begin with "user.", like "user.x" or I.e. those which begin with "user.", like "user.x" or "user.whatever".
"user.whatever". Name has to be a 0 terminated string. Value may be Name has to be a 0 terminated string. Value may be any array of bytes
any array of bytes which does not exceed the size of 4095 bytes. xattr which does not exceed the size of 4095 bytes. xattr processing happens
processing happens only if it is enabled by command *-xattr*. only if it is enabled by command *-xattr*.
As with ACL, currently only 'xorriso' is able to retrieve xattr from As with ACL, currently only 'xorriso' is able to retrieve xattr from
AAIP enhanced images, to restore them to xattr capable file systems, or AAIP enhanced images, to restore them to xattr capable file systems, or
to print them. to print them.
@ -465,7 +465,7 @@ line to be appended.
Quoted input accepts any 8-bit character except NUL (0) as the content Quoted input accepts any 8-bit character except NUL (0) as the content
of the quotes. Nevertheless it can be cumbersome for the user to of the quotes. Nevertheless it can be cumbersome for the user to
produce those characters directly. Therefore quoted input and program produce those characters directly. Therefore quoted input and program
arguments allow optional *Backslash Interpretation* which can represent arguments offer optional *Backslash Interpretation* which can represent
all 8-bit characters except NUL (0) via backslash codes as in $'...' of all 8-bit characters except NUL (0) via backslash codes as in $'...' of
bash. bash.
This is not enabled by default. See command -backslash_codes. This is not enabled by default. See command -backslash_codes.
@ -494,10 +494,10 @@ services to make dialog more comfortable.
it from the bash shell. Whether it is available in 'xorriso' depends on it from the bash shell. Whether it is available in 'xorriso' depends on
the availability of package readline-dev at the time when 'xorriso' was the availability of package readline-dev at the time when 'xorriso' was
built from its sourcecode. built from its sourcecode.
Readline allows to move the cursor over the text in the line by help of Readline lets the user move the cursor over the text in the line by help
the Left and the Right arrow keys. Text may be inserted at the cursor of the Left and the Right arrow keys. Text may be inserted at the
position. The Delete key removes the character under the cursor. Up cursor position. The Delete key removes the character under the cursor.
and Down arrow keys navigate through the history of previous input Up and Down arrow keys navigate through the history of previous input
lines. lines.
See info readline for more info about libreadline. See info readline for more info about libreadline.
@ -860,10 +860,10 @@ activate them only after image loading.
-disk_dev_ino "on"|"ino_only"|"off" -disk_dev_ino "on"|"ino_only"|"off"
Enable or disable processing of recorded file identification Enable or disable processing of recorded file identification
numbers (dev_t and ino_t). If enabled they are stored as xattr and numbers (dev_t and ino_t). If enabled they are stored as xattr and
allow to substantially accelerate file comparison. The root node can substantially accelerate file comparison. The root node gets a
gets a global start timestamp. If during comparison a file with global start timestamp. If during comparison a file with younger
younger timestamps is found in the ISO image, then it is suspected timestamps is found in the ISO image, then it is suspected to have
to have inconsistent content. inconsistent content.
If device numbers and inode numbers of the disk filesystems are If device numbers and inode numbers of the disk filesystems are
persistent and if no irregular alterations of timestamps or system persistent and if no irregular alterations of timestamps or system
clock happen, then potential content changes can be detected clock happen, then potential content changes can be detected
@ -888,7 +888,7 @@ activate them only after image loading.
the file paths with truncated components. To avoid confusion by the file paths with truncated components. To avoid confusion by
having both truncated and untrancated names in the same directory, having both truncated and untrancated names in the same directory,
it is not possible to change this setting after a drive was it is not possible to change this setting after a drive was
aquired. All file names get truncated by the same length. acquired. All file names get truncated by the same length.
File name patterns will only work if they match the truncated name. File name patterns will only work if they match the truncated name.
This might change in future. This might change in future.
Linux kernels up to at least 4.1 misrepresent names of length 254 Linux kernels up to at least 4.1 misrepresent names of length 254
@ -1275,12 +1275,12 @@ File: xorriso.info, Node: SetInsert, Next: Manip, Prev: Insert, Up: Commands
"off" disables pathspecs of the form target=source and re-enables "off" disables pathspecs of the form target=source and re-enables
-disk_pattern expansion. -disk_pattern expansion.
-overwrite "on"|"nondir"|"off" -overwrite "on"|"nondir"|"off"
Allow or disallow to overwrite existing files in the ISO image by Allow or disallow overwriting of existing files in the ISO image by
files with the same name. files with the same name.
With setting "off", name collisions cause FAILURE events. With With setting "off", name collisions cause FAILURE events. With
setting "nondir", only directories are protected by such events, setting "nondir", only directories are protected by such events,
other existing file types get treated with -rm before the new file other existing file types get treated with -rm before the new file
gets added. Setting "on" allows automatic -rm_r. I.e. a gets added. Setting "on" enables automatic -rm_r. I.e. a
non-directory can replace an existing directory and all its non-directory can replace an existing directory and all its
subordinates. subordinates.
If restoring of files is enabled, then the overwrite rule applies If restoring of files is enabled, then the overwrite rule applies
@ -1937,7 +1937,7 @@ there are many small files.
"--remove-all-filters+" to prevent any suffix renaming. "--remove-all-filters+" to prevent any suffix renaming.
Attaching or detaching filters will not alter the state of Attaching or detaching filters will not alter the state of
-changes_pending. If the filter manipulations shall be the only -changes_pending. If the filter manipulations shall be the only
changes in a write run, then explicitely execute -changes_pending changes in a write run, then explicitly execute -changes_pending
"yes". "yes".
-set_filter_r name iso_rr_path [***] -set_filter_r name iso_rr_path [***]
Like -set_filter but affecting all data files below eventual Like -set_filter but affecting all data files below eventual
@ -2514,7 +2514,7 @@ according to the setting of command -acl.
Set the write type for the next burn run. "auto" will select SAO Set the write type for the next burn run. "auto" will select SAO
with blank CD media, DAO with blank DVD-R[W] if -close is "on", and with blank CD media, DAO with blank DVD-R[W] if -close is "on", and
elsewise CD TAO or the equivalent write type of the particular elsewise CD TAO or the equivalent write type of the particular
DVD/BD media. Choosing TAO or SAO/DAO explicitely might cause the DVD/BD media. Choosing TAO or SAO/DAO explicitly might cause the
burn run to fail if the desired write type is not possible with the burn run to fail if the desired write type is not possible with the
given media state. given media state.
-padding number["k"|"m"]|"included"|"appended" -padding number["k"|"m"]|"included"|"appended"
@ -2804,8 +2804,8 @@ Examples:
*partition_sec_hd=*number gives the number of sectors per head for *partition_sec_hd=*number gives the number of sectors per head for
the partition table. 0 chooses a default value. Maximum is 63. the partition table. 0 chooses a default value. Maximum is 63.
The product partition_sec_hd * partition_hd_cyl * 512 is the The product partition_sec_hd * partition_hd_cyl * 512 is the
cylinder size. It should be divisible by 2048 in order to allow cylinder size. It should be divisible by 2048 in order to make
exact alignment. With appended partitions and exact alignment possible. With appended partitions and
"appended_part_as=gpt" there is no limit for the number of "appended_part_as=gpt" there is no limit for the number of
cylinders. Else there may be at most 1024 of them. If the cylinders. Else there may be at most 1024 of them. If the
cylinder size is too small to stay below the limit, then cylinder size is too small to stay below the limit, then
@ -2836,10 +2836,10 @@ Examples:
data provided by system_area=. Only a single boot file can be data provided by system_area=. Only a single boot file can be
declared by mipsel_path=. declared by mipsel_path=.
*sparc_label=*text causes the production of a SUN Disk Label with *sparc_label=*text causes the production of a SUN Disk Label with
the given text as ASCII label. This boot block format allows to the given text as ASCII label. Partitions 2 to 8 may occupied by
append images for partitions 2 to 8. Partition 1 will always be appended images. Partition 1 will always be the ISO image. See
the ISO image. See command -append_partition. The first 512 bytes command -append_partition. The first 512 bytes of any data
of any data provided by system_area= will be overwritten. provided by system_area= will be overwritten.
*grub2_sparc_core=*iso_rr_path causes the content address and size *grub2_sparc_core=*iso_rr_path causes the content address and size
of the given file to be written after the SUN Disk Label. Both of the given file to be written after the SUN Disk Label. Both
numbers are counted in bytes. The address is written as 64 bit numbers are counted in bytes. The address is written as 64 bit
@ -3257,16 +3257,16 @@ File: xorriso.info, Node: Inquiry, Next: Navigate, Prev: DialogCtl, Up: Comm
sessions is supposed to be the most recent real session then. sessions is supposed to be the most recent real session then.
Some read-only drives and media show no usable session history at Some read-only drives and media show no usable session history at
all. Command -rom_toc_scan might help. all. Command -rom_toc_scan might help.
If input device and output device are both aquired and not the If input device and output device are both acquired and not the
same, then both tables-of-content get shown. same, then both tables-of-content get shown.
-toc_of "in"|"out"|"all"[":short"] -toc_of "in"|"out"|"all"[":short"]
Like command -toc but explicitely choosing which drive's Like command -toc but explicitly choosing which drive's
table-of-content to show. "in" shows -indev or -dev, "out" shows table-of-content to show. "in" shows -indev or -dev, "out" shows
-outdev or -dev, "all" shows the same as -toc. -outdev or -dev, "all" shows the same as -toc.
If ":short" is appended to the drive choosing word, then only a If ":short" is appended to the drive choosing word, then only a
short summary of drive state and medium content is printed. short summary of drive state and medium content is printed.
As further difference to -toc, this command does not emit FAILURE As further difference to -toc, this command does not emit FAILURE
events if the desired drive is not aquired. events if the desired drive is not acquired.
-mount_cmd drive entity id path -mount_cmd drive entity id path
Emit an appropriate command line for mounting the ISO session Emit an appropriate command line for mounting the ISO session
indicated by drive, entity and id. The result will be different on indicated by drive, entity and id. The result will be different on
@ -3287,9 +3287,9 @@ File: xorriso.info, Node: Inquiry, Next: Navigate, Prev: DialogCtl, Up: Comm
is only option "exclusive" which is default and its counterpart is only option "exclusive" which is default and its counterpart
"shared". The latter causes 'xorriso' not to give up the affected "shared". The latter causes 'xorriso' not to give up the affected
drive with command -mount. On GNU/Linux it adds mount option drive with command -mount. On GNU/Linux it adds mount option
"loop" which may allow to mount several sessions of the same block "loop" which may enable mounting of several sessions of the same
device at the same time. One should not write to a mounted optical block device at the same time. One should not write to a mounted
medium, of course. Take care to umount all sessions before optical medium, of course. Take care to umount all sessions before
ejecting. ejecting.
-session_string drive entity id format -session_string drive entity id format
Print to the result channel a text which gets composed according to Print to the result channel a text which gets composed according to
@ -3650,11 +3650,11 @@ transmission errors.
tries to read the file given by disk_path as sector bitmap and tries to read the file given by disk_path as sector bitmap and
to store such a map file after the scan run. The bitmap tells to store such a map file after the scan run. The bitmap tells
which blocks have been read successfully in previous runs. It which blocks have been read successfully in previous runs. It
allows to do several scans on the same medium, even with is the persistent memory for several scans on the same medium,
intermediate eject, in order to collect readable blocks even with intermediate eject, in order to collect readable
whenever the drive is lucky enough to produce them. The blocks whenever the drive is lucky enough to produce them.
stored file contains a human readable TOC of tracks and their The stored file contains a human readable TOC of tracks and
start block addresses, followed by binary bitmap data. their start block addresses, followed by binary bitmap data.
By default, untested blocks are not considered bad, but rather By default, untested blocks are not considered bad, but rather
as intentionally unread. If you expect time_limit= or as intentionally unread. If you expect time_limit= or
item_limit= to abort the run, then consider to use item_limit= to abort the run, then consider to use
@ -3759,7 +3759,7 @@ The directory permissions on disk have to allow rwx.
directories are owned by the effective user who runs 'xorriso'. directories are owned by the effective user who runs 'xorriso'.
This happens by temporarily granting rwx permission to the owner. This happens by temporarily granting rwx permission to the owner.
Option "sort_lba_on" may improve read performance with optical Option "sort_lba_on" may improve read performance with optical
drives. It allows to restore large numbers of hard links without drives. It can restore large numbers of hard links without
exhausting -temp_mem_limit. It does not preserve directory mtime exhausting -temp_mem_limit. It does not preserve directory mtime
and it needs -osirrox option auto_chmod_on in order to extract and it needs -osirrox option auto_chmod_on in order to extract
directories which offer no write permission. Default is directories which offer no write permission. Default is
@ -3767,7 +3767,7 @@ The directory permissions on disk have to allow rwx.
Option "o_excl_on" is the default unless the program was started Option "o_excl_on" is the default unless the program was started
with leafname "osirrox". On GNU/Linux it tries to avoid using with leafname "osirrox". On GNU/Linux it tries to avoid using
drives which are mounted or in use by other libburn programs. drives which are mounted or in use by other libburn programs.
Option "o_excl_off" allows on GNU/Linux to access such drives. Option "o_excl_off" on GNU/Linux enables access to such drives.
Drives which get acquired while "o_excl_off" will refuse to get Drives which get acquired while "o_excl_off" will refuse to get
blanked, formatted, written, or ejected. But be aware that even blanked, formatted, written, or ejected. But be aware that even
harmless inquiries can spoil ongoing burns of CD-R[W] and DVD-R[W]. harmless inquiries can spoil ongoing burns of CD-R[W] and DVD-R[W].
@ -3796,10 +3796,9 @@ The directory permissions on disk have to allow rwx.
iso_rr_prefix by disk_prefix. iso_rr_prefix by disk_prefix.
-extract_cut iso_rr_path byte_offset byte_count disk_path -extract_cut iso_rr_path byte_offset byte_count disk_path
Copy a byte interval from a data file out of an ISO image into a Copy a byte interval from a data file out of an ISO image into a
newly created disk file. The main purpose for this is to allow newly created disk file. The main purpose for this is to offer a
handling of large files if they are not supported by mount -t way of handling large files if they are not supported by mount -t
iso9660 and if the reading system is unable to buffer them as a iso9660 or if the target disk filesystem cannot store large files.
whole.
If the data bytes of iso_rr_path are stored in the loaded ISO If the data bytes of iso_rr_path are stored in the loaded ISO
image, and no filter is applied, and byte_offset is a multiple of image, and no filter is applied, and byte_offset is a multiple of
2048, then a special run of -check_media is performed. It may be 2048, then a special run of -check_media is performed. It may be
@ -4171,7 +4170,7 @@ File: xorriso.info, Node: Scripting, Next: Frontend, Prev: Emulation, Up: Co
Show text at beginning of output line and wait for the user to hit Show text at beginning of output line and wait for the user to hit
the Enter key or to send a line via stdin. the Enter key or to send a line via stdin.
-sleep seconds -sleep seconds
Wait for the given number of seconds before perfoming the next Wait for the given number of seconds before performing the next
command. Expect coarse granularity no better than 1/100 seconds. command. Expect coarse granularity no better than 1/100 seconds.
-errfile_log mode path|channel -errfile_log mode path|channel
@ -4612,8 +4611,8 @@ devices:
If /dev/sdb is to be used frequently and /dev/sda is the system disk, If /dev/sdb is to be used frequently and /dev/sda is the system disk,
then consider to place the following lines in a 'xorriso' Startup File. then consider to place the following lines in a 'xorriso' Startup File.
They allow to use /dev/sdb without prefix and protect disk /dev/sda from They allow you to use /dev/sdb without prefix and protect disk /dev/sda
'xorriso': from 'xorriso':
-drive_class banned /dev/sda* -drive_class banned /dev/sda*
-drive_class harmless /dev/sdb -drive_class harmless /dev/sdb
@ -4889,9 +4888,9 @@ their program name pre-select certain settings:
*xorrisofs* starts 'xorriso' with -as mkisofs emulation. *xorrisofs* starts 'xorriso' with -as mkisofs emulation.
*xorrecord* starts 'xorriso' with -as cdrecord emulation. *xorrecord* starts 'xorriso' with -as cdrecord emulation.
*osirrox* starts with -osirrox "on:o_excl_off" which allows to copy *osirrox* starts with -osirrox "on:o_excl_off" which allows further
files from ISO image to disk and to apply command -mount to one or more commands to copy files from ISO image to disk and to apply command
of the existing ISO sessions. -mount to one or more of the existing ISO sessions.
11.2 Startup Files 11.2 Startup Files
================== ==================
@ -5047,14 +5046,14 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -compare_l reports ISO/disk differences: Navigate. (line 144) * -compare_l reports ISO/disk differences: Navigate. (line 144)
* -compare_r reports ISO/disk differences: Navigate. (line 140) * -compare_r reports ISO/disk differences: Navigate. (line 140)
* -compliance controls standard compliance: SetWrite. (line 56) * -compliance controls standard compliance: SetWrite. (line 56)
* -concat copies ISO file content: Restore. (line 119) * -concat copies ISO file content: Restore. (line 118)
* -copyright_file sets copyright file name: SetWrite. (line 223) * -copyright_file sets copyright file name: SetWrite. (line 223)
* -cpax copies files to disk: Restore. (line 101) * -cpax copies files to disk: Restore. (line 100)
* -cpr inserts like with cp -r: Insert. (line 143) * -cpr inserts like with cp -r: Insert. (line 143)
* -cpx copies files to disk: Restore. (line 90) * -cpx copies files to disk: Restore. (line 89)
* -cp_clone copies ISO directory tree: Insert. (line 175) * -cp_clone copies ISO directory tree: Insert. (line 175)
* -cp_rx copies file trees to disk: Restore. (line 104) * -cp_rx copies file trees to disk: Restore. (line 103)
* -cp_rx copies file trees to disk <1>: Restore. (line 112) * -cp_rx copies file trees to disk <1>: Restore. (line 111)
* -cut_out inserts piece of data file: Insert. (line 118) * -cut_out inserts piece of data file: Insert. (line 118)
* -data_cache_size adjusts read cache size: Loading. (line 312) * -data_cache_size adjusts read cache size: Loading. (line 312)
* -dev acquires one drive for input and output: AqDrive. (line 12) * -dev acquires one drive for input and output: AqDrive. (line 12)
@ -5135,7 +5134,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -md5 controls handling of MD5 sums: Loading. (line 173) * -md5 controls handling of MD5 sums: Loading. (line 173)
* -mkdir creates ISO directory: Insert. (line 156) * -mkdir creates ISO directory: Insert. (line 156)
* -modesty_on_drive keep drive buffer hungry: SetWrite. (line 320) * -modesty_on_drive keep drive buffer hungry: SetWrite. (line 320)
* -mount issues mount command for ISO session: Restore. (line 147) * -mount issues mount command for ISO session: Restore. (line 146)
* -mount_cmd composes mount command line: Inquiry. (line 49) * -mount_cmd composes mount command line: Inquiry. (line 49)
* -mount_cmd controls mount command: Inquiry. (line 64) * -mount_cmd controls mount command: Inquiry. (line 64)
* -msg_op perform operations on program messages: Frontend. (line 27) * -msg_op perform operations on program messages: Frontend. (line 27)
@ -5155,7 +5154,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -pacifier controls pacifier text form: Emulation. (line 166) * -pacifier controls pacifier text form: Emulation. (line 166)
* -padding sets amount or mode of image padding: SetWrite. (line 394) * -padding sets amount or mode of image padding: SetWrite. (line 394)
* -page set terminal geometry: DialogCtl. (line 18) * -page set terminal geometry: DialogCtl. (line 18)
* -paste_in copies file into disk file: Restore. (line 115) * -paste_in copies file into disk file: Restore. (line 114)
* -pathspecs sets meaning of = with -add: SetInsert. (line 115) * -pathspecs sets meaning of = with -add: SetInsert. (line 115)
* -path_list inserts paths from disk file: Insert. (line 75) * -path_list inserts paths from disk file: Insert. (line 75)
* -pkt_output consolidates text output: Frontend. (line 7) * -pkt_output consolidates text output: Frontend. (line 7)
@ -5319,7 +5318,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Emulation, pacifier form, -pacifier: Emulation. (line 166) * Emulation, pacifier form, -pacifier: Emulation. (line 166)
* Examples: Examples. (line 6) * Examples: Examples. (line 6)
* extattr, _definition: Extras. (line 66) * extattr, _definition: Extras. (line 66)
* File content, copy, -concat: Restore. (line 119) * File content, copy, -concat: Restore. (line 118)
* File names, curb length, -file_name_limit: Loading. (line 237) * File names, curb length, -file_name_limit: Loading. (line 237)
* File names, if neither Rock Ridge nor Joliet: Loading. (line 205) * File names, if neither Rock Ridge nor Joliet: Loading. (line 205)
* Filter, apply to file tree, -set_filter_r: Filter. (line 84) * Filter, apply to file tree, -set_filter_r: Filter. (line 84)
@ -5474,14 +5473,14 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Relocation directory, set name, -rr_reloc_dir: SetWrite. (line 144) * Relocation directory, set name, -rr_reloc_dir: SetWrite. (line 144)
* Rename, in ISO image, -move: Manip. (line 31) * Rename, in ISO image, -move: Manip. (line 31)
* Rename, in ISO image, -mv: Manip. (line 37) * Rename, in ISO image, -mv: Manip. (line 37)
* Restore, copy file into disk file, -paste_in: Restore. (line 115) * Restore, copy file into disk file, -paste_in: Restore. (line 114)
* Restore, copy file piece to disk, -extract_cut: Restore. (line 80) * Restore, copy file piece to disk, -extract_cut: Restore. (line 80)
* Restore, copy file to disk, -extract_single: Restore. (line 73) * Restore, copy file to disk, -extract_single: Restore. (line 73)
* Restore, copy file tree to disk, -extract: Restore. (line 62) * Restore, copy file tree to disk, -extract: Restore. (line 62)
* Restore, copy file trees to disk, -cp_rx: Restore. (line 104) * Restore, copy file trees to disk, -cp_rx: Restore. (line 103)
* Restore, copy file trees to disk, -cp_rx <1>: Restore. (line 112) * Restore, copy file trees to disk, -cp_rx <1>: Restore. (line 111)
* Restore, copy files to disk, -cpax: Restore. (line 101) * Restore, copy files to disk, -cpax: Restore. (line 100)
* Restore, copy files to disk, -cpx: Restore. (line 90) * Restore, copy files to disk, -cpx: Restore. (line 89)
* Restore, copy files to disk, -extract_l: Restore. (line 76) * Restore, copy files to disk, -extract_l: Restore. (line 76)
* Restore, enable ISO-to-disk, -osirrox: Restore. (line 18) * Restore, enable ISO-to-disk, -osirrox: Restore. (line 18)
* Result layout, more shell-like, -sh_style_result: Scripting. * Result layout, more shell-like, -sh_style_result: Scripting.
@ -5489,7 +5488,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Rock Ridge, _definition: Extras. (line 6) * Rock Ridge, _definition: Extras. (line 6)
* Session, altered start address, -displacement: Loading. (line 57) * Session, altered start address, -displacement: Loading. (line 57)
* Session, info string, -session_string: Inquiry. (line 73) * Session, info string, -session_string: Inquiry. (line 73)
* Session, issue mount command, -mount: Restore. (line 147) * Session, issue mount command, -mount: Restore. (line 146)
* Session, log when written, -session_log: Scripting. (line 134) * Session, log when written, -session_log: Scripting. (line 134)
* Session, mount command line, -mount_cmd: Inquiry. (line 49) * Session, mount command line, -mount_cmd: Inquiry. (line 49)
* Session, mount parameters, -mount_opts: Inquiry. (line 64) * Session, mount parameters, -mount_opts: Inquiry. (line 64)
@ -5547,58 +5546,58 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
Tag Table: Tag Table:
Node: Top415 Node: Top415
Node: Overview1369 Node: Overview1369
Node: Model3404 Node: Model3406
Node: Media6317 Node: Media6310
Node: Methods9003 Node: Methods8997
Node: Drives11589 Node: Drives11583
Node: Extras15144 Node: Extras15160
Node: Processing19620 Node: Processing19628
Node: Dialog23255 Node: Dialog23263
Node: Commands24941 Node: Commands24952
Node: ArgSort26618 Node: ArgSort26629
Node: AqDrive28112 Node: AqDrive28123
Node: Loading31167 Node: Loading31178
Node: Insert50158 Node: Insert50165
Node: SetInsert60383 Node: SetInsert60390
Node: Manip69231 Node: Manip69241
Node: CmdFind79014 Node: CmdFind79024
Node: Filter97109 Node: Filter97119
Node: Writing101732 Node: Writing101741
Node: SetWrite111887 Node: SetWrite111896
Node: Bootable134832 Node: Bootable134840
Node: Jigdo157368 Node: Jigdo157365
Node: Charset161627 Node: Charset161624
Node: Exception164954 Node: Exception164951
Node: DialogCtl171083 Node: DialogCtl171080
Node: Inquiry173685 Node: Inquiry173682
Node: Navigate182130 Node: Navigate182132
Node: Verify190425 Node: Verify190427
Node: Restore200287 Node: Restore200304
Node: Emulation208908 Node: Emulation208917
Node: Scripting219318 Node: Scripting219327
Node: Frontend227099 Node: Frontend227109
Node: Examples236734 Node: Examples236744
Node: ExDevices237912 Node: ExDevices237922
Node: ExCreate238573 Node: ExCreate238583
Node: ExDialog239873 Node: ExDialog239883
Node: ExGrowing241144 Node: ExGrowing241154
Node: ExModifying241953 Node: ExModifying241963
Node: ExBootable242463 Node: ExBootable242473
Node: ExCharset243018 Node: ExCharset243028
Node: ExPseudo243914 Node: ExPseudo243924
Node: ExCdrecord244837 Node: ExCdrecord244851
Node: ExMkisofs245157 Node: ExMkisofs245171
Node: ExGrowisofs246514 Node: ExGrowisofs246528
Node: ExException247668 Node: ExException247682
Node: ExTime248126 Node: ExTime248140
Node: ExIncBackup248584 Node: ExIncBackup248598
Node: ExRestore252610 Node: ExRestore252624
Node: ExRecovery253556 Node: ExRecovery253570
Node: Files254128 Node: Files254142
Node: Seealso255445 Node: Seealso255476
Node: Bugreport256160 Node: Bugreport256191
Node: Legal256751 Node: Legal256782
Node: CommandIdx257763 Node: CommandIdx257794
Node: ConceptIdx274732 Node: ConceptIdx274763
 
End Tag Table End Tag Table

80
xorriso/xorriso.texi
View File

@ -50,7 +50,7 @@
@c man .\" First parameter, NAME, should be all caps @c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection @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 .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRISO 1 "Version 1.4.1, Sep 16, 2015" @c man .TH XORRISO 1 "Version 1.4.1, Sep 20, 2015"
@c man .\" Please adjust this date whenever revising the manpage. @c man .\" Please adjust this date whenever revising the manpage.
@c man .\" @c man .\"
@c man .\" Some roff macros, for reference: @c man .\" Some roff macros, for reference:
@ -121,7 +121,7 @@ with Rock Ridge extensions.
@c man .PP @c man .PP
@command{xorriso} @command{xorriso}
is a program which copies file objects from POSIX compliant is a program which copies file objects from POSIX compliant
filesystems into Rock Ridge enhanced ISO 9660 filesystems and allows filesystems into Rock Ridge enhanced ISO 9660 filesystems and performs
session-wise manipulation of such filesystems. It can load the management session-wise manipulation of such filesystems. It can load the management
information of existing ISO images and it writes the session results to information of existing ISO images and it writes the session results to
optical media or to filesystem objects. optical media or to filesystem objects.
@ -225,7 +225,7 @@ represent arbitrary media or from regular disk files.
@cindex Multi-session, _definition @cindex Multi-session, _definition
This session usage model has been extended on CD media by the concept of This session usage model has been extended on CD media by the concept of
@strong{multi-session} , @strong{multi-session} ,
which allows to add information to the CD and gives the mount programs which adds information to the CD and gives the mount programs
of the operating systems the addresses of the entry points of each of the operating systems the addresses of the entry points of each
session. The mount programs recognize block devices which represent session. The mount programs recognize block devices which represent
CD media and will by default mount the image in the last session. CD media and will by default mount the image in the last session.
@ -252,7 +252,7 @@ See paragraph Creating, Growing, Modifying, Blind Growing below.
@sp 1 @sp 1
@command{xorriso} adopts the concept of multi-session by loading an @command{xorriso} adopts the concept of multi-session by loading an
image directory tree if present, image directory tree if present,
by allowing to manipulate it by several actions, by offering to manipulate it by several actions,
and by writing the new image to the target medium. and by writing the new image to the target medium.
@c man .br @c man .br
The first session of a @command{xorriso} run begins by the definition of The first session of a @command{xorriso} run begins by the definition of
@ -283,12 +283,12 @@ unformatted DVD-RW. These media provide a table of content which
describes their existing sessions. See command @strong{-toc}. describes their existing sessions. See command @strong{-toc}.
@* @*
Similar to multi-session media are DVD-R DL and minimally blanked DVD-RW. Similar to multi-session media are DVD-R DL and minimally blanked DVD-RW.
They allow only a single session of which the size must be known in advance. They record only a single session of which the size must be known in advance.
@command{xorriso} will write onto them only if command -close is set to "on". @command{xorriso} will write onto them only if command -close is set to "on".
@* @*
@cindex Overwriteable media, _definition @cindex Overwriteable media, _definition
@strong{Overwriteable media} are DVD-RAM, DVD+RW, BD-RE, and formatted DVD-RW. @strong{Overwriteable media} are DVD-RAM, DVD+RW, BD-RE, and formatted DVD-RW.
They allow random write access but do not provide information about their They offer random write access but do not provide information about their
session history. If they contain one or more ISO 9660 sessions and if the session history. If they contain one or more ISO 9660 sessions and if the
first session was written by @command{xorriso}, then a table of content can first session was written by @command{xorriso}, then a table of content can
be emulated. Else only a single overall session will be visible. be emulated. Else only a single overall session will be visible.
@ -461,8 +461,8 @@ their path in the filesystem. E.g.:
@* @*
-dev stdio:/dev/sdc -dev stdio:/dev/sdc
@* @*
The default setting of -drive_class allows to address files outside the The default setting of -drive_class allows the user to address files outside
/dev tree without that prefix. E.g.: the /dev tree without that prefix. E.g.:
@* @*
-dev /tmp/pseudo_drive -dev /tmp/pseudo_drive
@* @*
@ -502,7 +502,7 @@ drive.
@* @*
One may use command One may use command
@strong{-ban_stdio_write} @strong{-ban_stdio_write}
to surely prevent this risk and to allow only MMC drives. to surely prevent this risk and to restrict drive usage to MMC drives.
@* @*
One may prepend "mmc:" to a path to surely disallow any automatic "stdio:". One may prepend "mmc:" to a path to surely disallow any automatic "stdio:".
@c man .br @c man .br
@ -606,8 +606,7 @@ only on GNU/Linux and FreeBSD.
@cindex extattr, _definition @cindex extattr, _definition
@strong{xattr} (aka EA, or extattr) @strong{xattr} (aka EA, or extattr)
are pairs of name and value which can be attached to file objects. AAIP is are pairs of name and value which can be attached to file objects. AAIP is
able to represent them and @command{xorriso} allows to record and restore able to represent them and @command{xorriso} can record and restore pairs which
pairs which
have names out of the user namespace. I.e. those which begin with "user.", have names out of the user namespace. I.e. those which begin with "user.",
like "user.x" or "user.whatever". Name has to be a 0 terminated string. like "user.x" or "user.whatever". Name has to be a 0 terminated string.
Value may be any array of bytes which does not exceed the size of 4095 bytes. Value may be any array of bytes which does not exceed the size of 4095 bytes.
@ -691,7 +690,7 @@ quotations or an open quotation cause the next input line to be appended.
Quoted input accepts any 8-bit character except NUL (0) as the content of Quoted input accepts any 8-bit character except NUL (0) as the content of
the quotes. the quotes.
Nevertheless it can be cumbersome for the user to produce those characters Nevertheless it can be cumbersome for the user to produce those characters
directly. Therefore quoted input and program arguments allow optional directly. Therefore quoted input and program arguments offer optional
@strong{Backslash Interpretation} @strong{Backslash Interpretation}
which can represent all 8-bit characters except NUL (0) via backslash codes which can represent all 8-bit characters except NUL (0) via backslash codes
as in $'...' of bash. as in $'...' of bash.
@ -725,7 +724,7 @@ availability
of package readline-dev at the time when @command{xorriso} was built from of package readline-dev at the time when @command{xorriso} was built from
its sourcecode. its sourcecode.
@* @*
Readline allows to move the cursor over the text in the line by help of the Readline lets the user move the cursor over the text in the line by help of the
Left and the Right arrow keys. Left and the Right arrow keys.
Text may be inserted at the cursor position. The Delete key removes the Text may be inserted at the cursor position. The Delete key removes the
character under the cursor. Up and Down arrow keys navigate through character under the cursor. Up and Down arrow keys navigate through
@ -1198,8 +1197,8 @@ if any occur despite the prescriptions of ECMA-119.
@kindex -disk_dev_ino fast incremental backup @kindex -disk_dev_ino fast incremental backup
@cindex Backup, enable fast incremental, -disk_dev_ino @cindex Backup, enable fast incremental, -disk_dev_ino
Enable or disable processing of recorded file identification numbers Enable or disable processing of recorded file identification numbers
(dev_t and ino_t). If enabled they are stored as xattr and allow (dev_t and ino_t). If enabled they are stored as xattr and can
to substantially accelerate file comparison. The root node gets a global start substantially accelerate file comparison. The root node gets a global start
timestamp. If during comparison a file with younger timestamps is found in the timestamp. If during comparison a file with younger timestamps is found in the
ISO image, then it is suspected to have inconsistent content. ISO image, then it is suspected to have inconsistent content.
@* @*
@ -1232,7 +1231,7 @@ leading bytes replaced by '_'.
iso_rr_paths with the long components will still be able to access the iso_rr_paths with the long components will still be able to access the
file paths with truncated components. To avoid confusion by having both file paths with truncated components. To avoid confusion by having both
truncated and untrancated names in the same directory, it is not possible truncated and untrancated names in the same directory, it is not possible
to change this setting after a drive was aquired. All file names get to change this setting after a drive was acquired. All file names get
truncated by the same length. truncated by the same length.
@* @*
File name patterns will only work if they match the truncated name. File name patterns will only work if they match the truncated name.
@ -1777,13 +1776,13 @@ and re-enables -disk_pattern expansion.
@item -overwrite "on"|"nondir"|"off" @item -overwrite "on"|"nondir"|"off"
@kindex -overwrite enables overwriting in ISO @kindex -overwrite enables overwriting in ISO
@cindex Insert, enable overwriting, -overwrite @cindex Insert, enable overwriting, -overwrite
Allow or disallow to overwrite existing files in the Allow or disallow overwriting of existing files in the
ISO image by files with the same name. ISO image by files with the same name.
@* @*
With setting "off", name collisions cause FAILURE events. With setting "off", name collisions cause FAILURE events.
With setting "nondir", only directories are protected by such events, other With setting "nondir", only directories are protected by such events, other
existing file types get treated with -rm before the new file gets added. existing file types get treated with -rm before the new file gets added.
Setting "on" allows automatic -rm_r. I.e. a non-directory can replace an Setting "on" enables automatic -rm_r. I.e. a non-directory can replace an
existing directory and all its subordinates. existing directory and all its subordinates.
@* @*
If restoring of files is enabled, then the overwrite rule applies to the If restoring of files is enabled, then the overwrite rule applies to the
@ -2691,7 +2690,7 @@ prevent any suffix renaming.
@* @*
Attaching or detaching filters will not alter the state of -changes_pending. Attaching or detaching filters will not alter the state of -changes_pending.
If the filter manipulations shall be the only changes in a write run, then If the filter manipulations shall be the only changes in a write run, then
explicitely execute -changes_pending "yes". explicitly execute -changes_pending "yes".
@c man .TP @c man .TP
@item -set_filter_r name iso_rr_path [***] @item -set_filter_r name iso_rr_path [***]
@kindex -set_filter_r applies filter to file tree @kindex -set_filter_r applies filter to file tree
@ -3481,7 +3480,7 @@ its option -multi is missing.
Set the write type for the next burn run. "auto" will select SAO with blank Set the write type for the next burn run. "auto" will select SAO with blank
CD media, DAO with blank DVD-R[W] if -close is "on", and elsewise CD TAO or the CD media, DAO with blank DVD-R[W] if -close is "on", and elsewise CD TAO or the
equivalent write type of the particular DVD/BD media. equivalent write type of the particular DVD/BD media.
Choosing TAO or SAO/DAO explicitely might cause the burn run to fail if the Choosing TAO or SAO/DAO explicitly might cause the burn run to fail if the
desired write type is not possible with the given media state. desired write type is not possible with the given media state.
@c man .TP @c man .TP
@item -padding number["k"|"m"]|"included"|"appended" @item -padding number["k"|"m"]|"included"|"appended"
@ -3870,7 +3869,7 @@ the partition table. 0 chooses a default value. Maximum is 255.
the partition table. 0 chooses a default value. Maximum is 63. the partition table. 0 chooses a default value. Maximum is 63.
@* @*
The product partition_sec_hd * partition_hd_cyl * 512 is the cylinder size. The product partition_sec_hd * partition_hd_cyl * 512 is the cylinder size.
It should be divisible by 2048 in order to allow exact alignment. It should be divisible by 2048 in order to make exact alignment possible.
With appended partitions and "appended_part_as=gpt" there With appended partitions and "appended_part_as=gpt" there
is no limit for the number of cylinders. Else there may be at most 1024 is no limit for the number of cylinders. Else there may be at most 1024
of them. of them.
@ -3911,9 +3910,8 @@ Only a single boot file can be declared by mipsel_path=.
@* @*
@cindex SUN Disk Label, production @cindex SUN Disk Label, production
@strong{sparc_label=}text causes the production of a SUN Disk Label with the @strong{sparc_label=}text causes the production of a SUN Disk Label with the
given text as ASCII label. This boot block format allows to append images given text as ASCII label. Partitions 2 to 8 may occupied by appended images.
for partitions 2 to 8. Partition 1 will always be the ISO image. Partition 1 will always be the ISO image. See command -append_partition.
See command -append_partition.
The first 512 bytes of any data provided by system_area= will be overwritten. The first 512 bytes of any data provided by system_area= will be overwritten.
@* @*
@strong{grub2_sparc_core=}iso_rr_path causes the content address and size @strong{grub2_sparc_core=}iso_rr_path causes the content address and size
@ -4497,12 +4495,12 @@ to be the most recent real session then.
Some read-only drives and media show no usable session history at all. Some read-only drives and media show no usable session history at all.
Command -rom_toc_scan might help. Command -rom_toc_scan might help.
@* @*
If input device and output device are both aquired and not the same, If input device and output device are both acquired and not the same,
then both tables-of-content get shown. then both tables-of-content get shown.
@c man .TP @c man .TP
@item -toc_of "in"|"out"|"all"[":short"] @item -toc_of "in"|"out"|"all"[":short"]
@kindex -toc_of shows list of sessions @kindex -toc_of shows list of sessions
Like command -toc but explicitely choosing which drive's table-of-content Like command -toc but explicitly choosing which drive's table-of-content
to show. "in" shows -indev or -dev, "out" shows -outdev or -dev, to show. "in" shows -indev or -dev, "out" shows -outdev or -dev,
"all" shows the same as -toc. "all" shows the same as -toc.
@* @*
@ -4510,7 +4508,7 @@ If ":short" is appended to the drive choosing word, then only a short
summary of drive state and medium content is printed. summary of drive state and medium content is printed.
@* @*
As further difference to -toc, this command does not emit FAILURE events As further difference to -toc, this command does not emit FAILURE events
if the desired drive is not aquired. if the desired drive is not acquired.
@c man .TP @c man .TP
@item -mount_cmd drive entity id path @item -mount_cmd drive entity id path
@kindex -mount_cmd composes mount command line @kindex -mount_cmd composes mount command line
@ -4539,7 +4537,7 @@ for direct execution of this command.
Set options which influence -mount and -mount_cmd. Currently there is only Set options which influence -mount and -mount_cmd. Currently there is only
option "exclusive" which is default and its counterpart "shared". The latter option "exclusive" which is default and its counterpart "shared". The latter
causes @command{xorriso} not to give up the affected drive with command -mount. causes @command{xorriso} not to give up the affected drive with command -mount.
On GNU/Linux it adds mount option "loop" which may allow to mount several On GNU/Linux it adds mount option "loop" which may enable mounting of several
sessions of the same block device at the same time. One should not write sessions of the same block device at the same time. One should not write
to a mounted optical medium, of course. Take care to umount all sessions to a mounted optical medium, of course. Take care to umount all sessions
before ejecting. before ejecting.
@ -5061,10 +5059,10 @@ recorded MD5 checksums. Severity "ALL" disables this event.
tries to read the file given by disk_path as tries to read the file given by disk_path as
sector bitmap and to store such a map file after the scan run. sector bitmap and to store such a map file after the scan run.
The bitmap tells which blocks have been read successfully in previous runs. The bitmap tells which blocks have been read successfully in previous runs.
It allows to do several scans on the same medium, even with intermediate It is the persistent memory for several scans on the same medium, even with
eject, in order to collect readable blocks whenever the drive is lucky enough intermediate eject, in order to collect readable blocks whenever the drive
to produce them. The stored file contains a human readable TOC of tracks is lucky enough to produce them. The stored file contains a human readable
and their start block addresses, followed by binary bitmap data. TOC of tracks and their start block addresses, followed by binary bitmap data.
@* @*
By default, untested blocks are not considered bad, but rather as intentionally By default, untested blocks are not considered bad, but rather as intentionally
unread. If you expect time_limit= or item_limit= to abort the run, then unread. If you expect time_limit= or item_limit= to abort the run, then
@ -5189,7 +5187,7 @@ are owned by the effective user who runs @command{xorriso}. This happens
by temporarily granting rwx permission to the owner. by temporarily granting rwx permission to the owner.
@* @*
Option "sort_lba_on" may improve read performance with optical drives. It Option "sort_lba_on" may improve read performance with optical drives. It
allows to restore large numbers of hard links without exhausting can restore large numbers of hard links without exhausting
-temp_mem_limit. It does not preserve directory mtime and it needs -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 -osirrox option auto_chmod_on in order to extract directories which offer no
write permission. Default is "sort_lba_off". write permission. Default is "sort_lba_off".
@ -5197,7 +5195,7 @@ write permission. Default is "sort_lba_off".
Option "o_excl_on" is the default unless the program was started with leafname Option "o_excl_on" is the default unless the program was started with leafname
"osirrox". On GNU/Linux it tries to avoid using drives which are mounted or in "osirrox". On GNU/Linux it tries to avoid using drives which are mounted or in
use by other libburn programs. use by other libburn programs.
Option "o_excl_off" allows on GNU/Linux to access such drives. Drives which Option "o_excl_off" on GNU/Linux enables access to such drives. Drives which
get acquired while "o_excl_off" will refuse to get blanked, formatted, get acquired while "o_excl_off" will refuse to get blanked, formatted,
written, or ejected. But be aware that even harmless inquiries can spoil written, or ejected. But be aware that even harmless inquiries can spoil
ongoing burns of CD-R[W] and DVD-R[W]. ongoing burns of CD-R[W] and DVD-R[W].
@ -5239,9 +5237,9 @@ composed from iso_rr_path by replacing iso_rr_prefix by disk_prefix.
@cindex Restore, copy file piece to disk, -extract_cut @cindex Restore, copy file piece to disk, -extract_cut
Copy a byte interval from a data file out of an ISO image into a newly created Copy a byte interval from a data file out of an ISO image into a newly created
disk file. disk file.
The main purpose for this is to allow handling of large files if they The main purpose for this is to offer a way of handling large files if they
are not supported by mount -t iso9660 and if the reading system is unable are not supported by mount -t iso9660 or if the target disk filesystem cannot
to buffer them as a whole. store large files.
@* @*
If the data bytes of iso_rr_path are stored in the loaded ISO image, If the data bytes of iso_rr_path are stored in the loaded ISO image,
and no filter is applied, and no filter is applied,
@ -5786,7 +5784,7 @@ or to send a line via stdin.
@item -sleep seconds @item -sleep seconds
@kindex -sleep waits for a given time span @kindex -sleep waits for a given time span
@cindex Program, wait a time span, -sleep @cindex Program, wait a time span, -sleep
Wait for the given number of seconds before perfoming the next command. Wait for the given number of seconds before performing the next command.
Expect coarse granularity no better than 1/100 seconds. Expect coarse granularity no better than 1/100 seconds.
@c man .TP @c man .TP
@item -errfile_log mode path|channel @item -errfile_log mode path|channel
@ -6427,7 +6425,7 @@ $ xorriso -dev stdio:/dev/sdb ...
@sp 1 @sp 1
If /dev/sdb is to be used frequently and /dev/sda is the system disk, If /dev/sdb is to be used frequently and /dev/sda is the system disk,
then consider to place the following lines in a @command{xorriso} Startup File. then consider to place the following lines in a @command{xorriso} Startup File.
They allow to use /dev/sdb without prefix and protect disk /dev/sda They allow you to use /dev/sdb without prefix and protect disk /dev/sda
from @command{xorriso}: from @command{xorriso}:
@* @*
@sp 1 @sp 1
@ -6789,8 +6787,8 @@ program name pre-select certain settings:
@* @*
@strong{xorrecord} starts @command{xorriso} with -as cdrecord emulation. @strong{xorrecord} starts @command{xorriso} with -as cdrecord emulation.
@* @*
@strong{osirrox} starts with -osirrox "on:o_excl_off" which allows @strong{osirrox} starts with -osirrox "on:o_excl_off" which allows further
to copy files from ISO image to disk and to apply command -mount to commands to copy files from ISO image to disk and to apply command -mount to
one or more of the existing ISO sessions. one or more of the existing ISO sessions.
@c man .SS @c man .SS
@c man .B Startup files: @c man .B Startup files:

6
xorriso/xorriso_private.h
View File

@ -157,7 +157,7 @@ struct XorrisO { /* the global context of xorriso */
bit6= omit content check if bit5 check is conclusive bit6= omit content check if bit5 check is conclusive
bit7= omit dev check with bit5 bit7= omit dev check with bit5
bit8= store output charset in xattr "isofs.cs" bit8= store output charset in xattr "isofs.cs"
bit9= allow to set input charset from xattr "isofs.cs" bit9= set input charset from xattr "isofs.cs"
*/ */
int do_md5; /* bit0= read MD5 array int do_md5; /* bit0= read MD5 array
@ -304,7 +304,7 @@ struct XorrisO { /* the global context of xorriso */
char *in_charset; /* The charset to interpret the filename bytes */ char *in_charset; /* The charset to interpret the filename bytes */
int indev_is_exclusive; int indev_is_exclusive;
char indev_off_adr[SfileadrL]; /* Result of burn_drive_convert_fs_adr(indev) char indev_off_adr[SfileadrL]; /* Result of burn_drive_convert_fs_adr(indev)
when indev gets aquired. */ when indev gets acquired. */
time_t isofs_st_out; /* A time point at least 1 second before image time_t isofs_st_out; /* A time point at least 1 second before image
composition began. To be stored with image as composition began. To be stored with image as
@ -335,7 +335,7 @@ struct XorrisO { /* the global context of xorriso */
*/ */
int outdev_is_exclusive; int outdev_is_exclusive;
char outdev_off_adr[SfileadrL]; /* Result of burn_drive_convert_fs_adr(outdev) char outdev_off_adr[SfileadrL]; /* Result of burn_drive_convert_fs_adr(outdev)
when outdev gets aquired. */ when outdev gets acquired. */
int grow_blindly_msc2; /* if >= 0 this causes growing from drive to drive. int grow_blindly_msc2; /* if >= 0 this causes growing from drive to drive.
The value is used as block address offset for The value is used as block address offset for

2
xorriso/xorriso_timestamp.h
View File

@ -1 +1 @@
#define Xorriso_timestamP "2015.09.20.124012" #define Xorriso_timestamP "2015.09.20.125159"

10
xorriso/xorrisofs.1
View File

@ -9,7 +9,7 @@
.\" First parameter, NAME, should be all caps .\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1) .\" other parameters are allowed: see man(7), man(1)
.TH XORRISOFS 1 "Version 1.4.1, Sep 13, 2015" .TH XORRISOFS 1 "Version 1.4.1, Sep 20, 2015"
.\" Please adjust this date whenever revising the manpage. .\" Please adjust this date whenever revising the manpage.
.\" .\"
.\" Some roff macros, for reference: .\" Some roff macros, for reference:
@ -354,7 +354,7 @@ simultaneous production of more image content.
\fB--emul-toc\fR \fB--emul-toc\fR
Write a second superblock with the first session into random\-access Write a second superblock with the first session into random\-access
files. If further sessions get appended and the first superblock gets updated, files. If further sessions get appended and the first superblock gets updated,
then the second superblock will not be overwritten. This allows to still then the second superblock will not be overwritten. So it is still possible to
mount the first session and to find the start blocks of the further sessions. mount the first session and to find the start blocks of the further sessions.
.br .br
The price is 64 KiB extra space consumption. If \-partition_offset is non\-zero, The price is 64 KiB extra space consumption. If \-partition_offset is non\-zero,
@ -574,7 +574,7 @@ operating systems which mount the image.
Option \-D disables this deep directory relocation, and thus violates Option \-D disables this deep directory relocation, and thus violates
ISO 9660 specs. ISO 9660 specs.
.br .br
xorrisofs has \-D set by default. If given explicitely then it overrides xorrisofs has \-D set by default. If given explicitly then it overrides
the options \-rr_reloc_dir and \-hide\-rr\-moved. the options \-rr_reloc_dir and \-hide\-rr\-moved.
.TP .TP
\fB\-disable-deep-relocation\fR \fB\-disable-deep-relocation\fR
@ -915,7 +915,7 @@ FreeBSD AvgLiveCD wiki.
.PP .PP
For CD booting via boot facilities other than PC\-BIOS and EFI, and For CD booting via boot facilities other than PC\-BIOS and EFI, and
for booting from USB sticks or hard disks, see the next section for booting from USB sticks or hard disks, see the next section
about the Sytem Area. about the System Area.
.br .br
.TP .TP
\fB\-b\fR iso_rr_path \fB\-b\fR iso_rr_path
@ -1179,7 +1179,7 @@ Set the number of sectors per head for the MBR partition table.
0 chooses a default value. Maximum is 63. 0 chooses a default value. Maximum is 63.
.br .br
The product partition_sec_hd * partition_hd_cyl * 512 is the cylinder size. The product partition_sec_hd * partition_hd_cyl * 512 is the cylinder size.
It should be divisible by 2048 in order to allow exact alignment. It should be divisible by 2048 in order to make exact alignment possible.
With appended partitions and \-appended_part_as_gpt there is no limit for With appended partitions and \-appended_part_as_gpt there is no limit for
the number of cylinders. Else there may be at most 1024 of them. the number of cylinders. Else there may be at most 1024 of them.
If the cylinder size is too small to stay below the limit, If the cylinder size is too small to stay below the limit,

58
xorriso/xorrisofs.info
View File

@ -351,8 +351,8 @@ File: xorrisofs.info, Node: SetProduct, Next: SetCompl, Prev: SetInsert, Up:
Write a second superblock with the first session into random-access Write a second superblock with the first session into random-access
files. If further sessions get appended and the first superblock files. If further sessions get appended and the first superblock
gets updated, then the second superblock will not be overwritten. gets updated, then the second superblock will not be overwritten.
This allows to still mount the first session and to find the start So it is still possible to mount the first session and to find the
blocks of the further sessions. start blocks of the further sessions.
The price is 64 KiB extra space consumption. If -partition_offset The price is 64 KiB extra space consumption. If -partition_offset
is non-zero, then it is 128 KiB plus twice the partition setup. is non-zero, then it is 128 KiB plus twice the partition setup.
--no-emul-toc --no-emul-toc
@ -537,7 +537,7 @@ File: xorrisofs.info, Node: SetExtras, Next: SetHide, Prev: SetCompl, Up: Op
Option -D disables this deep directory relocation, and thus Option -D disables this deep directory relocation, and thus
violates ISO 9660 specs. violates ISO 9660 specs.
xorrisofs has -D set by default. If given explicitely then it xorrisofs has -D set by default. If given explicitly then it
overrides the options -rr_reloc_dir and -hide-rr-moved. overrides the options -rr_reloc_dir and -hide-rr-moved.
-disable-deep-relocation -disable-deep-relocation
Alias of -D. Alias of -D.
@ -825,7 +825,7 @@ FreeBSD AvgLiveCD wiki.
For CD booting via boot facilities other than PC-BIOS and EFI, and For CD booting via boot facilities other than PC-BIOS and EFI, and
for booting from USB sticks or hard disks, see the next section about for booting from USB sticks or hard disks, see the next section about
the Sytem Area. the System Area.
-b iso_rr_path -b iso_rr_path
Specify the boot image file which shall be mentioned in the current Specify the boot image file which shall be mentioned in the current
@ -1037,8 +1037,8 @@ Examples:
Set the number of sectors per head for the MBR partition table. 0 Set the number of sectors per head for the MBR partition table. 0
chooses a default value. Maximum is 63. chooses a default value. Maximum is 63.
The product partition_sec_hd * partition_hd_cyl * 512 is the The product partition_sec_hd * partition_hd_cyl * 512 is the
cylinder size. It should be divisible by 2048 in order to allow cylinder size. It should be divisible by 2048 in order to make
exact alignment. With appended partitions and exact alignment possible. With appended partitions and
-appended_part_as_gpt there is no limit for the number of -appended_part_as_gpt there is no limit for the number of
cylinders. Else there may be at most 1024 of them. If the cylinders. Else there may be at most 1024 of them. If the
cylinder size is too small to stay below the limit, then cylinder size is too small to stay below the limit, then
@ -2229,28 +2229,28 @@ Node: Options6725
Node: Loading7452 Node: Loading7452
Node: SetInsert9752 Node: SetInsert9752
Node: SetProduct14161 Node: SetProduct14161
Node: SetCompl19331 Node: SetCompl19337
Node: SetExtras21923 Node: SetExtras21929
Node: SetHide31287 Node: SetHide31292
Node: ImageId32591 Node: ImageId32596
Node: Bootable36762 Node: Bootable36767
Node: SystemArea41929 Node: SystemArea41935
Node: Charset56501 Node: Charset56515
Node: Jigdo57526 Node: Jigdo57540
Node: Miscellaneous61803 Node: Miscellaneous61817
Node: Examples63448 Node: Examples63462
Node: ExSimple63942 Node: ExSimple63956
Node: ExGraft64425 Node: ExGraft64439
Node: ExMkisofs65725 Node: ExMkisofs65739
Node: ExGrowisofs66991 Node: ExGrowisofs67005
Node: ExIncBackup68181 Node: ExIncBackup68195
Node: ExIncBckAcc71342 Node: ExIncBckAcc71356
Node: ExBootable73031 Node: ExBootable73045
Node: Files77213 Node: Files77227
Node: Seealso78308 Node: Seealso78322
Node: Bugreport78957 Node: Bugreport78971
Node: Legal79548 Node: Legal79562
Node: CommandIdx80445 Node: CommandIdx80459
Node: ConceptIdx95313 Node: ConceptIdx95327
 
End Tag Table End Tag Table

10
xorriso/xorrisofs.texi
View File

@ -50,7 +50,7 @@
@c man .\" First parameter, NAME, should be all caps @c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection @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 .\" other parameters are allowed: see man(7), man(1)
@c man .TH XORRISOFS 1 "Version 1.4.1, Sep 13, 2015" @c man .TH XORRISOFS 1 "Version 1.4.1, Sep 20, 2015"
@c man .\" Please adjust this date whenever revising the manpage. @c man .\" Please adjust this date whenever revising the manpage.
@c man .\" @c man .\"
@c man .\" Some roff macros, for reference: @c man .\" Some roff macros, for reference:
@ -533,7 +533,7 @@ simultaneous production of more image content.
@cindex Table-of-content, emulation, @minus{}@minus{}emul-toc @cindex Table-of-content, emulation, @minus{}@minus{}emul-toc
Write a second superblock with the first session into random-access Write a second superblock with the first session into random-access
files. If further sessions get appended and the first superblock gets updated, files. If further sessions get appended and the first superblock gets updated,
then the second superblock will not be overwritten. This allows to still then the second superblock will not be overwritten. So it is still possible to
mount the first session and to find the start blocks of the further sessions. mount the first session and to find the start blocks of the further sessions.
@* @*
The price is 64 KiB extra space consumption. If -partition_offset is non-zero, The price is 64 KiB extra space consumption. If -partition_offset is non-zero,
@ -819,7 +819,7 @@ operating systems which mount the image.
Option -D disables this deep directory relocation, and thus violates Option -D disables this deep directory relocation, and thus violates
ISO 9660 specs. ISO 9660 specs.
@* @*
xorrisofs has -D set by default. If given explicitely then it overrides xorrisofs has -D set by default. If given explicitly then it overrides
the options -rr_reloc_dir and -hide-rr-moved. the options -rr_reloc_dir and -hide-rr-moved.
@c man .TP @c man .TP
@item -disable-deep-relocation @item -disable-deep-relocation
@ -1252,7 +1252,7 @@ FreeBSD AvgLiveCD wiki.
@sp 1 @sp 1
For CD booting via boot facilities other than PC-BIOS and EFI, and For CD booting via boot facilities other than PC-BIOS and EFI, and
for booting from USB sticks or hard disks, see the next section for booting from USB sticks or hard disks, see the next section
about the Sytem Area. about the System Area.
@* @*
@table @asis @table @asis
@sp 1 @sp 1
@ -1579,7 +1579,7 @@ Set the number of sectors per head for the MBR partition table.
0 chooses a default value. Maximum is 63. 0 chooses a default value. Maximum is 63.
@* @*
The product partition_sec_hd * partition_hd_cyl * 512 is the cylinder size. The product partition_sec_hd * partition_hd_cyl * 512 is the cylinder size.
It should be divisible by 2048 in order to allow exact alignment. It should be divisible by 2048 in order to make exact alignment possible.
With appended partitions and -appended_part_as_gpt there is no limit for With appended partitions and -appended_part_as_gpt there is no limit for
the number of cylinders. Else there may be at most 1024 of them. the number of cylinders. Else there may be at most 1024 of them.
If the cylinder size is too small to stay below the limit, If the cylinder size is too small to stay below the limit,