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

Fixed spelling errors found by fossies.org with codespell

Browse Source
This commit is contained in:
Thomas Schmitt 2019-10-28 15:34:56 +01:00
parent 5903885d45
commit c8b9c9a244
46 changed files with 375 additions and 375 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
frontend/frontend_pipes_xorriso.c
View File

@ -295,7 +295,7 @@ static int await_all_replies(struct boss_state *boss)
return(-1); return(-1);
} }
if (count == 0) { if (count == 0) {
fprintf(stderr, "+++ EOF encounterd by Master process\n"); fprintf(stderr, "+++ EOF encountered by Master process\n");
return(-2); return(-2);
} }
for (npt = buf + remainder; npt < buf + count; npt++) { for (npt = buf + remainder; npt < buf + count; npt++) {

2
frontend/sh_on_named_pipes.sh
View File

@ -43,7 +43,7 @@ export normal_end=0
# ---------------- An interpreter for quoted xorriso replies ---------------- # ---------------- An interpreter for quoted xorriso replies ----------------
# xorriso commands like -lsl wrap filenames into quotation marks in order # xorriso commands like -lsl wrap filenames into quotation marks in order
# to unambigously represent any character byte except the 0-byte. # to unambiguously represent any character byte except the 0-byte.
# This piece of code parses input strings into words by letting xorriso # This piece of code parses input strings into words by letting xorriso
# command -msg_op "parse_silently" do the hard work. # command -msg_op "parse_silently" do the hard work.
# The input strings should be composed by concatenating input lines with # The input strings should be composed by concatenating input lines with

16
frontend/xorriso-tcltk
View File

@ -108,7 +108,7 @@ set reply_pipe_adr ""
# The command to send (or the command most recently sent) # The command to send (or the command most recently sent)
set cmdline "" set cmdline ""
# Wether to clear the cmdline after sending # Whether to clear the cmdline after sending
set cmdline_clear true set cmdline_clear true
# Command counter # Command counter
set cmd_sent 0 set cmd_sent 0
@ -182,7 +182,7 @@ set pre_msglist ""
# Whether overwriting of files in the ISO model is allowed # Whether overwriting of files in the ISO model is allowed
set overwrite_iso_files 1 set overwrite_iso_files 1
# If overwrite_iso_files is 1: Wether overwriting of ISO directories is allowed # If overwrite_iso_files is 1: Whether overwriting of ISO directories is allowed
set overwrite_iso_dirs 0 set overwrite_iso_dirs 0
# Whether overwriting of files on disk is allowed # Whether overwriting of files on disk is allowed
@ -248,7 +248,7 @@ proc init_frontend_named_pipes {cmd_pipe reply_pipe} {
set cmd_conn [open $cmd_pipe w] set cmd_conn [open $cmd_pipe w]
set reply_conn [open $reply_pipe r] set reply_conn [open $reply_pipe r]
# Note: disencouraged flags would be necessary for opening idle fifo # Note: dissuaded flags would be necessary for opening idle fifo
# set reply_conn [open $reply_pipe {RDONLY NONBLOCK}] # set reply_conn [open $reply_pipe {RDONLY NONBLOCK}]
} }
@ -920,7 +920,7 @@ proc effectuate_permission_policy {} {
# and implement the quoting rules of xorriso input and output. # and implement the quoting rules of xorriso input and output.
# Lines which are supposed to consist of several words get sent to # Lines which are supposed to consist of several words get sent to
# xorriso command -msg_op. The result lines of this command encode # xorriso command -msg_op. The result lines of this command encode
# the words unambigously in one or more text lines. # the words unambiguously in one or more text lines.
# This is supposed to be safe for even the weirdest file names. # This is supposed to be safe for even the weirdest file names.
# Only NUL characters cannot be part of names. # Only NUL characters cannot be part of names.
@ -3519,7 +3519,7 @@ set isolist_lines 8
# Whether the message box shall export its selection to the whole X display # Whether the message box shall export its selection to the whole X display
set export_msg_selection true set export_msg_selection true
# Wether the item lists shall export their selection # Whether the item lists shall export their selection
set export_selection false set export_selection false
# The number of lines in the display of the help texts # The number of lines in the display of the help texts
@ -4333,7 +4333,7 @@ proc bind_help {to_what help_name} {
} }
# Create a "/" button and wire it with variable, fileystem type, and help text. # Create a "/" button and wire it with variable, filesystem type,and help text.
# #
proc create_browser_button {button_name var_name which_fs help_name} { proc create_browser_button {button_name var_name which_fs help_name} {
global have_bwidget global have_bwidget
@ -4609,7 +4609,7 @@ standard error. Else it must not yet exist or be a writable data file.
The \"Log pipes\" switch controls whether all xorriso commands and replies The \"Log pipes\" switch controls whether all xorriso commands and replies
shall be logged to standard error or to the file that has been given shall be logged to standard error or to the file that has been given
with program argument --pipe_log_file. with program argument --pipe_log_file.
Caution: This log is verbous. Caution: This log is verbose.
The item \"Set pipe log address\" pops up a file tree browser window The item \"Set pipe log address\" pops up a file tree browser window
which asks for the target of pipe logging . Address \"-\" means which asks for the target of pipe logging . Address \"-\" means
@ -5396,7 +5396,7 @@ proc make_text_shellsafe {text} {
} }
# Count the number of newline chracters in text. # Count the number of newline characters in text.
# #
proc count_newlines {text} { proc count_newlines {text} {
set rest $text set rest $text

30
libisoburn/burn_wrap.c
View File

@ -99,7 +99,7 @@ int isoburn_initialize(char msg[1024], int flag)
error: 'INTENTIONAL_ABORT_OF_COMPILATION__HEADERFILE_libisofs_dot_h_TOO_OLD__SEE_libisoburn_dot_h_AND_burn_wrap_dot_h' undeclared (first use in this function) error: 'INTENTIONAL_ABORT_OF_COMPILATION__HEADERFILE_libisofs_dot_h_TOO_OLD__SEE_libisoburn_dot_h_AND_burn_wrap_dot_h' undeclared (first use in this function)
error: 'LIBISOFS_MISCONFIGURATION_' undeclared (first use in this function) error: 'LIBISOFS_MISCONFIGURATION_' undeclared (first use in this function)
*/ */
/* The indendation is an advise of man gcc to help old compilers ignoring */ /* The indentation is an advise of man gcc to help old compilers ignoring */
#if isoburn_libisofs_req_major > iso_lib_header_version_major #if isoburn_libisofs_req_major > iso_lib_header_version_major
#define Isoburn_libisofs_dot_h_too_olD 1 #define Isoburn_libisofs_dot_h_too_olD 1
#endif #endif
@ -136,7 +136,7 @@ LIBISOFS_MISCONFIGURATION_ = 0;
error: 'LIBBURN_MISCONFIGURATION_' undeclared (first use in this function) error: 'LIBBURN_MISCONFIGURATION_' undeclared (first use in this function)
*/ */
/* The indendation is an advise of man gcc to help old compilers ignoring */ /* The indentation is an advise of man gcc to help old compilers ignoring */
#if isoburn_libburn_req_major > burn_header_version_major #if isoburn_libburn_req_major > burn_header_version_major
#define Isoburn_libburn_dot_h_too_olD 1 #define Isoburn_libburn_dot_h_too_olD 1
#endif #endif
@ -161,7 +161,7 @@ LIBBURN_MISCONFIGURATION_ = 0;
So the requirement is defined in libisofs/libisofs.h : So the requirement is defined in libisofs/libisofs.h :
iso_libjte_req_major , iso_libjte_req_minor , iso_libjte_req_micro iso_libjte_req_major , iso_libjte_req_minor , iso_libjte_req_micro
*/ */
/* The indendation is an advise of man gcc to help old compilers ignoring */ /* The indentation is an advise of man gcc to help old compilers ignoring */
#if iso_libjte_req_major > LIBJTE_VERSION_MAJOR #if iso_libjte_req_major > LIBJTE_VERSION_MAJOR
#define Libisofs_libjte_dot_h_too_olD 1 #define Libisofs_libjte_dot_h_too_olD 1
#endif #endif
@ -333,10 +333,10 @@ int isoburn_is_intermediate_dvd_rw(struct burn_drive *d, int flag)
/** Examines the medium and sets appropriate emulation if needed. /** Examines the medium and sets appropriate emulation if needed.
@param flag bit0= pretent blank on overwriteable media @param flag bit0= pretent blank on overwritable media
bit3= if the drive reports a -ROM profile then try to read bit3= if the drive reports a -ROM profile then try to read
table of content by scanning for ISO image headers. table of content by scanning for ISO image headers.
bit4= do not emulate TOC on overwriteable media bit4= do not emulate TOC on overwritable media
bit5= ignore ACL from external filesystems bit5= ignore ACL from external filesystems
bit6= ignore POSIX Extended Attributes from external filesystems bit6= ignore POSIX Extended Attributes from external filesystems
bit7= pretend -ROM and scan for table of content bit7= pretend -ROM and scan for table of content
@ -401,7 +401,7 @@ static int isoburn_welcome_media(struct isoburn **o, struct burn_drive *d,
random_access= caps->start_adr || role == 4; random_access= caps->start_adr || role == 4;
if(random_access) if(random_access)
(*o)->emulation_mode= 1; (*o)->emulation_mode= 1;
if(random_access && !readonly) { /* set emulation to overwriteable */ if(random_access && !readonly) { /* set emulation to overwritable */
ret= isoburn_is_intermediate_dvd_rw(d, 0); ret= isoburn_is_intermediate_dvd_rw(d, 0);
if(ret>0) { if(ret>0) {
(*o)->min_start_byte= 0; (*o)->min_start_byte= 0;
@ -437,14 +437,14 @@ static int isoburn_welcome_media(struct isoburn **o, struct burn_drive *d,
*/ */
(*o)->fabricated_disc_status= BURN_DISC_FULL; (*o)->fabricated_disc_status= BURN_DISC_FULL;
/* This might be an overwriteable medium in a -ROM drive. /* This might be an overwritable medium in a -ROM drive.
Pitfall: Pitfall:
Multi-session media which bear a xorriso image for overwriteables Multi-session media which bear a xorriso image for overwritables
in their first session would get a TOC of that first image rather in their first session would get a TOC of that first image rather
than of the medium. than of the medium.
It is not possible to distinguish a BD-RE from a single session It is not possible to distinguish a BD-RE from a single session
BD-R with an image for overwriteables. But as soon as the medium BD-R with an image for overwritables. But as soon as the medium
bears 2 logical tracks it cannot be overwriteable. bears 2 logical tracks it cannot be overwritable.
So count the number of tracks first. So count the number of tracks first.
*/ */
disc= isoburn_toc_drive_get_disc(d); disc= isoburn_toc_drive_get_disc(d);
@ -463,7 +463,7 @@ static int isoburn_welcome_media(struct isoburn **o, struct burn_drive *d,
isoburn_msgs_submit(*o, 0x00060000, msg, 0, "DEBUG", 0); isoburn_msgs_submit(*o, 0x00060000, msg, 0, "DEBUG", 0);
if((flag & 16) || track_count >= 2) { if((flag & 16) || track_count >= 2) {
ret= 0; /* toc emulation off, or not overwriteable */ ret= 0; /* toc emulation off, or not overwritable */
} else { } else {
ret= isoburn_start_emulation(*o, 1); ret= isoburn_start_emulation(*o, 1);
if(ret<=0) { if(ret<=0) {
@ -524,14 +524,14 @@ ex:
/** /**
@param flag bit0= load @param flag bit0= load
bit1= regard overwriteable media as blank bit1= regard overwritable media as blank
bit2= if the drive is a regular disk file: truncate it to bit2= if the drive is a regular disk file: truncate it to
the write start address the write start address
bit3= if the drive reports a -ROM profile then try to read bit3= if the drive reports a -ROM profile then try to read
table of content by scanning for ISO image headers. table of content by scanning for ISO image headers.
(depending on media type and drive state this might (depending on media type and drive state this might
help or it might make the resulting toc even worse) help or it might make the resulting toc even worse)
bit4= do not emulate TOC on overwriteable media bit4= do not emulate TOC on overwritable media
bit5= ignore ACL from external filesystems bit5= ignore ACL from external filesystems
bit6= ignore POSIX Extended Attributes from external filesystems bit6= ignore POSIX Extended Attributes from external filesystems
bit7= pretend -ROM profile and scan for table of content bit7= pretend -ROM profile and scan for table of content
@ -1473,8 +1473,8 @@ int isoburn_emulate_toc(struct burn_drive *d, int flag)
read_flag|= (1<<15)|((session_count>0)<<14); read_flag|= (1<<15)|((session_count>0)<<14);
else { else {
/* growisofs aligns to 16 rather than 32. Overwriteable TOC emulation /* growisofs aligns to 16 rather than 32. Overwritable TOC emulation
relies on not accidentially seeing inter-session trash data. relies on not accidentally seeing inter-session trash data.
But one can safely access 16 blocks earlier because a xorriso header But one can safely access 16 blocks earlier because a xorriso header
would have been overwritten with the unused 16 blocks at its start. would have been overwritten with the unused 16 blocks at its start.
If libisoburn alignment would increase, then this would not be If libisoburn alignment would increase, then this would not be

2
libisoburn/isoburn.c
View File

@ -689,7 +689,7 @@ int isoburn_prepare_disc_aux(struct burn_drive *in_d, struct burn_drive *out_d,
if(ret > 0 && data_start <= 0x7FFFFFFF) if(ret > 0 && data_start <= 0x7FFFFFFF)
opts->data_start_lba= data_start; opts->data_start_lba= data_start;
/* TODO check return values for failure. propertly clean-up on error */ /* TODO check return values for failure. properly clean-up on error */
out_o->iso_source= wsrc; out_o->iso_source= wsrc;

18
libisoburn/isoburn.h
View File

@ -21,7 +21,7 @@
#endif #endif
#endif #endif
/* For emulated TOC of overwriteable media. /* For emulated TOC of overwritable media.
Provides minimal info for faking a struct burn_toc_entry. Provides minimal info for faking a struct burn_toc_entry.
*/ */
struct isoburn_toc_entry { struct isoburn_toc_entry {
@ -29,7 +29,7 @@ struct isoburn_toc_entry {
int track_no; /* point */ int track_no; /* point */
int start_lba; int start_lba;
int track_blocks; int track_blocks;
char *volid; /* For caching a volume id from emulated toc on overwriteables */ char *volid; /* For caching a volume id from emulated toc on overwritables */
struct isoburn_toc_entry *next; struct isoburn_toc_entry *next;
}; };
@ -92,7 +92,7 @@ struct isoburn {
int fabricated_msc2; int fabricated_msc2;
/* The nwa to be used for a first session on the present kind of overwriteable /* The nwa to be used for a first session on the present kind of overwritable
media (usually Libisoburn_overwriteable_starT, but might be forced to 0) media (usually Libisoburn_overwriteable_starT, but might be forced to 0)
*/ */
int zero_nwa; int zero_nwa;
@ -118,11 +118,11 @@ struct isoburn {
int media_read_error; int media_read_error;
/* Eventual emulated table of content read from the chain of ISO headers /* Eventual emulated table of content read from the chain of ISO headers
on overwriteable media. on overwritable media.
*/ */
struct isoburn_toc_entry *toc; struct isoburn_toc_entry *toc;
/* Indicator wether the most recent burn run worked : /* Indicator whether the most recent burn run worked :
-1 = undetermined, ask libburn , 0 = failure , 1 = success -1 = undetermined, ask libburn , 0 = failure , 1 = success
To be inquired by isoburn_drive_wrote_well() To be inquired by isoburn_drive_wrote_well()
*/ */
@ -427,7 +427,7 @@ struct isoburn_imgen_opts {
*/ */
unsigned int file_md5 :2; unsigned int file_md5 :2;
/* On overwriteable media or random access files do not write the first /* On overwritable media or random access files do not write the first
session to LBA 32, but rather to LBA 0 directly. session to LBA 32, but rather to LBA 0 directly.
*/ */
unsigned int no_emul_toc :1; unsigned int no_emul_toc :1;
@ -693,7 +693,7 @@ struct isoburn_imgen_opts {
int efi_boot_part_flag; int efi_boot_part_flag;
/* Disk file paths of prepared images which shall be appended /* Disk file paths of prepared images which shall be appended
after the ISO image and described by partiton table entries in a MBR. after the ISO image and described by partition table entries in a MBR.
NULL means unused. NULL means unused.
*/ */
char *appended_partitions[Libisoburn_max_appended_partitionS]; char *appended_partitions[Libisoburn_max_appended_partitionS];
@ -764,7 +764,7 @@ struct isoburn_imgen_opts {
}; };
/* Alignment for session starts on overwriteable media. /* Alignment for session starts on overwritable media.
(Increased from 16 to 32 blocks for aligning to BD-RE clusters.) (Increased from 16 to 32 blocks for aligning to BD-RE clusters.)
*/ */
#define Libisoburn_nwa_alignemenT 32 #define Libisoburn_nwa_alignemenT 32
@ -804,7 +804,7 @@ struct isoburn_imgen_opts {
((off_t) (Libisoburn_target_head_sizE/2048)) ((off_t) (Libisoburn_target_head_sizE/2048))
/* Wrappers for emulation of TOC on overwriteable media */ /* Wrappers for emulation of TOC on overwritable media */
struct isoburn_toc_track { struct isoburn_toc_track {
/* Either track or toc_entry are supposed to be NULL */ /* Either track or toc_entry are supposed to be NULL */

40
libisoburn/libisoburn.h
View File

@ -93,13 +93,13 @@ the setup for several alternative image generation strategies.
Growing: Growing:
If input and output drive are the same, then isoburn_prepare_disc() is to If input and output drive are the same, then isoburn_prepare_disc() is to
be used. It will lead to an add-on session on appendable or overwriteable be used. It will lead to an add-on session on appendable or overwritable
media with existing ISO image. With blank media it will produce a first media with existing ISO image. With blank media it will produce a first
session. session.
Modifying: Modifying:
If the output drive is not the input drive, and if it bears blank media If the output drive is not the input drive, and if it bears blank media
or overwriteable without a valid ISO image, then one may produce a consolidated or overwritable without a valid ISO image, then one may produce a consolidated
image with old and new data. This will copy file data from an eventual input image with old and new data. This will copy file data from an eventual input
drive with valid image, add any newly introduced data from the local drive with valid image, add any newly introduced data from the local
filesystem, and produce a first session on output media. filesystem, and produce a first session on output media.
@ -206,7 +206,7 @@ int isoburn_initialize(char msg[1024], int flag);
@param flag Bitfield for control purposes. Unused yet. Submit 0. @param flag Bitfield for control purposes. Unused yet. Submit 0.
@return 1= library can work for caller @return 1= library can work for caller
0= library is not usable in some aspects. Caller must restrict 0= library is not usable in some aspects. Caller must restrict
itself to an earlier API version or must not use this libray itself to an earlier API version or must not use this library
at all. at all.
*/ */
int isoburn_is_compatible(int major, int minor, int micro, int flag); int isoburn_is_compatible(int major, int minor, int micro, int flag);
@ -322,7 +322,7 @@ int isoburn_libburn_req(int *major, int *minor, int *micro);
/** Usage discussion: /** Usage discussion:
Some developers of the libburnia project have differing Some developers of the libburnia project have differing
opinions how to ensure the compatibility of libaries opinions how to ensure the compatibility of libraries
and applications. and applications.
It is about whether to use at compile time and at runtime It is about whether to use at compile time and at runtime
@ -429,7 +429,7 @@ int isoburn_drive_scan_and_grab(struct burn_drive_info *drive_infos[],
to a file object. to a file object.
@param flag bit0= attempt to load the disc tray. @param flag bit0= attempt to load the disc tray.
Else: failure if not loaded. Else: failure if not loaded.
bit1= regard overwriteable media as blank bit1= regard overwritable media as blank
bit2= if the drive is a regular disk file: bit2= if the drive is a regular disk file:
truncate it to the write start address when writing truncate it to the write start address when writing
begins begins
@ -437,7 +437,7 @@ int isoburn_drive_scan_and_grab(struct burn_drive_info *drive_infos[],
table of content by scanning for ISO image headers. table of content by scanning for ISO image headers.
(depending on media type and drive this might (depending on media type and drive this might
help or it might make the resulting toc even worse) help or it might make the resulting toc even worse)
bit4= do not emulate table of content on overwriteable media bit4= do not emulate table of content on overwritable media
bit5= ignore ACL from external filesystems bit5= ignore ACL from external filesystems
bit6= ignore POSIX Extended Attributes from external bit6= ignore POSIX Extended Attributes from external
filesystems (xattr) filesystems (xattr)
@ -568,9 +568,9 @@ int isoburn_set_msc1(struct burn_drive *d, int adr_mode, char *adr_value,
/* ----------------------------------------------------------------------- */ /* ----------------------------------------------------------------------- */
/* /*
Wrappers for emulation of TOC on overwriteable media Wrappers for emulation of TOC on overwritable media
Media which match the overwriteable usage model lack of a history of sessions Media which match the overwritable usage model lack of a history of sessions
and tracks. libburn will not even hand out a burn_disc object for them and and tracks. libburn will not even hand out a burn_disc object for them and
always declare them blank. libisoburn checks for a valid ISO filesystem always declare them blank. libisoburn checks for a valid ISO filesystem
header at LBA 0 and eventually declares them appendable. header at LBA 0 and eventually declares them appendable.
@ -579,7 +579,7 @@ int isoburn_set_msc1(struct burn_drive *d, int adr_mode, char *adr_value,
and their LBAs, as it is possible with true multi-session media. and their LBAs, as it is possible with true multi-session media.
The following wrappers add the capability to obtain a session and track TOC The following wrappers add the capability to obtain a session and track TOC
from emulated multi-session images on overwriteables if the first session from emulated multi-session images on overwritables if the first session
was written by libisoburn-0.1.6 or later (i.e. with a header copy at LBA 32). was written by libisoburn-0.1.6 or later (i.e. with a header copy at LBA 32).
Be aware that the structs emitted by these isoburn calls are not compatible Be aware that the structs emitted by these isoburn calls are not compatible
@ -950,7 +950,7 @@ int isoburn_ropt_get_default_perms(struct isoburn_read_opts *o,
gets loaded. gets loaded.
Above call isoburn_ropt_set_default_perms() automatically adds Above call isoburn_ropt_set_default_perms() automatically adds
x-permissions to r-permissions for directories. This call here may x-permissions to r-permissions for directories. This call here may
be done afterwards to set independend permissions for directories, be done afterwards to set independent permissions for directories,
especially to override the automatically added x-permissions. especially to override the automatically added x-permissions.
@since 0.1.0 @since 0.1.0
@param o The option set to work on @param o The option set to work on
@ -1005,9 +1005,9 @@ int isoburn_ropt_get_auto_incharset(struct isoburn_read_opts *o, int *mode);
@since 0.6.6 @since 0.6.6
@param o The option set to work on @param o The option set to work on
@param displacement 0 or a positive number @param displacement 0 or a positive number
@param displacement_sign Determines wether to add or subtract displacement @param displacement_sign Determines whether to add or subtract
to block addresses before applying them to the displacement to block addresses before applying
storage object for reading: them to the storage object for reading:
+1 = add , -1= subtract , else keep unaltered +1 = add , -1= subtract , else keep unaltered
*/ */
int isoburn_ropt_set_displacement(struct isoburn_read_opts *o, int isoburn_ropt_set_displacement(struct isoburn_read_opts *o,
@ -1048,7 +1048,7 @@ int isoburn_ropt_get_truncate_mode(struct isoburn_read_opts *o,
int *mode, int *length); int *mode, int *length);
/** After calling function isoburn_read_image() there are informations /** After calling function isoburn_read_image() there are information
available in the option set. available in the option set.
This info can be obtained as bits in parameter has_what. Like: This info can be obtained as bits in parameter has_what. Like:
joliet_available = (has_what & isoburn_ropt_has_joliet); joliet_available = (has_what & isoburn_ropt_has_joliet);
@ -1172,7 +1172,7 @@ int isoburn_igopt_get_level(struct isoburn_imgen_opts *o, int *level);
See also libisofs.h iso_write_opts_set_record_md5() See also libisofs.h iso_write_opts_set_record_md5()
bit9= no_emul_toc bit9= no_emul_toc
@since 0.5.8 @since 0.5.8
On overwriteable media or random access files do not write On overwritable media or random access files do not write
the first session to LBA 32 and do not copy the first 64kB the first session to LBA 32 and do not copy the first 64kB
of the first session to LBA 0, but rather write the first of the first session to LBA 0, but rather write the first
session to LBA 0 directly. session to LBA 0 directly.
@ -1472,7 +1472,7 @@ int isoburn_igopt_get_over_ugid(struct isoburn_imgen_opts *o,
int *replace_uid, int *replace_gid, int *replace_uid, int *replace_gid,
uid_t *uid, gid_t *gid); uid_t *uid, gid_t *gid);
/** Set the charcter set to use for representing RR filenames in the image. /** Set the character set to use for representing RR filenames in the image.
@since 0.1.0 @since 0.1.0
@param o The option set to work on @param o The option set to work on
@param output_charset Set this to NULL to use the default output charset. @param output_charset Set this to NULL to use the default output charset.
@ -1963,7 +1963,7 @@ int isoburn_igopt_set_part_type_guid(struct isoburn_imgen_opts *opts,
16 flag bits of the images of the corresponding partition. 16 flag bits of the images of the corresponding partition.
@param valids @param valids
The array elements 0 to num_entries - 1 will get filled by 1 or 0 The array elements 0 to num_entries - 1 will get filled by 1 or 0
to indicate whether the corresponding type_guids elemet is valid. to indicate whether the corresponding type_guids element is valid.
@return @return
<0 = error <0 = error
0 = no partition image set 0 = no partition image set
@ -2482,7 +2482,7 @@ int isoburn_disc_track_lba_nwa(struct burn_drive *d, struct burn_write_opts *o,
/** Obtain the size which was attributed to an emulated appendable on actually /** Obtain the size which was attributed to an emulated appendable on actually
overwriteable media. This value is supposed to be <= 2048 * nwa as of overwritable media. This value is supposed to be <= 2048 * nwa as of
isoburn_disc_track_lba_nwa(). isoburn_disc_track_lba_nwa().
@since 0.1.0 @since 0.1.0
@param d The drive holding the medium. @param d The drive holding the medium.
@ -2628,7 +2628,7 @@ int isoburn_set_truncate(struct burn_drive *drive, int flag);
/** Start writing of the new session. /** Start writing of the new session.
This call is asynchrounous. I.e. it returns quite soon and the progress has This call is asynchronous. I.e. it returns quite soon and the progress has
to be watched by a loop with call burn_drive_get_status() until to be watched by a loop with call burn_drive_get_status() until
BURN_DRIVE_IDLE is returned. BURN_DRIVE_IDLE is returned.
Wrapper for: burn_disc_write() Wrapper for: burn_disc_write()
@ -2727,7 +2727,7 @@ void isoburn_finish(void);
*/ */
/** Inquire wether the medium needs emulation or would be suitable for /** Inquire whether the medium needs emulation or would be suitable for
generic multi-session via libburn. generic multi-session via libburn.
@since 0.1.0 @since 0.1.0
@param d The drive to inquire @param d The drive to inquire

4
releng/README
View File

@ -33,7 +33,7 @@ can be configured and built. It is not mandatory that libisoburn is already
installed. The tests may use an installed xorriso program as well as a installed. The tests may use an installed xorriso program as well as a
freshly built one. freshly built one.
The test scripts explicitely demand /bin/bash as interpreter, although they The test scripts explicitly demand /bin/bash as interpreter, although they
would run on certain other shells too. If you get an error message like would run on certain other shells too. If you get an error message like
./run_all_auto: not found ./run_all_auto: not found
then consider to install /bin/bash. then consider to install /bin/bash.
@ -188,7 +188,7 @@ Known to be suitable are the following shells
Solaris: /bin/bash , /bin/i86/ksh93 Solaris: /bin/bash , /bin/i86/ksh93
In general, the shell should have Bourne shell ancestry. In general, the shell should have Bourne shell ancestry.
The script does not choose an interpreter explicitely and is safe to be run The script does not choose an interpreter explicitly and is safe to be run
inline: inline:
. ./change_shell_to_use . ./change_shell_to_use
One may set any interpreter path by running a sub shell and changing its One may set any interpreter path by running a sub shell and changing its

2
releng/jigdo-gen-md5-list
View File

@ -5,7 +5,7 @@
# This script is distributed according to the terms of the GNU GPL v2. # This script is distributed according to the terms of the GNU GPL v2.
# This should be better rewritten in C at some future point. Ref: pwd code. # This should be better rewritten in C at some future point. Ref: pwd code.
# Create a list of MD5sums encoded in hexidecimal format and print to standard output # Create a list of MD5sums encoded in hexadecimal format and print to standard output
# Format Description # Format Description
# A line in the emerging file is to be composed as follows: # A line in the emerging file is to be composed as follows:

2
releng/jigdo-gen-md5-list.1
View File

@ -1,7 +1,7 @@
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.38.2. .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.38.2.
.TH JIGDO-GEN-MD5-LIST "1" "October 2010" "jigdo-gen-md5-list 0.1" "User Commands" .TH JIGDO-GEN-MD5-LIST "1" "October 2010" "jigdo-gen-md5-list 0.1" "User Commands"
.SH NAME .SH NAME
jigdo-gen-md5-list \- create a list of MD5sums encoded in hexidecimal format and print to standard output jigdo-gen-md5-list \- create a list of MD5sums encoded in hexadecimal format and print to standard output
.SH DESCRIPTION .SH DESCRIPTION
usage: jigdo\-gen\-md5\-list [option] DIR FILE ... usage: jigdo\-gen\-md5\-list [option] DIR FILE ...
.TP .TP

6
xorriso/README_gnu_xorriso
View File

@ -99,7 +99,7 @@ Both conditional dependencies can be avoided by running
./configure --prefix=/usr --disable-libreadline ./configure --prefix=/usr --disable-libreadline
make clean ; make make clean ; make
Never omit the "make clean" command after switching enabling of libreadline. Never omit the "make clean" command after switching enabling of libreadline.
If you want to explictely allow only the use of libedit, then do If you want to explicitly allow only the use of libedit, then do
./configure --prefix=/usr --disable-libreadline --enable-libedit ./configure --prefix=/usr --disable-libreadline --enable-libedit
Other deliberate dependency reduction options of ./configure are: Other deliberate dependency reduction options of ./configure are:
@ -342,7 +342,7 @@ Tag_id distinguishes the following tag types
"libisofs_checksum_tag_v1" Session end tag "libisofs_checksum_tag_v1" Session end tag
A relocated superblock may appear at LBA 0 of an image which was produced for A relocated superblock may appear at LBA 0 of an image which was produced for
being stored in a disk file or on overwriteable media (e.g. DVD+RW, BD-RE). being stored in a disk file or on overwritable media (e.g. DVD+RW, BD-RE).
xorriso records the first session at LBA 32. A follow-up session xorriso records the first session at LBA 32. A follow-up session
begins at the next block address which is divisible by 32 and higher than the begins at the next block address which is divisible by 32 and higher than the
address of the previous session's end tag. Normally no session starts after the address of the previous session's end tag. Normally no session starts after the
@ -366,7 +366,7 @@ are accessed via libisoburn, which is closely related to xorriso.
libisoburn provides several services: libisoburn provides several services:
- Encapsulation of coordination between libisofs and libburn. - Encapsulation of coordination between libisofs and libburn.
- Emulation of ISO 9660 multi-session on overwriteable media - Emulation of ISO 9660 multi-session on overwritable media
or random access files. or random access files.
- Implementation of the xorriso API. - Implementation of the xorriso API.

2
xorriso/aux_objects.h
View File

@ -116,7 +116,7 @@ int Xorriso_lst_append_binary(struct Xorriso_lsT **entry,
/** Destroy a single list item and connect its eventual list neighbors. /** Destroy a single list item and connect its eventual list neighbors.
@param lstring pointer to the pointer to be freed and set to NULL @param lstring pointer to the pointer to be freed and set to NULL
@param flag unused yet, submit 0 @param flag unused yet, submit 0
@return 0= *lstring was alredy NULL, 1= ok @return 0= *lstring was already NULL, 1= ok
*/ */
int Xorriso_lst_destroy(struct Xorriso_lsT **lstring, int flag); int Xorriso_lst_destroy(struct Xorriso_lsT **lstring, int flag);

2
xorriso/cmp_update.c
View File

@ -337,7 +337,7 @@ int Xorriso_compare_2_files(struct XorrisO *xorriso, char *disk_adr,
if(ret>0) { if(ret>0) {
strcpy(respt, "? "); strcpy(respt, "? ");
Text_shellsafe(disk_adr, respt, 1); Text_shellsafe(disk_adr, respt, 1);
sprintf(respt + strlen(respt), " (DISK) : exluded by %s\n", sprintf(respt + strlen(respt), " (DISK) : excluded by %s\n",
(ret==1 ? "-not_paths" : "-not_leaf")); (ret==1 ? "-not_paths" : "-not_leaf"));
if(! (flag & ((1u << 31) | (1 << 26)))) if(! (flag & ((1u << 31) | (1 << 26))))
Xorriso_result(xorriso,0); Xorriso_result(xorriso,0);

12
xorriso/drive_mgt.c
View File

@ -204,14 +204,14 @@ ex:;
} }
/* @param flag bit0= aquire as isoburn input drive /* @param flag bit0= acquire as isoburn input drive
bit1= aquire as libburn output drive (as isoburn drive if bit0) bit1= acquire as libburn output drive (as isoburn drive if bit0)
bit2= regard overwriteable media as blank bit2= regard overwritable media as blank
bit3= if the drive is a regular disk file: truncate it to bit3= if the drive is a regular disk file: truncate it to
the write start address the write start address
bit5= do not print toc bit5= do not print toc
bit6= do not calm down drive after aquiring it bit6= do not calm down drive after acquiring it
bit7= re-assess rather than aquire: bit7= re-assess rather than acquire:
Do not give up drives, Do not give up drives,
use isoburn_drive_aquire() with re-assessment bit use isoburn_drive_aquire() with re-assessment bit
@return <=0 failure , 1= ok @return <=0 failure , 1= ok
@ -3260,7 +3260,7 @@ int Xorriso_check_media(struct XorrisO *xorriso, struct SpotlisT **spotlist,
ret= burn_disc_get_multi_caps(drive, BURN_WRITE_NONE, &caps, 0); ret= burn_disc_get_multi_caps(drive, BURN_WRITE_NONE, &caps, 0);
if(ret > 0) { if(ret > 0) {
if(caps->start_adr) { if(caps->start_adr) {
/* block 0 to 31 are the overall mount entry of overwriteable */ /* block 0 to 31 are the overall mount entry of overwritable */
track_lba= 0; track_lba= 0;
track_blocks+= 32; track_blocks+= 32;
} }

6
xorriso/emulators.c
View File

@ -93,7 +93,7 @@ int Xorriso_cdrskin_help(struct XorrisO *xorriso, int flag)
"\t-help\t\tprint this text to stderr and exit emulation", "\t-help\t\tprint this text to stderr and exit emulation",
"Actually this is the integrated ISO RockRidge filesystem manipulator xorriso", "Actually this is the integrated ISO RockRidge filesystem manipulator xorriso",
"lending its libburn capabilities to a very limited cdrecord emulation. Only", "lending its libburn capabilities to a very limited cdrecord emulation. Only",
"a single data track can be burnt to blank, appendable or overwriteable media.", "a single data track can be burnt to blank, appendable or overwritable media.",
"A much more elaborate cdrecord emulator is cdrskin from the same project.", "A much more elaborate cdrecord emulator is cdrskin from the same project.",
"@End_of_helptexT@" "@End_of_helptexT@"
}; };
@ -494,7 +494,7 @@ no_volunteer:;
if(dev_adr[0]) { if(dev_adr[0]) {
hflag= 2 | 64; /* ts B11201 no more: | 32 */ hflag= 2 | 64; /* ts B11201 no more: | 32 */
if(!do_grow) if(!do_grow)
hflag|= 8; /* consider overwriteables as blank */ hflag|= 8; /* consider overwritables as blank */
ret= Xorriso_option_dev(xorriso, dev_adr, hflag); ret= Xorriso_option_dev(xorriso, dev_adr, hflag);
if(ret<=0) if(ret<=0)
goto ex; goto ex;
@ -1650,7 +1650,7 @@ problem_handler_1:;
ret= 0; goto ex; ret= 0; goto ex;
} }
} }
/* Regard overwriteable as blank, truncate regular files on write start */ /* Regard overwritable as blank, truncate regular files on write start */
ret= Xorriso_option_dev(xorriso, adr, 2|8|16); ret= Xorriso_option_dev(xorriso, adr, 2|8|16);
if(ret<=0) if(ret<=0)
goto ex; goto ex;

2
xorriso/findjob.c
View File

@ -753,7 +753,7 @@ int Findjob_endif(struct FindjoB *job, int flag)
} }
if(job->cursor->up==NULL) if(job->cursor->up==NULL)
goto improper_range; goto improper_range;
/* test wether parent node is -if */ /* test whether parent node is -if */
job->cursor= job->cursor->up; job->cursor= job->cursor->up;
Exprnode_get_branch(job->cursor, &true_branch, 0); Exprnode_get_branch(job->cursor, &true_branch, 0);
if(!Exprnode_is_if(job->cursor,0) || true_branch == NULL) { if(!Exprnode_is_if(job->cursor,0) || true_branch == NULL) {

4
xorriso/iso_img.c
View File

@ -1099,7 +1099,7 @@ int Xorriso_mount(struct XorrisO *xorriso, char *dev, int adr_mode,
ret= 0; goto ex; ret= 0; goto ex;
} }
/* Aquire drive as direct libburn address or via stdio: prefix */ /* Acquire drive as direct libburn address or via stdio: prefix */
if(strncmp(dev, "mmc:", 4) == 0) if(strncmp(dev, "mmc:", 4) == 0)
ret= burn_drive_convert_fs_adr(dev + 4, libburn_adr); ret= burn_drive_convert_fs_adr(dev + 4, libburn_adr);
else else
@ -2557,7 +2557,7 @@ static int Xorriso_scan_report_lines(struct XorrisO *xorriso,
} }
if(et_imgs[idx].path[0] == 0) { if(et_imgs[idx].path[0] == 0) {
/* >>> need way to eploit El Torito img blks : */; /* >>> need way to exploit El Torito img blks : */;
/* Check whether appended partition */; /* Check whether appended partition */;
for(i= 0; i < mbr_count; i++) for(i= 0; i < mbr_count; i++)

4
xorriso/iso_manip.c
View File

@ -285,7 +285,7 @@ ex:;
/* /*
@param boss_iter Opaque handle to be forwarded to actions in ISO image @param boss_iter Opaque handle to be forwarded to actions in ISO image
Set to NULL if calling this function without having Set to NULL if calling this function without having
a boss iterator objetc. a boss iterator object.
@param node Pointer to pointer to existing node, @param node Pointer to pointer to existing node,
*node is set to NULL, if the node gets removed. *node is set to NULL, if the node gets removed.
@param flag bit0= source is directory @param flag bit0= source is directory
@ -1694,7 +1694,7 @@ int Xorriso_rename(struct XorrisO *xorriso, void *boss_iter,
{ret= 0; goto ex;} {ret= 0; goto ex;}
} }
/* Check whether destination exists and may be not overwriteable */ /* Check whether destination exists and may be not overwritable */
ret= Xorriso_overwrite_dest(xorriso, boss_iter, ret= Xorriso_overwrite_dest(xorriso, boss_iter,
eff_dest, dest_ret, "Renaming", 0); eff_dest, dest_ret, "Renaming", 0);
if(ret <= 0) if(ret <= 0)

4
xorriso/iso_tree.c
View File

@ -303,7 +303,7 @@ int Xorriso_fake_stbuf(struct XorrisO *xorriso, char *path, struct stat *stbuf,
/* >>> With directories this should be : number of subdirs + 2 */ /* >>> With directories this should be : number of subdirs + 2 */
/* >>> ??? How to obtain RR hardlink number for other types ? */ /* >>> ??? How to obtain RR hardlink number for other types ? */
/* This may get overriden farther down */ /* This may get overridden farther down */
stbuf->st_nlink= 1; stbuf->st_nlink= 1;
stbuf->st_uid= iso_node_get_uid(*node); stbuf->st_uid= iso_node_get_uid(*node);
@ -2078,7 +2078,7 @@ ex:;
/* @param flag bit0= a match count !=1 is a FAILURE event /* @param flag bit0= a match count !=1 is a FAILURE event
bit1= with bit0 tolerate 0 matches if pattern is a constant bit1= with bit0 tolerate 0 matches if pattern is a constant
bit2= do not issue debug messages about temporay memory needs bit2= do not issue debug messages about temporary memory needs
bit3= do not add unresolved pattern to filev bit3= do not add unresolved pattern to filev
*/ */
int Xorriso_expand_pattern(struct XorrisO *xorriso, int Xorriso_expand_pattern(struct XorrisO *xorriso,

2
xorriso/lib_mgt.c
View File

@ -145,7 +145,7 @@ int Xorriso_startup_libraries(struct XorrisO *xorriso, int flag)
error: 'INTENTIONAL_ABORT_OF_COMPILATION__HEADERFILE_libisoburn_dot_h_TOO_OLD__SEE_xorrisoburn_dot_c' undeclared (first use in this function) error: 'INTENTIONAL_ABORT_OF_COMPILATION__HEADERFILE_libisoburn_dot_h_TOO_OLD__SEE_xorrisoburn_dot_c' undeclared (first use in this function)
error: 'LIBISOBURN_MISCONFIGURATION_' undeclared (first use in this function) error: 'LIBISOBURN_MISCONFIGURATION_' undeclared (first use in this function)
*/ */
/* The indendation is an advise of man gcc to help old compilers ignoring */ /* The indentation is an advise of man gcc to help old compilers ignoring */
#if xorriso_libisoburn_req_major > isoburn_header_version_major #if xorriso_libisoburn_req_major > isoburn_header_version_major
#define Isoburn_libisoburn_dot_h_too_olD 1 #define Isoburn_libisoburn_dot_h_too_olD 1
#endif #endif

2
xorriso/lib_mgt.h
View File

@ -22,7 +22,7 @@
/* The library which does MMC optical drive operations */ /* The library which does MMC optical drive operations */
#include <libburn/libburn.h> #include <libburn/libburn.h>
/* The library which enhances overwriteable media with ISO 9660 multi-session /* The library which enhances overwritable media with ISO 9660 multi-session
capabilities via the method invented by Andy Polyakov for growisofs */ capabilities via the method invented by Andy Polyakov for growisofs */
#include <libisoburn/libisoburn.h> #include <libisoburn/libisoburn.h>

2
xorriso/misc_funct.c
View File

@ -176,7 +176,7 @@ ex:;
(Also accepts capital letters.) (Also accepts capital letters.)
@param text Input like "42", "2k", "3.14m" or "-1g" @param text Input like "42", "2k", "3.14m" or "-1g"
@param flag Bitfield for control purposes: @param flag Bitfield for control purposes:
bit0= return -1 rathern than 0 on failure bit0= return -1 rather than 0 on failure
@return The derived double value @return The derived double value
*/ */
double Scanf_io_size(char *text, int flag) double Scanf_io_size(char *text, int flag)

2
xorriso/misc_funct.h
View File

@ -42,7 +42,7 @@ int System_uname(char **sysname, char **release, char **version,
[kmgtpe] (2^10 to 2^60) or [s] (2048). (Also accepts capital letters.) [kmgtpe] (2^10 to 2^60) or [s] (2048). (Also accepts capital letters.)
@param text Input like "42", "2k", "3.14m" or "-1g" @param text Input like "42", "2k", "3.14m" or "-1g"
@param flag Bitfield for control purposes: @param flag Bitfield for control purposes:
bit0= return -1 rathern than 0 on failure bit0= return -1 rather than 0 on failure
@return The derived double value @return The derived double value
*/ */
double Scanf_io_size(char *text, int flag); double Scanf_io_size(char *text, int flag);

10
xorriso/opts_d_h.c
View File

@ -62,11 +62,11 @@ int Xorriso_option_data_cache_size(struct XorrisO *xorriso, char *num_tiles,
/** @param flag bit0= use as indev /** @param flag bit0= use as indev
bit1= use as outdev bit1= use as outdev
bit2= do not -reassure bit2= do not -reassure
bit3= regard overwriteable media as blank bit3= regard overwritable 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 acquired 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 acquiring it
@return <=0 error , 1 success, 2 revoked by -reassure @return <=0 error , 1 success, 2 revoked by -reassure
*/ */
int Xorriso_option_dev(struct XorrisO *xorriso, char *in_adr, int flag) int Xorriso_option_dev(struct XorrisO *xorriso, char *in_adr, int flag)
@ -1796,7 +1796,7 @@ int Xorriso_option_help(struct XorrisO *xorriso, int flag)
" -rom_toc_scan \"on\"|\"force\"|\"off\"[:\"emul_on\"|\"emul_off\"]", " -rom_toc_scan \"on\"|\"force\"|\"off\"[:\"emul_on\"|\"emul_off\"]",
" [:\"emul_wide\"|\"emul_narrow\"]", " [:\"emul_wide\"|\"emul_narrow\"]",
" Enable scanning for ISO sessions on read-only drives/media", " Enable scanning for ISO sessions on read-only drives/media",
" and on overwriteable media with emulated TOC.", " and on overwritable media with emulated TOC.",
" -calm_drive \"in\"|\"out\"|\"all\"|\"on\"|\"off\"", " -calm_drive \"in\"|\"out\"|\"all\"|\"on\"|\"off\"",
" Reduce drive noise until it gets actually used again.", " Reduce drive noise until it gets actually used again.",
" -assert_volid pattern severity", " -assert_volid pattern severity",
@ -1989,7 +1989,7 @@ int Xorriso_option_help(struct XorrisO *xorriso, int flag)
"", "",
" -list_delimiter text Set the list delimiter to be used instead of \"--\"", " -list_delimiter text Set the list delimiter to be used instead of \"--\"",
" It has to be a single word, must not be empty, not longer", " It has to be a single word, must not be empty, not longer",
" than 80 characters, may mot contain quotation marks.", " than 80 characters, may not contain quotation marks.",
"", "",
"Manipulation commands:", "Manipulation commands:",
"disk_path is a path to an object in the local filesystem tree.", "disk_path is a path to an object in the local filesystem tree.",
@ -2362,7 +2362,7 @@ int Xorriso_option_help(struct XorrisO *xorriso, int flag)
" -as cdrecord [-help|-v|dev=|speed=|blank=|fs=|-eject|-atip|padsize=|-multi]", " -as cdrecord [-help|-v|dev=|speed=|blank=|fs=|-eject|-atip|padsize=|-multi]",
" path|-", " path|-",
" Perform some cdrecord gestures, eventually write at most one", " Perform some cdrecord gestures, eventually write at most one",
" data track to blank, appendable or overwriteable media.", " data track to blank, appendable or overwritable media.",
" -pacifier \"xorriso\"|\"cdrecord\"|\"mkisofs\"", " -pacifier \"xorriso\"|\"cdrecord\"|\"mkisofs\"",
" Choose format of UPDATE pacifier during write operations.", " Choose format of UPDATE pacifier during write operations.",
"", "",

10
xorriso/opts_p_z.c
View File

@ -1533,18 +1533,18 @@ int Xorriso_option_status_history_max(struct XorrisO *xorriso, int num,
/* Option -stdio_sync "on"|"off"|"end"|size */ /* Option -stdio_sync "on"|"off"|"end"|size */
int Xorriso_option_stdio_sync(struct XorrisO *xorriso, char *rythm, int flag) int Xorriso_option_stdio_sync(struct XorrisO *xorriso, char *rhythm, int flag)
{ {
double num; double num;
if(strcmp(rythm, "default") == 0 || strcmp(rythm, "on") == 0) { if(strcmp(rhythm, "default") == 0 || strcmp(rhythm, "on") == 0) {
num= 0; num= 0;
} else if(strcmp(rythm, "off") == 0) { } else if(strcmp(rhythm, "off") == 0) {
num= -1; num= -1;
} else if(strcmp(rythm, "end") == 0) { } else if(strcmp(rhythm, "end") == 0) {
num= 1; num= 1;
} else { } else {
num = Scanf_io_size(rythm, 0) / 2048; num = Scanf_io_size(rhythm, 0) / 2048;
if(num < 32 || num > 512 * 1024) { if(num < 32 || num > 512 * 1024) {
sprintf(xorriso->info_text, sprintf(xorriso->info_text,
"-stdio_sync : Bad size. Use: 64k to 1g, \"on\", \"off\", \"end\""); "-stdio_sync : Bad size. Use: 64k to 1g, \"on\", \"off\", \"end\"");

2
xorriso/parse_exec.c
View File

@ -1929,7 +1929,7 @@ if (0) {
fprintf(stderr, " stop\n"); fprintf(stderr, " stop\n");
fprintf(stderr, " perform Xorriso_stop_msg_watcher()\n"); fprintf(stderr, " perform Xorriso_stop_msg_watcher()\n");
} else { } else {
fprintf(stderr, "xorriso -test: unknwon mode: %s\n", arg1); fprintf(stderr, "xorriso -test: unknown mode: %s\n", arg1);
} }
ret= 0; ret= 0;
} }

2
xorriso/sfile.c
View File

@ -330,7 +330,7 @@ char *Sfile_datestr(time_t tim, short int flag)
int Sfile_scale(double value, char *result, int siz, double thresh, int flag) int Sfile_scale(double value, char *result, int siz, double thresh, int flag)
/* /*
bit0= eventually ommit 'b' bit0= omit 'b' if it would elsewise be appended
bit1= make text as short as possible bit1= make text as short as possible
bit2= no fraction (if it would fit at all) bit2= no fraction (if it would fit at all)
*/ */

2
xorriso/sort_cmp.c
View File

@ -105,7 +105,7 @@ int Xorriso__search_node(void *node_array[], int n,
break; break;
p+= l; p+= l;
/* NULL elements may indicate invalid nodes. Their first valid right neigbor /* NULL elements may indicate invalid nodes.Their first valid right neighbor
will serve as proxy. If none exists, then the test pushes leftwards. will serve as proxy. If none exists, then the test pushes leftwards.
*/ */
for(pos= p - 1; pos < n; pos++) for(pos= p - 1; pos < n; pos++)

2
xorriso/text_io.c
View File

@ -3916,7 +3916,7 @@ int Xorriso_pacifier_reset(struct XorrisO *xorriso, int flag)
/* This call is to be issued by long running workers in short intervals. /* This call is to be issued by long running workers in short intervals.
It will check whether enough time has elapsed since the last pacifier It will check whether enough time has elapsed since the last pacifier
message and eventually issue an update message. message and eventually issue an update message.
@param what_done A sparse description of the action, preferrably in past @param what_done A sparse description of the action, preferably in past
tense. E.g. "done" , "files added". tense. E.g. "done" , "files added".
@param count The number of objects processed so far. @param count The number of objects processed so far.
Is ignored if <=0. Is ignored if <=0.

2
xorriso/text_io.h
View File

@ -58,7 +58,7 @@ int Xorriso_pacifier_reset(struct XorrisO *xorriso, int flag);
/* This call is to be issued by long running workers in short intervals. /* This call is to be issued by long running workers in short intervals.
It will check whether enough time has elapsed since the last pacifier It will check whether enough time has elapsed since the last pacifier
message and eventually issue an update message. message and eventually issue an update message.
@param what_done A sparse description of the action, preferrably in past @param what_done A sparse description of the action, preferably in past
tense. E.g. "done" , "files added". tense. E.g. "done" , "files added".
@param count The number of objects processed so far. @param count The number of objects processed so far.
Is ignored if <=0. Is ignored if <=0.

2
xorriso/write_run.c
View File

@ -1782,7 +1782,7 @@ int Xorriso_blank_media(struct XorrisO *xorriso, int flag)
burn_disc_get_profile(drive, &current_profile, current_profile_name); burn_disc_get_profile(drive, &current_profile, current_profile_name);
disc_state = isoburn_disc_get_status(drive); disc_state = isoburn_disc_get_status(drive);
if(current_profile == 0x13) { /* overwriteable DVD-RW */ if(current_profile == 0x13) { /* overwritable DVD-RW */
/* Depending on flag bit1 formatted DVD-RW will get blanked to sequential /* Depending on flag bit1 formatted DVD-RW will get blanked to sequential
state or pseudo blanked by invalidating an eventual ISO image. */ state or pseudo blanked by invalidating an eventual ISO image. */
if(flag&2) if(flag&2)

16
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.5.3, Oct 27, 2019" .TH XORRECORD 1 "Version 1.5.3, Oct 28, 2019"
.\" 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:
@ -232,7 +232,7 @@ with non\-zero exit value.
.B Settings for the burn run: .B Settings for the burn run:
.PP .PP
A burn run requires exactly one track source address argument, which A burn run requires exactly one track source address argument, which
tells from where to read the data which shall be put into the upcomming tells from where to read the data which shall be put into the upcoming
session. The medium state must be either blank or appendable. session. The medium state must be either blank or appendable.
.br .br
Track source may be "\-" for standard input or the address of a readable Track source may be "\-" for standard input or the address of a readable
@ -289,7 +289,7 @@ Minimally blank an entire CD\-RW or blank an unformatted DVD\-RW.
.br .br
deformat deformat
.br .br
Like blank=all but with the additional ability to blank overwriteable DVD\-RW. Like blank=all but with the additional ability to blank overwritable DVD\-RW.
This will destroy their formatting and make them sequentially recordable. This will destroy their formatting and make them sequentially recordable.
.br .br
(Note: blank=deformat is not an original cdrecord options) (Note: blank=deformat is not an original cdrecord options)
@ -299,7 +299,7 @@ deformat_quickest
.br .br
Like blank=deformat but blanking DVD\-RW only minimally. Like blank=deformat but blanking DVD\-RW only minimally.
This is faster than full blanking but yields media incapable of This is faster than full blanking but yields media incapable of
writing tracks of unpredicatable size. writing tracks of unpredictable size.
Multi\-session will not be possible either. Multi\-session will not be possible either.
.br .br
(Note: blank=deformat_quickest is not an original cdrecord option.) (Note: blank=deformat_quickest is not an original cdrecord option.)
@ -346,7 +346,7 @@ session needs to be prepared in a special way by the filesystem formatter
program. mkisofs, genisoimage, and xorrisofs expect particular info about program. mkisofs, genisoimage, and xorrisofs expect particular info about
the situation which can be retrieved by \fBxorrecord\fR option \-msinfo. the situation which can be retrieved by \fBxorrecord\fR option \-msinfo.
.br .br
With overwriteable DVD or BD media, \-multi cannot mark the end of the session. With overwritable DVD or BD media, \-multi cannot mark the end of the session.
So when adding a new session, this end has to be determined from the payload. So when adding a new session, this end has to be determined from the payload.
Currently only ISO\-9660 filesystems can be used that way. See option Currently only ISO\-9660 filesystems can be used that way. See option
\fB\-\-grow_overwriteable_iso\fR. \fB\-\-grow_overwriteable_iso\fR.
@ -561,7 +561,7 @@ drive_scsi_dev_family="sg". The drive addresses may then well be given as
/dev/sr* but will nevertheless get used as /dev/sg*. /dev/sr* but will nevertheless get used as /dev/sg*.
.TP .TP
\fB--grow_overwriteable_iso\fR \fB--grow_overwriteable_iso\fR
Enable emulation of multi\-session writing on overwriteable media which Enable emulation of multi\-session writing on overwritable media which
contain an ISO 9660 filesystem. This emulation is learned from growisofs \-M contain an ISO 9660 filesystem. This emulation is learned from growisofs \-M
but adapted to the usage model of but adapted to the usage model of
.br .br
@ -578,10 +578,10 @@ and to achieve similar results if ISO 9660 filesystem images are to be written.
This option implies option \-isosize and therefore demands that the track This option implies option \-isosize and therefore demands that the track
source is a ISO 9660 filesystem image. source is a ISO 9660 filesystem image.
.br .br
With overwriteable media and no option blank=fast|all present it expands an With overwritable media and no option blank=fast|all present it expands an
eventual ISO 9660 filesystem on media. It is assumed that this image's inner eventual ISO 9660 filesystem on media. It is assumed that this image's inner
size description points to the end of the valuable data. size description points to the end of the valuable data.
Overwriteable media with a recognizable ISO 9660 size will be regarded as Overwritable media with a recognizable ISO 9660 size will be regarded as
appendable rather than as blank. I.e. options \-msinfo and \-toc will work. appendable rather than as blank. I.e. options \-msinfo and \-toc will work.
\-toc will always show a single session with its size increasing with \-toc will always show a single session with its size increasing with
every added ISO 9660 image. every added ISO 9660 image.

76
xorriso/xorrecord.info
View File

@ -148,7 +148,7 @@ File: xorrecord.info, Node: Options, Next: Examples, Prev: Xorriso, Up: Top
* DriveAddr:: Drive addressing * DriveAddr:: Drive addressing
* Inquire:: Inquiring drive and media * Inquire:: Inquiring drive and media
* SetBurn:: Settings for the burn run * SetBurn:: Settings for the burn run
* Verbous:: Program version and verbosity * Verbose:: Program version and verbosity
* NonCdrecord:: Options not compatible to cdrecord * NonCdrecord:: Options not compatible to cdrecord
 
@ -241,14 +241,14 @@ File: xorrecord.info, Node: Inquire, Next: SetBurn, Prev: DriveAddr, Up: Opt
with non-zero exit value. with non-zero exit value.
 
File: xorrecord.info, Node: SetBurn, Next: Verbous, Prev: Inquire, Up: Options File: xorrecord.info, Node: SetBurn, Next: Verbose, Prev: Inquire, Up: Options
5.3 Settings for the burn run 5.3 Settings for the burn run
============================= =============================
A burn run requires exactly one track source address argument, A burn run requires exactly one track source address argument,
which tells from where to read the data which shall be put into the which tells from where to read the data which shall be put into the
upcomming session. The medium state must be either blank or upcoming session. The medium state must be either blank or
appendable. appendable.
Track source may be "-" for standard input or the address of a Track source may be "-" for standard input or the address of a
readable file of any type except directories. Nearly all media readable file of any type except directories. Nearly all media
@ -296,7 +296,7 @@ blank=mode
deformat deformat
Like blank=all but with the additional ability to blank Like blank=all but with the additional ability to blank
overwriteable DVD-RW. This will destroy their formatting and make overwritable DVD-RW. This will destroy their formatting and make
them sequentially recordable. them sequentially recordable.
(Note: blank=deformat is not an original cdrecord options) (Note: blank=deformat is not an original cdrecord options)
@ -304,7 +304,7 @@ blank=mode
deformat_quickest deformat_quickest
Like blank=deformat but blanking DVD-RW only minimally. This is Like blank=deformat but blanking DVD-RW only minimally. This is
faster than full blanking but yields media incapable of writing faster than full blanking but yields media incapable of writing
tracks of unpredicatable size. Multi-session will not be possible tracks of unpredictable size. Multi-session will not be possible
either. either.
(Note: blank=deformat_quickest is not an original cdrecord option.) (Note: blank=deformat_quickest is not an original cdrecord option.)
@ -341,7 +341,7 @@ blank=mode
a special way by the filesystem formatter program. mkisofs, a special way by the filesystem formatter program. mkisofs,
genisoimage, and xorrisofs expect particular info about the genisoimage, and xorrisofs expect particular info about the
situation which can be retrieved by 'xorrecord' option -msinfo. situation which can be retrieved by 'xorrecord' option -msinfo.
With overwriteable DVD or BD media, -multi cannot mark the end of With overwritable DVD or BD media, -multi cannot mark the end of
the session. So when adding a new session, this end has to be the session. So when adding a new session, this end has to be
determined from the payload. Currently only ISO-9660 filesystems determined from the payload. Currently only ISO-9660 filesystems
can be used that way. See option *-grow_overwriteable_iso*. can be used that way. See option *-grow_overwriteable_iso*.
@ -457,7 +457,7 @@ minbuf=percentage
Eject the drive tray after alll other work is done. Eject the drive tray after alll other work is done.
 
File: xorrecord.info, Node: Verbous, Next: NonCdrecord, Prev: SetBurn, Up: Options File: xorrecord.info, Node: Verbose, Next: NonCdrecord, Prev: SetBurn, Up: Options
5.4 Program version and verbosity 5.4 Program version and verbosity
================================= =================================
@ -491,7 +491,7 @@ File: xorrecord.info, Node: Verbous, Next: NonCdrecord, Prev: SetBurn, Up: O
Afterwards end emulation without performing any drive operation. Afterwards end emulation without performing any drive operation.
 
File: xorrecord.info, Node: NonCdrecord, Next: ExDevices, Prev: Verbous, Up: Options File: xorrecord.info, Node: NonCdrecord, Next: ExDevices, Prev: Verbose, Up: Options
5.5 Options not compatible to cdrecord 5.5 Options not compatible to cdrecord
====================================== ======================================
@ -527,7 +527,7 @@ drive_scsi_dev_family=sr|scd|sg|default
well be given as /dev/sr* but will nevertheless get used as well be given as /dev/sr* but will nevertheless get used as
/dev/sg*. /dev/sg*.
--grow_overwriteable_iso --grow_overwriteable_iso
Enable emulation of multi-session writing on overwriteable media Enable emulation of multi-session writing on overwritable media
which contain an ISO 9660 filesystem. This emulation is learned which contain an ISO 9660 filesystem. This emulation is learned
from growisofs -M but adapted to the usage model of from growisofs -M but adapted to the usage model of
xorrecord -msinfo xorrecord -msinfo
@ -539,10 +539,10 @@ drive_scsi_dev_family=sr|scd|sg|default
results if ISO 9660 filesystem images are to be written. This results if ISO 9660 filesystem images are to be written. This
option implies option -isosize and therefore demands that the track option implies option -isosize and therefore demands that the track
source is a ISO 9660 filesystem image. source is a ISO 9660 filesystem image.
With overwriteable media and no option blank=fast|all present it With overwritable media and no option blank=fast|all present it
expands an eventual ISO 9660 filesystem on media. It is assumed expands an eventual ISO 9660 filesystem on media. It is assumed
that this image's inner size description points to the end of the that this image's inner size description points to the end of the
valuable data. Overwriteable media with a recognizable ISO 9660 valuable data. Overwritable media with a recognizable ISO 9660
size will be regarded as appendable rather than as blank. I.e. size will be regarded as appendable rather than as blank. I.e.
options -msinfo and -toc will work. -toc will always show a single options -msinfo and -toc will work. -toc will always show a single
session with its size increasing with every added ISO 9660 image. session with its size increasing with every added ISO 9660 image.
@ -914,7 +914,7 @@ File: xorrecord.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -data explicitly announce a data track: SetBurn. (line 157) * -data explicitly announce a data track: SetBurn. (line 157)
* -dummy control write simulation: SetBurn. (line 106) * -dummy control write simulation: SetBurn. (line 106)
* -eject finally eject drive tray: SetBurn. (line 214) * -eject finally eject drive tray: SetBurn. (line 214)
* -help print sparse overview of options: Verbous. (line 30) * -help print sparse overview of options: Verbose. (line 30)
* -immed keep drive buffer hungry: SetBurn. (line 208) * -immed keep drive buffer hungry: SetBurn. (line 208)
* -inq inquire drive identifiers: Inquire. (line 8) * -inq inquire drive identifiers: Inquire. (line 8)
* -isosize obtain track size from ISO 9660 superblock: SetBurn. * -isosize obtain track size from ISO 9660 superblock: SetBurn.
@ -927,9 +927,9 @@ File: xorrecord.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -sao explicitly set write type SAO/DAO: SetBurn. (line 168) * -sao explicitly set write type SAO/DAO: SetBurn. (line 168)
* -tao explicitly set write type TAO: SetBurn. (line 162) * -tao explicitly set write type TAO: SetBurn. (line 162)
* -toc inquire medium content: Inquire. (line 22) * -toc inquire medium content: Inquire. (line 22)
* -v increase program verbosity: Verbous. (line 16) * -v increase program verbosity: Verbose. (line 16)
* -V log SCSI command transactions to stderr: Verbous. (line 20) * -V log SCSI command transactions to stderr: Verbose. (line 20)
* -version report emulation and xorriso version: Verbous. (line 8) * -version report emulation and xorriso version: Verbose. (line 8)
* -waiti access drive only after stdin delivers data: SetBurn. * -waiti access drive only after stdin delivers data: SetBurn.
(line 113) (line 113)
* blank= make media re-usabable or format media: SetBurn. (line 28) * blank= make media re-usabable or format media: SetBurn. (line 28)
@ -988,13 +988,13 @@ File: xorrecord.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* multi-session info, retrieve, -msinfo: Inquire. (line 43) * multi-session info, retrieve, -msinfo: Inquire. (line 43)
* Multi-session, emulate ISO 9660, --grow_overwriteable_iso: NonCdrecord. * Multi-session, emulate ISO 9660, --grow_overwriteable_iso: NonCdrecord.
(line 37) (line 37)
* Options, overview, -help: Verbous. (line 30) * Options, overview, -help: Verbose. (line 30)
* Overwritable media, _definiton: Standards. (line 30) * Overwritable media, _definiton: Standards. (line 30)
* Padding, at end of track, padsize=: SetBurn. (line 144) * Padding, at end of track, padsize=: SetBurn. (line 144)
* Padding, disable, -nopad: SetBurn. (line 151) * Padding, disable, -nopad: SetBurn. (line 151)
* Padding, insufficient old, -pad: SetBurn. (line 153) * Padding, insufficient old, -pad: SetBurn. (line 153)
* Problems, reporting: Bugreport. (line 6) * Problems, reporting: Bugreport. (line 6)
* SCSI commands, log, -V: Verbous. (line 20) * SCSI commands, log, -V: Verbose. (line 20)
* Sequentially recordable media, _definiton: Standards. (line 25) * Sequentially recordable media, _definiton: Standards. (line 25)
* Session, _definiton: Standards. (line 12) * Session, _definiton: Standards. (line 12)
* Speed, set for writing, speed=: SetBurn. (line 189) * Speed, set for writing, speed=: SetBurn. (line 189)
@ -1004,9 +1004,9 @@ File: xorrecord.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Track, _definiton: Standards. (line 13) * Track, _definiton: Standards. (line 13)
* Transaction size, set, dvd_obs=: NonCdrecord. (line 74) * Transaction size, set, dvd_obs=: NonCdrecord. (line 74)
* Tray, eject, -eject: SetBurn. (line 214) * Tray, eject, -eject: SetBurn. (line 214)
* Verbosity, increase, -v: Verbous. (line 16) * Verbosity, increase, -v: Verbose. (line 16)
* Verbosity, SCSI commands, -V: Verbous. (line 20) * Verbosity, SCSI commands, -V: Verbose. (line 20)
* Version, report, -version: Verbous. (line 8) * Version, report, -version: Verbose. (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 127) (line 127)
@ -1032,23 +1032,23 @@ Node: Options5885
Node: DriveAddr6253 Node: DriveAddr6253
Node: Inquire7618 Node: Inquire7618
Node: SetBurn10487 Node: SetBurn10487
Node: Verbous21115 Node: Verbose21111
Node: NonCdrecord22665 Node: NonCdrecord22661
Node: Examples30478 Node: Examples30471
Node: ExDevices31139 Node: ExDevices31132
Node: ExMedium31357 Node: ExMedium31350
Node: ExBlank31620 Node: ExBlank31613
Node: ExFormat31841 Node: ExFormat31834
Node: ExDeformat32359 Node: ExDeformat32352
Node: ExIsoSingle32626 Node: ExIsoSingle32619
Node: ExIsoMulti32910 Node: ExIsoMulti32903
Node: ExIsoFly34654 Node: ExIsoFly34647
Node: ExAfio35846 Node: ExAfio35839
Node: Files36844 Node: Files36837
Node: Seealso37400 Node: Seealso37393
Node: Bugreport37763 Node: Bugreport37756
Node: Legal38354 Node: Legal38347
Node: CommandIdx39283 Node: CommandIdx39276
Node: ConceptIdx42846 Node: ConceptIdx42839
 
End Tag Table End Tag Table

24
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.5.3, Oct 27, 2019" @c man .TH XORRECORD 1 "Version 1.5.3, Oct 28, 2019"
@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:
@ -240,7 +240,7 @@ run ends or before cdrecord emulation ends.
* DriveAddr:: Drive addressing * DriveAddr:: Drive addressing
* Inquire:: Inquiring drive and media * Inquire:: Inquiring drive and media
* SetBurn:: Settings for the burn run * SetBurn:: Settings for the burn run
* Verbous:: Program version and verbosity * Verbose:: Program version and verbosity
* NonCdrecord:: Options not compatible to cdrecord * NonCdrecord:: Options not compatible to cdrecord
@end menu @end menu
@c man .PP @c man .PP
@ -364,12 +364,12 @@ with non-zero exit value.
@end table @end table
@c man .TP @c man .TP
@c man .B Settings for the burn run: @c man .B Settings for the burn run:
@node SetBurn, Verbous, Inquire, Options @node SetBurn, Verbose, Inquire, Options
@section Settings for the burn run @section Settings for the burn run
@table @asis @table @asis
@c man .PP @c man .PP
A burn run requires exactly one track source address argument, which A burn run requires exactly one track source address argument, which
tells from where to read the data which shall be put into the upcomming tells from where to read the data which shall be put into the upcoming
session. The medium state must be either blank or appendable. session. The medium state must be either blank or appendable.
@* @*
Track source may be "-" for standard input or the address of a readable Track source may be "-" for standard input or the address of a readable
@ -435,7 +435,7 @@ Minimally blank an entire CD-RW or blank an unformatted DVD-RW.
@* @*
deformat deformat
@* @*
Like blank=all but with the additional ability to blank overwriteable DVD-RW. Like blank=all but with the additional ability to blank overwritable DVD-RW.
This will destroy their formatting and make them sequentially recordable. This will destroy their formatting and make them sequentially recordable.
@* @*
(Note: blank=deformat is not an original cdrecord options) (Note: blank=deformat is not an original cdrecord options)
@ -446,7 +446,7 @@ deformat_quickest
@* @*
Like blank=deformat but blanking DVD-RW only minimally. Like blank=deformat but blanking DVD-RW only minimally.
This is faster than full blanking but yields media incapable of This is faster than full blanking but yields media incapable of
writing tracks of unpredicatable size. writing tracks of unpredictable size.
Multi-session will not be possible either. Multi-session will not be possible either.
@* @*
(Note: blank=deformat_quickest is not an original cdrecord option.) (Note: blank=deformat_quickest is not an original cdrecord option.)
@ -497,7 +497,7 @@ session needs to be prepared in a special way by the filesystem formatter
program. mkisofs, genisoimage, and xorrisofs expect particular info about program. mkisofs, genisoimage, and xorrisofs expect particular info about
the situation which can be retrieved by @command{xorrecord} option -msinfo. the situation which can be retrieved by @command{xorrecord} option -msinfo.
@* @*
With overwriteable DVD or BD media, -multi cannot mark the end of the session. With overwritable DVD or BD media, -multi cannot mark the end of the session.
So when adding a new session, this end has to be determined from the payload. So when adding a new session, this end has to be determined from the payload.
Currently only ISO-9660 filesystems can be used that way. See option Currently only ISO-9660 filesystems can be used that way. See option
@strong{--grow_overwriteable_iso}. @strong{--grow_overwriteable_iso}.
@ -674,7 +674,7 @@ Eject the drive tray after alll other work is done.
@end table @end table
@c man .TP @c man .TP
@c man .B Program version and verbosity: @c man .B Program version and verbosity:
@node Verbous, NonCdrecord, SetBurn, Options @node Verbose, NonCdrecord, SetBurn, Options
@section Program version and verbosity @section Program version and verbosity
@table @asis @table @asis
@sp 1 @sp 1
@ -725,7 +725,7 @@ Afterwards end emulation without performing any drive operation.
@end table @end table
@c man .TP @c man .TP
@c man .B Options not compatible to cdrecord: @c man .B Options not compatible to cdrecord:
@node NonCdrecord, ExDevices, Verbous, Options @node NonCdrecord, ExDevices, Verbose, Options
@section Options not compatible to cdrecord @section Options not compatible to cdrecord
@table @asis @table @asis
@sp 1 @sp 1
@ -772,7 +772,7 @@ drive_scsi_dev_family="sg". The drive addresses may then well be given as
@item @minus{}@minus{}grow_overwriteable_iso @item @minus{}@minus{}grow_overwriteable_iso
@kindex @minus{}@minus{}grow_overwriteable_iso emulate ISO 9660 multi-session @kindex @minus{}@minus{}grow_overwriteable_iso emulate ISO 9660 multi-session
@cindex Multi-session, emulate ISO 9660, @minus{}@minus{}grow_overwriteable_iso @cindex Multi-session, emulate ISO 9660, @minus{}@minus{}grow_overwriteable_iso
Enable emulation of multi-session writing on overwriteable media which Enable emulation of multi-session writing on overwritable media which
contain an ISO 9660 filesystem. This emulation is learned from growisofs -M contain an ISO 9660 filesystem. This emulation is learned from growisofs -M
but adapted to the usage model of but adapted to the usage model of
@* @*
@ -789,10 +789,10 @@ and to achieve similar results if ISO 9660 filesystem images are to be written.
This option implies option -isosize and therefore demands that the track This option implies option -isosize and therefore demands that the track
source is a ISO 9660 filesystem image. source is a ISO 9660 filesystem image.
@* @*
With overwriteable media and no option blank=fast|all present it expands an With overwritable media and no option blank=fast|all present it expands an
eventual ISO 9660 filesystem on media. It is assumed that this image's inner eventual ISO 9660 filesystem on media. It is assumed that this image's inner
size description points to the end of the valuable data. size description points to the end of the valuable data.
Overwriteable media with a recognizable ISO 9660 size will be regarded as Overwritable media with a recognizable ISO 9660 size will be regarded as
appendable rather than as blank. I.e. options -msinfo and -toc will work. appendable rather than as blank. I.e. options -msinfo and -toc will work.
-toc will always show a single session with its size increasing with -toc will always show a single session with its size increasing with
every added ISO 9660 image. every added ISO 9660 image.

60
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.5.3, Oct 27, 2019" .TH XORRISO 1 "Version 1.5.3, Oct 28, 2019"
.\" 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:
@ -78,7 +78,7 @@ Can check media for damages and copy readable blocks to disk.
.br .br
Can attach MD5 checksums to each data file and the whole session. Can attach MD5 checksums to each data file and the whole session.
.br .br
Scans for optical drives, blanks re\-useable optical media. Scans for optical drives, blanks re\-usable optical media.
.br .br
Reads its instructions from command line arguments, dialog, and files. Reads its instructions from command line arguments, dialog, and files.
.br .br
@ -141,7 +141,7 @@ Adding a session to an existing ISO image is in this text referred as
.br .br
The multi\-session model of the MMC standard does not apply to all media The multi\-session model of the MMC standard does not apply to all media
types. But program growisofs by Andy Polyakov showed how to extend this types. But program growisofs by Andy Polyakov showed how to extend this
functionality to overwriteable media or disk files which carry valid ISO 9660 functionality to overwritable media or disk files which carry valid ISO 9660
filesystems. filesystems.
.PP .PP
\fBxorriso\fR provides growing as well as an own method named \fBxorriso\fR provides growing as well as an own method named
@ -180,7 +180,7 @@ Similar to multi\-session media are DVD\-R DL and minimally blanked DVD\-RW.
They record 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. \fBOverwritable media\fR are DVD\-RAM, DVD+RW, BD\-RE, and formatted DVD\-RW.
They offer 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
@ -189,7 +189,7 @@ be emulated. Else only a single overall session will be visible.
DVD\-RW media can be formatted by \-format "full". DVD\-RW media can be formatted by \-format "full".
They can be made unformatted by \-blank "deformat". They can be made unformatted by \-blank "deformat".
.br .br
Regular files and block devices are handled as overwriteable media. Regular files and block devices are handled as overwritable media.
Pipes and other writeable file types are handled as blank multi\-session media. Pipes and other writeable file types are handled as blank multi\-session media.
.PP .PP
These media can assume several states in which they offer different These media can assume several states in which they offer different
@ -200,13 +200,13 @@ suitable for \fBxorriso\fR.
.br .br
Blank is the state of newly purchased optical media. Blank is the state of newly purchased optical media.
With used CD\-RW and DVD\-RW it can be achieved by action \-blank "as_needed". With used CD\-RW and DVD\-RW it can be achieved by action \-blank "as_needed".
Overwriteable media are considered blank if they are new or if they have Overwritable media are considered blank if they are new or if they have
been marked as blank by \fBxorriso\fR. been marked as blank by \fBxorriso\fR.
Action \-blank "as_needed" can be used to do this marking on overwriteable Action \-blank "as_needed" can be used to do this marking on overwritable
media, or to apply mandatory formatting to new media if necessary. media, or to apply mandatory formatting to new media if necessary.
.br .br
\fBAppendable\fR media accept further sessions. Either they are MMC \fBAppendable\fR media accept further sessions. Either they are MMC
multi\-session media in appendable state, or they are overwriteable media multi\-session media in appendable state, or they are overwritable media
which contain an ISO image suitable for \fBxorriso\fR. which contain an ISO image suitable for \fBxorriso\fR.
.br .br
Appendable is the state after writing a session with command \-close off. Appendable is the state after writing a session with command \-close off.
@ -218,7 +218,7 @@ Closed is the state of DVD\-ROM media and of multi\-session media which were
written with command \-close on. If the drive is read\-only hardware then it will written with command \-close on. If the drive is read\-only hardware then it will
probably show any media as closed CD\-ROM or DVD\-ROM. probably show any media as closed CD\-ROM or DVD\-ROM.
.br .br
Overwriteable media assume this state in such read\-only drives or if they Overwritable media assume this state in such read\-only drives or if they
contain unrecognizable data in the first 32 data blocks. contain unrecognizable data in the first 32 data blocks.
.br .br
Read\-only drives may or may not show session histories of multi\-session Read\-only drives may or may not show session histories of multi\-session
@ -289,7 +289,7 @@ of modifying and blind growing. They all are suitable for newly created images.
.PP .PP
All drive file objects have to offer rw\-permission to the user of All drive file objects have to offer rw\-permission to the user of
\fBxorriso\fR. \fBxorriso\fR.
Even those which will not be useable for reading an ISO image. Even those which will not be usable for reading an ISO image.
.br .br
With any type of drive object, the data are considered to be organized in With any type of drive object, the data are considered to be organized in
blocks of 2 KiB. Access happens in terms of Logical Block Address blocks of 2 KiB. Access happens in terms of Logical Block Address
@ -414,7 +414,7 @@ hard\-disk\-like media. Several options install a \fBMBR\fR
intended boot firmware and the involved boot loaders, e.g. GRUB2 or ISOLINUX. intended boot firmware and the involved boot loaders, e.g. GRUB2 or ISOLINUX.
A MBR contains boot code and a partition table. A MBR contains boot code and a partition table.
The new MBR of a follow\-up session can get in effect The new MBR of a follow\-up session can get in effect
only on overwriteable media. only on overwritable media.
.br .br
MBR is read by PC\-BIOS when booting from USB stick or hard disk, MBR is read by PC\-BIOS when booting from USB stick or hard disk,
and by PowerPC CHRP or PReP when booting. and by PowerPC CHRP or PReP when booting.
@ -1115,7 +1115,7 @@ Else just avoid names longer than 253 characters.
Read\-only drives do not tell the actual media type but show any media as Read\-only drives do not tell the actual media type but show any media as
ROM (e.g. as DVD\-ROM). The session history of MMC multi\-session media might ROM (e.g. as DVD\-ROM). The session history of MMC multi\-session media might
be truncated to first and last session or even be completely false. be truncated to first and last session or even be completely false.
(The emulated history of overwriteable media is not affected by this.) (The emulated history of overwritable media is not affected by this.)
.br .br
To have in case of failure a chance of getting the session history and To have in case of failure a chance of getting the session history and
especially the address of the last session, there is a scan for ISO 9660 especially the address of the last session, there is a scan for ISO 9660
@ -1129,11 +1129,11 @@ multi\-session DVD or BD. If on such a system \fBxorriso\fR has no own MMC
capabilities then it may still find that session from a scanned table of capabilities then it may still find that session from a scanned table of
content. Setting "force" handles any media like a ROM medium with setting "on". content. Setting "force" handles any media like a ROM medium with setting "on".
.br .br
On the other hand the emulation of session history on overwriteable media On the other hand the emulation of session history on overwritable media
can hamper reading of partly damaged media. Setting "off:emul_off" disables can hamper reading of partly damaged media. Setting "off:emul_off" disables
the elsewise trustworthy table\-of\-content scan for those media. the elsewise trustworthy table\-of\-content scan for those media.
.br .br
The table\-of\-content scan on overwriteable media normally searches only up to The table\-of\-content scan on overwritable media normally searches only up to
the end of the session that is pointed to by the superblock at block 0. the end of the session that is pointed to by the superblock at block 0.
Setting "on:emul_wide" lets the scan continue up to the end of the medium. Setting "on:emul_wide" lets the scan continue up to the end of the medium.
This may be useful after copying a medium with \-check_media patch_lba0=on This may be useful after copying a medium with \-check_media patch_lba0=on
@ -1162,7 +1162,7 @@ effective access permissions. This implies to try opening those files for
writing, which otherwise will happen only later and only if actual writing, which otherwise will happen only later and only if actual
writing is desired. writing is desired.
.br .br
The test result is used for classifying the pseudo drives as overwriteable, The test result is used for classifying the pseudo drives as overwritable,
read\-only, write\-only, or uselessly empty. This may lead to earlier detection read\-only, write\-only, or uselessly empty. This may lead to earlier detection
of severe problems, and may avoid some less severe error events. of severe problems, and may avoid some less severe error events.
.br .br
@ -2526,16 +2526,16 @@ then this command leads to a FAILURE event.
Defined modes are: Defined modes are:
as_needed, fast, all, deformat, deformat_quickest as_needed, fast, all, deformat, deformat_quickest
.br .br
"as_needed" cares for used CD\-RW, DVD\-RW and for used overwriteable media "as_needed" cares for used CD\-RW, DVD\-RW and for used overwritable media
by applying \-blank "fast". It applies \-format "full" to yet unformatted by applying \-blank "fast". It applies \-format "full" to yet unformatted
DVD\-RAM and BD\-RE. Other media in blank state are gracefully ignored. DVD\-RAM and BD\-RE. Other media in blank state are gracefully ignored.
Media which cannot be made ready for writing from scratch cause a FAILURE Media which cannot be made ready for writing from scratch cause a FAILURE
event. event.
.br .br
"fast" makes CD\-RW and unformatted DVD\-RW re\-usable, or invalidates "fast" makes CD\-RW and unformatted DVD\-RW re\-usable, or invalidates
overwriteable ISO images. "all" might work more thoroughly and need more time. overwritable ISO images. "all" might work more thoroughly and need more time.
.br .br
"deformat" converts overwriteable DVD\-RW into unformatted ones. "deformat" converts overwritable DVD\-RW into unformatted ones.
.br .br
"deformat_quickest" is a faster way to deformat or blank DVD\-RW "deformat_quickest" is a faster way to deformat or blank DVD\-RW
but produces media which are only suitable for a single session. but produces media which are only suitable for a single session.
@ -2555,7 +2555,7 @@ Blanking will nevertheless only succeed if the drive is willing to do it.
.br .br
.TP .TP
\fB\-format\fR mode \fB\-format\fR mode
Convert unformatted DVD\-RW into overwriteable ones, "de\-ice" DVD+RW, format Convert unformatted DVD\-RW into overwritable ones, "de\-ice" DVD+RW, format
newly purchased BD\-RE or BD\-R, re\-format DVD\-RAM or BD\-RE. newly purchased BD\-RE or BD\-R, re\-format DVD\-RAM or BD\-RE.
.br .br
Defined modes are: Defined modes are:
@ -2811,7 +2811,7 @@ Default is "old_rr" which uses Rock Ridge version 1.10. This implies also
"aaip_susp_1_10" allows AAIP to be written as unofficial extension of RRIP "aaip_susp_1_10" allows AAIP to be written as unofficial extension of RRIP
rather than as official extension under SUSP\-1.12. rather than as official extension under SUSP\-1.12.
.br .br
"no_emul_toc" saves 64 kB with the first session on overwriteable media "no_emul_toc" saves 64 kB with the first session on overwritable media
but makes the image incapable of displaying its session history. but makes the image incapable of displaying its session history.
.br .br
"iso_9660_1999" causes the production of an additional directory tree "iso_9660_1999" causes the production of an additional directory tree
@ -3201,7 +3201,7 @@ The same effect is achieved by \-padding mode "included".
.PP .PP
Contrary to published specifications many BIOSes will load an El Torito Contrary to published specifications many BIOSes will load an El Torito
record from the first session on media and not from the last one, which record from the first session on media and not from the last one, which
gets mounted by default. This makes no problems with overwriteable media, gets mounted by default. This makes no problems with overwritable media,
because they appear to inadverted readers as one single session. because they appear to inadverted readers as one single session.
.br .br
But with multi\-session media CD\-R[W], DVD\-R[W], DVD+R, it implies that the But with multi\-session media CD\-R[W], DVD\-R[W], DVD+R, it implies that the
@ -3213,7 +3213,7 @@ If a boot image from ISOLINUX or GRUB is known to be present on media then
it is advised to patch it it is advised to patch it
when a follow\-up session gets written. But one should not rely on the when a follow\-up session gets written. But one should not rely on the
capability to influence the bootability of the existing sessions, unless one capability to influence the bootability of the existing sessions, unless one
can assume overwriteable media. can assume overwritable media.
.br .br
Normally the boot images are data files inside the ISO filesystem. By Normally the boot images are data files inside the ISO filesystem. By
special path "\-\-interval:appended_partition_NNN:all::" it is possible to special path "\-\-interval:appended_partition_NNN:all::" it is possible to
@ -4165,9 +4165,9 @@ Precedence is: "dvdrw", "cdrw", "dvd", "cdrom", "cd".
Show media specific tables of content. This is the session history Show media specific tables of content. This is the session history
of the medium, not the ISO image directory tree. of the medium, not the ISO image directory tree.
.br .br
In case of overwriteable media holding a valid ISO image, it may happen that In case of overwritable media holding a valid ISO image, it may happen that
only a single session gets shown. But if the first session on the only a single session gets shown. But if the first session on the
overwriteable media was written by \fBxorriso\fR then a complete overwritable media was written by \fBxorriso\fR then a complete
session history can be emulated. session history can be emulated.
.br .br
A drive which is incapable of writing may show any media as CD\-ROM or DVD\-ROM A drive which is incapable of writing may show any media as CD\-ROM or DVD\-ROM
@ -5002,7 +5002,7 @@ same name and hardcoded parameter "on", e.g. \-acl "on".
Explicit parameters are expected by \-\-stdio_sync Explicit parameters are expected by \-\-stdio_sync
and \-\-scdbackup_tag. and \-\-scdbackup_tag.
.br .br
The capability to preserve multi\-session history on overwriteable media The capability to preserve multi\-session history on overwritable media
gets disabled by default. It can be enabled by using \-\-emul\-toc gets disabled by default. It can be enabled by using \-\-emul\-toc
with the first session. See \-compliance no_emul_toc. with the first session. See \-compliance no_emul_toc.
.br .br
@ -5074,7 +5074,7 @@ It ignores most other options of cdrecord and cdrskin but refuses on
\-audio, \-scanbus, and on blanking modes unknown to \fBxorriso\fR. \-audio, \-scanbus, and on blanking modes unknown to \fBxorriso\fR.
.br .br
The scope is only a single data track per session to be written The scope is only a single data track per session to be written
to blank, overwriteable, or appendable media. The medium gets closed if to blank, overwritable, or appendable media. The medium gets closed if
closing is applicable and not option \-multi is present. closing is applicable and not option \-multi is present.
.br .br
If an input drive was acquired, then it is given up. If an input drive was acquired, then it is given up.
@ -5087,7 +5087,7 @@ If a track source is given, then an automatic \-commit happens at the end of
the "cdrecord" option list. the "cdrecord" option list.
.br .br
\-\-grow_overwriteable_iso \-\-grow_overwriteable_iso
enables emulation of multi\-session on overwriteable enables emulation of multi\-session on overwritable
media. To enable emulation of a TOC, the first session needs \-C 0,32 with media. To enable emulation of a TOC, the first session needs \-C 0,32 with
\-as mkisofs (but no \-M) and \-\-grow_overwriteable_iso \-as mkisofs (but no \-M) and \-\-grow_overwriteable_iso
write_start_address=32s with \-as cdrecord. write_start_address=32s with \-as cdrecord.
@ -5899,7 +5899,7 @@ If this does not help, insert a run of "sleep 10" between xorriso and dd.
This example works for multi\-session media only. This example works for multi\-session media only.
Add cdrskin option \-\-grow_overwriteable_iso Add cdrskin option \-\-grow_overwriteable_iso
to all \-as cdrecord runs to all \-as cdrecord runs
in order to enable multi\-session emulation on overwriteable media. in order to enable multi\-session emulation on overwritable media.
.SS .SS
.B Let xorriso work underneath growisofs .B Let xorriso work underneath growisofs
growisofs expects an ISO formatter program which understands options \-C and growisofs expects an ISO formatter program which understands options \-C and
@ -5930,7 +5930,7 @@ $ growisofs \-Z /dev/dvd \-\- outdev \- \-update_r /my/files /files
$ growisofs \-M /dev/dvd \-\- outdev \- \-update_r /my/files /files $ growisofs \-M /dev/dvd \-\- outdev \- \-update_r /my/files /files
.br .br
growisofs has excellent burn capabilities with DVD and BD. growisofs has excellent burn capabilities with DVD and BD.
It does not emulate session history on overwriteable media, though. It does not emulate session history on overwritable media, though.
.SS .SS
.B Adjust thresholds for verbosity, exit value and program abort .B Adjust thresholds for verbosity, exit value and program abort
Be quite verbose, exit 32 if severity "FAILURE" was encountered, Be quite verbose, exit 32 if severity "FAILURE" was encountered,
@ -6034,7 +6034,7 @@ it is possible to access the session trees which represent the older backup
versions. With CD media, GNU/Linux mount accepts session numbers directly by versions. With CD media, GNU/Linux mount accepts session numbers directly by
its option "session=". its option "session=".
.br .br
Multi\-session media and most overwriteable media written by \fBxorriso\fR Multi\-session media and most overwritable media written by \fBxorriso\fR
can tell the sbsectors of their sessions by \fBxorriso\fR command \-toc. can tell the sbsectors of their sessions by \fBxorriso\fR command \-toc.
Used after \-commit the following command prints the matching mount command for Used after \-commit the following command prints the matching mount command for
the newly written session (here for mount point /mnt): the newly written session (here for mount point /mnt):

6
xorriso/xorriso.h
View File

@ -207,8 +207,8 @@ int Xorriso_startup_libraries(struct XorrisO *xorriso, int flag);
functions from the Command API. functions from the Command API.
Wenn all desired activities are done, you may check whether there are Wenn all desired activities are done, you may check whether there are
uncommited changes pending, compute an exit value, destroy the XorrisO uncommitted changes pending, compute an exit value, destroy the
object, and exit your program. XorrisO object, and exit your program.
*/ */
@ -2096,7 +2096,7 @@ int Xorriso_option_status_history_max(struct XorrisO *xorriso, int num1,
/* Command -stdio_sync "on"|"off"|"end"|size */ /* Command -stdio_sync "on"|"off"|"end"|size */
/* @since 0.4.6 */ /* @since 0.4.6 */
int Xorriso_option_stdio_sync(struct XorrisO *xorriso, char *rythm, int flag); int Xorriso_option_stdio_sync(struct XorrisO *xorriso, char *rhythm, int flag);
/* Command -stream_recording */ /* Command -stream_recording */
/* @since 0.1.8 */ /* @since 0.1.8 */

199
xorriso/xorriso.info
View File

@ -77,7 +77,7 @@ Content may get zisofs compressed or filtered by external processes.
Can issue commands to mount older sessions on GNU/Linux or FreeBSD. Can issue commands to mount older sessions on GNU/Linux or FreeBSD.
Can check media for damages and copy readable blocks to disk. Can check media for damages and copy readable blocks to disk.
Can attach MD5 checksums to each data file and the whole session. Can attach MD5 checksums to each data file and the whole session.
Scans for optical drives, blanks re-useable optical media. Scans for optical drives, blanks re-usable optical media.
Reads its instructions from command line arguments, dialog, and files. Reads its instructions from command line arguments, dialog, and files.
Provides navigation commands for interactive ISO image manipulation. Provides navigation commands for interactive ISO image manipulation.
Adjustable thresholds for abort, exit value, and problem reporting. Adjustable thresholds for abort, exit value, and problem reporting.
@ -118,7 +118,7 @@ Adding a session to an existing ISO image is in this text referred as
*growing*. *growing*.
The multi-session model of the MMC standard does not apply to all media The multi-session model of the MMC standard does not apply to all media
types. But program growisofs by Andy Polyakov showed how to extend this types. But program growisofs by Andy Polyakov showed how to extend this
functionality to overwriteable media or disk files which carry valid ISO functionality to overwritable media or disk files which carry valid ISO
9660 filesystems. 9660 filesystems.
'xorriso' provides growing as well as an own method named *modifying* 'xorriso' provides growing as well as an own method named *modifying*
@ -159,7 +159,7 @@ Similar to multi-session media are DVD-R DL and minimally blanked
DVD-RW. They record only a single session of which the size must be DVD-RW. They record only a single session of which the size must be
known in advance. 'xorriso' will write onto them only if command -close known in advance. 'xorriso' will write onto them only if command -close
is set to "on". is set to "on".
*Overwriteable media* are DVD-RAM, DVD+RW, BD-RE, and formatted DVD-RW. *Overwritable media* are DVD-RAM, DVD+RW, BD-RE, and formatted DVD-RW.
They offer 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
@ -167,7 +167,7 @@ content can be emulated. Else only a single overall session will be
visible. visible.
DVD-RW media can be formatted by -format "full". They can be made DVD-RW media can be formatted by -format "full". They can be made
unformatted by -blank "deformat". unformatted by -blank "deformat".
Regular files and block devices are handled as overwriteable media. Regular files and block devices are handled as overwritable media.
Pipes and other writeable file types are handled as blank multi-session Pipes and other writeable file types are handled as blank multi-session
media. media.
@ -178,13 +178,13 @@ capabilities.
suitable for 'xorriso'. suitable for 'xorriso'.
Blank is the state of newly purchased optical media. With used CD-RW Blank is the state of newly purchased optical media. With used CD-RW
and DVD-RW it can be achieved by action -blank "as_needed". and DVD-RW it can be achieved by action -blank "as_needed".
Overwriteable media are considered blank if they are new or if they have Overwritable media are considered blank if they are new or if they have
been marked as blank by 'xorriso'. Action -blank "as_needed" can be been marked as blank by 'xorriso'. Action -blank "as_needed" can be
used to do this marking on overwriteable media, or to apply mandatory used to do this marking on overwritable media, or to apply mandatory
formatting to new media if necessary. formatting to new media if necessary.
*Appendable* media accept further sessions. Either they are MMC *Appendable* media accept further sessions. Either they are MMC
multi-session media in appendable state, or they are overwriteable media multi-session media in appendable state, or they are overwritable media
which contain an ISO image suitable for 'xorriso'. which contain an ISO image suitable for 'xorriso'.
Appendable is the state after writing a session with command -close off. Appendable is the state after writing a session with command -close off.
@ -194,8 +194,8 @@ suitable for 'xorriso'.
Closed is the state of DVD-ROM media and of multi-session media which Closed is the state of DVD-ROM media and of multi-session media which
were written with command -close on. If the drive is read-only hardware were written with command -close on. If the drive is read-only hardware
then it will probably show any media as closed CD-ROM or DVD-ROM. then it will probably show any media as closed CD-ROM or DVD-ROM.
Overwriteable media assume this state in such read-only drives or if Overwritable media assume this state in such read-only drives or if they
they contain unrecognizable data in the first 32 data blocks. contain unrecognizable data in the first 32 data blocks.
Read-only drives may or may not show session histories of multi-session Read-only drives may or may not show session histories of multi-session
media. Often only the first and the last session are visible. media. Often only the first and the last session are visible.
Sometimes not even that. Command -rom_toc_scan might or might not help Sometimes not even that. Command -rom_toc_scan might or might not help
@ -267,7 +267,7 @@ modifying and blind growing. They all are suitable for newly created
images. images.
All drive file objects have to offer rw-permission to the user of All drive file objects have to offer rw-permission to the user of
'xorriso'. Even those which will not be useable for reading an ISO 'xorriso'. Even those which will not be usable for reading an ISO
image. image.
With any type of drive object, the data are considered to be organized With any type of drive object, the data are considered to be organized
in blocks of 2 KiB. Access happens in terms of Logical Block Address in blocks of 2 KiB. Access happens in terms of Logical Block Address
@ -369,7 +369,7 @@ hard-disk-like media. Several options install a *MBR* (Master Boot
Record), It may get adjusted according to the needs of the intended boot Record), It may get adjusted according to the needs of the intended boot
firmware and the involved boot loaders, e.g. GRUB2 or ISOLINUX. A MBR firmware and the involved boot loaders, e.g. GRUB2 or ISOLINUX. A MBR
contains boot code and a partition table. The new MBR of a follow-up contains boot code and a partition table. The new MBR of a follow-up
session can get in effect only on overwriteable media. session can get in effect only on overwritable media.
MBR is read by PC-BIOS when booting from USB stick or hard disk, and by MBR is read by PC-BIOS when booting from USB stick or hard disk, and by
PowerPC CHRP or PReP when booting. An MBR partition with type 0xee PowerPC CHRP or PReP when booting. An MBR partition with type 0xee
indicates the presence of GPT. indicates the presence of GPT.
@ -1000,7 +1000,7 @@ activate them only after image loading.
Read-only drives do not tell the actual media type but show any Read-only drives do not tell the actual media type but show any
media as ROM (e.g. as DVD-ROM). The session history of MMC media as ROM (e.g. as DVD-ROM). The session history of MMC
multi-session media might be truncated to first and last session or multi-session media might be truncated to first and last session or
even be completely false. (The emulated history of overwriteable even be completely false. (The emulated history of overwritable
media is not affected by this.) media is not affected by this.)
To have in case of failure a chance of getting the session history To have in case of failure a chance of getting the session history
and especially the address of the last session, there is a scan for and especially the address of the last session, there is a scan for
@ -1014,11 +1014,11 @@ activate them only after image loading.
has no own MMC capabilities then it may still find that session has no own MMC capabilities then it may still find that session
from a scanned table of content. Setting "force" handles any media from a scanned table of content. Setting "force" handles any media
like a ROM medium with setting "on". like a ROM medium with setting "on".
On the other hand the emulation of session history on overwriteable On the other hand the emulation of session history on overwritable
media can hamper reading of partly damaged media. Setting media can hamper reading of partly damaged media. Setting
"off:emul_off" disables the elsewise trustworthy table-of-content "off:emul_off" disables the elsewise trustworthy table-of-content
scan for those media. scan for those media.
The table-of-content scan on overwriteable media normally searches The table-of-content scan on overwritable media normally searches
only up to the end of the session that is pointed to by the only up to the end of the session that is pointed to by the
superblock at block 0. Setting "on:emul_wide" lets the scan superblock at block 0. Setting "on:emul_wide" lets the scan
continue up to the end of the medium. This may be useful after continue up to the end of the medium. This may be useful after
@ -1044,7 +1044,7 @@ activate them only after image loading.
those files for writing, which otherwise will happen only later and those files for writing, which otherwise will happen only later and
only if actual writing is desired. only if actual writing is desired.
The test result is used for classifying the pseudo drives as The test result is used for classifying the pseudo drives as
overwriteable, read-only, write-only, or uselessly empty. This may overwritable, read-only, write-only, or uselessly empty. This may
lead to earlier detection of severe problems, and may avoid some lead to earlier detection of severe problems, and may avoid some
less severe error events. less severe error events.
Mode "appendable_wo" is like "on" with the additional property that Mode "appendable_wo" is like "on" with the additional property that
@ -2157,15 +2157,15 @@ File: xorriso.info, Node: Writing, Next: SetWrite, Prev: Filter, Up: Command
the same and if the ISO image was altered then this command leads the same and if the ISO image was altered then this command leads
to a FAILURE event. Defined modes are: as_needed, fast, all, to a FAILURE event. Defined modes are: as_needed, fast, all,
deformat, deformat_quickest deformat, deformat_quickest
"as_needed" cares for used CD-RW, DVD-RW and for used overwriteable "as_needed" cares for used CD-RW, DVD-RW and for used overwritable
media by applying -blank "fast". It applies -format "full" to yet media by applying -blank "fast". It applies -format "full" to yet
unformatted DVD-RAM and BD-RE. Other media in blank state are unformatted DVD-RAM and BD-RE. Other media in blank state are
gracefully ignored. Media which cannot be made ready for writing gracefully ignored. Media which cannot be made ready for writing
from scratch cause a FAILURE event. from scratch cause a FAILURE event.
"fast" makes CD-RW and unformatted DVD-RW re-usable, or invalidates "fast" makes CD-RW and unformatted DVD-RW re-usable, or invalidates
overwriteable ISO images. "all" might work more thoroughly and overwritable ISO images. "all" might work more thoroughly and need
need more time. more time.
"deformat" converts overwriteable DVD-RW into unformatted ones. "deformat" converts overwritable DVD-RW into unformatted ones.
"deformat_quickest" is a faster way to deformat or blank DVD-RW but "deformat_quickest" is a faster way to deformat or blank DVD-RW but
produces media which are only suitable for a single session. Some produces media which are only suitable for a single session. Some
drives announce this state by not offering feature 21h, but some drives announce this state by not offering feature 21h, but some
@ -2181,9 +2181,8 @@ File: xorriso.info, Node: Writing, Next: SetWrite, Prev: Filter, Up: Command
Blanking will nevertheless only succeed if the drive is willing to Blanking will nevertheless only succeed if the drive is willing to
do it. do it.
-format mode -format mode
Convert unformatted DVD-RW into overwriteable ones, "de-ice" Convert unformatted DVD-RW into overwritable ones, "de-ice" DVD+RW,
DVD+RW, format newly purchased BD-RE or BD-R, re-format DVD-RAM or format newly purchased BD-RE or BD-R, re-format DVD-RAM or BD-RE.
BD-RE.
Defined modes are: Defined modes are:
as_needed, full, fast, by_index_<num>, fast_by_index_<num>, as_needed, full, fast, by_index_<num>, fast_by_index_<num>,
by_size_<num>, fast_by_size_<num>, without_spare by_size_<num>, fast_by_size_<num>, without_spare
@ -2404,7 +2403,7 @@ according to the setting of command -acl.
"aaip_susp_1_10_off". "aaip_susp_1_10_off".
"aaip_susp_1_10" allows AAIP to be written as unofficial extension "aaip_susp_1_10" allows AAIP to be written as unofficial extension
of RRIP rather than as official extension under SUSP-1.12. of RRIP rather than as official extension under SUSP-1.12.
"no_emul_toc" saves 64 kB with the first session on overwriteable "no_emul_toc" saves 64 kB with the first session on overwritable
media but makes the image incapable of displaying its session media but makes the image incapable of displaying its session
history. history.
"iso_9660_1999" causes the production of an additional directory "iso_9660_1999" causes the production of an additional directory
@ -2720,7 +2719,7 @@ File: xorriso.info, Node: Bootable, Next: Jigdo, Prev: SetWrite, Up: Command
Contrary to published specifications many BIOSes will load an El Torito Contrary to published specifications many BIOSes will load an El Torito
record from the first session on media and not from the last one, which record from the first session on media and not from the last one, which
gets mounted by default. This makes no problems with overwriteable gets mounted by default. This makes no problems with overwritable
media, because they appear to inadverted readers as one single session. media, because they appear to inadverted readers as one single session.
But with multi-session media CD-R[W], DVD-R[W], DVD+R, it implies that But with multi-session media CD-R[W], DVD-R[W], DVD+R, it implies that
the whole bootable system has to reside already in the first session and the whole bootable system has to reside already in the first session and
@ -2729,7 +2728,7 @@ system expects after mounting the ISO image.
If a boot image from ISOLINUX or GRUB is known to be present on media If a boot image from ISOLINUX or GRUB is known to be present on media
then it is advised to patch it when a follow-up session gets written. then it is advised to patch it when a follow-up session gets written.
But one should not rely on the capability to influence the bootability But one should not rely on the capability to influence the bootability
of the existing sessions, unless one can assume overwriteable media. of the existing sessions, unless one can assume overwritable media.
Normally the boot images are data files inside the ISO filesystem. By Normally the boot images are data files inside the ISO filesystem. By
special path "-interval:appended_partition_NNN:all::" it is possible to special path "-interval:appended_partition_NNN:all::" it is possible to
refer to an appended partition. The number NNN gives the partition refer to an appended partition. The number NNN gives the partition
@ -3502,9 +3501,9 @@ File: xorriso.info, Node: Inquiry, Next: Navigate, Prev: DialogCtl, Up: Comm
Show media specific tables of content. This is the session history Show media specific tables of content. This is the session history
of the medium, not the ISO image directory tree. of the medium, not the ISO image directory tree.
In case of overwriteable media holding a valid ISO image, it may In case of overwritable media holding a valid ISO image, it may
happen that only a single session gets shown. But if the first happen that only a single session gets shown. But if the first
session on the overwriteable media was written by 'xorriso' then a session on the overwritable media was written by 'xorriso' then a
complete session history can be emulated. complete session history can be emulated.
A drive which is incapable of writing may show any media as CD-ROM A drive which is incapable of writing may show any media as CD-ROM
or DVD-ROM with only one or two sessions on it. The last of these or DVD-ROM with only one or two sessions on it. The last of these
@ -4219,7 +4218,7 @@ said programs trigger comparable actions.
'xorriso' commands with the same name and hardcoded parameter "on", 'xorriso' commands with the same name and hardcoded parameter "on",
e.g. -acl "on". Explicit parameters are expected by --stdio_sync e.g. -acl "on". Explicit parameters are expected by --stdio_sync
and --scdbackup_tag. and --scdbackup_tag.
The capability to preserve multi-session history on overwriteable The capability to preserve multi-session history on overwritable
media gets disabled by default. It can be enabled by using media gets disabled by default. It can be enabled by using
--emul-toc with the first session. See -compliance no_emul_toc. --emul-toc with the first session. See -compliance no_emul_toc.
--sort-weight gets as parameters a number and an iso_rr_path. The --sort-weight gets as parameters a number and an iso_rr_path. The
@ -4270,7 +4269,7 @@ said programs trigger comparable actions.
It ignores most other options of cdrecord and cdrskin but refuses It ignores most other options of cdrecord and cdrskin but refuses
on -audio, -scanbus, and on blanking modes unknown to 'xorriso'. on -audio, -scanbus, and on blanking modes unknown to 'xorriso'.
The scope is only a single data track per session to be written to The scope is only a single data track per session to be written to
blank, overwriteable, or appendable media. The medium gets closed blank, overwritable, or appendable media. The medium gets closed
if closing is applicable and not option -multi is present. if closing is applicable and not option -multi is present.
If an input drive was acquired, then it is given up. This is only If an input drive was acquired, then it is given up. This is only
allowed if no image changes are pending. allowed if no image changes are pending.
@ -4279,7 +4278,7 @@ said programs trigger comparable actions.
If a track source is given, then an automatic -commit happens at If a track source is given, then an automatic -commit happens at
the end of the "cdrecord" option list. the end of the "cdrecord" option list.
--grow_overwriteable_iso enables emulation of multi-session on --grow_overwriteable_iso enables emulation of multi-session on
overwriteable media. To enable emulation of a TOC, the first overwritable media. To enable emulation of a TOC, the first
session needs -C 0,32 with -as mkisofs (but no -M) and session needs -C 0,32 with -as mkisofs (but no -M) and
--grow_overwriteable_iso write_start_address=32s with -as cdrecord. --grow_overwriteable_iso write_start_address=32s with -as cdrecord.
@ -4950,7 +4949,7 @@ xorriso and dd.
This example works for multi-session media only. Add cdrskin option This example works for multi-session media only. Add cdrskin option
--grow_overwriteable_iso to all -as cdrecord runs in order to enable --grow_overwriteable_iso to all -as cdrecord runs in order to enable
multi-session emulation on overwriteable media. multi-session emulation on overwritable media.
 
File: xorriso.info, Node: ExGrowisofs, Next: ExException, Prev: ExMkisofs, Up: Examples File: xorriso.info, Node: ExGrowisofs, Next: ExException, Prev: ExMkisofs, Up: Examples
@ -4981,7 +4980,7 @@ but -outdev must be set to "-". So use "outdev" instead:
$ growisofs -M /dev/dvd -- outdev - -update_r /my/files /files $ growisofs -M /dev/dvd -- outdev - -update_r /my/files /files
growisofs has excellent burn capabilities with DVD and BD. It does growisofs has excellent burn capabilities with DVD and BD. It does
not emulate session history on overwriteable media, though. not emulate session history on overwritable media, though.
 
File: xorriso.info, Node: ExException, Next: ExTime, Prev: ExGrowisofs, Up: Examples File: xorriso.info, Node: ExException, Next: ExTime, Prev: ExGrowisofs, Up: Examples
@ -5075,10 +5074,10 @@ With *mount* option *-o "sbsector="* on GNU/Linux or *-s* on FreeBSD or
NetBSD it is possible to access the session trees which represent the NetBSD it is possible to access the session trees which represent the
older backup versions. With CD media, GNU/Linux mount accepts session older backup versions. With CD media, GNU/Linux mount accepts session
numbers directly by its option "session=". numbers directly by its option "session=".
Multi-session media and most overwriteable media written by 'xorriso' Multi-session media and most overwritable media written by 'xorriso' can
can tell the sbsectors of their sessions by 'xorriso' command -toc. tell the sbsectors of their sessions by 'xorriso' command -toc. Used
Used after -commit the following command prints the matching mount after -commit the following command prints the matching mount command
command for the newly written session (here for mount point /mnt): for the newly written session (here for mount point /mnt):
-mount_cmd "indev" "auto" "auto" /mnt -mount_cmd "indev" "auto" "auto" /mnt
@ -5339,7 +5338,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -chown_r sets ownership in ISO image: Manip. (line 47) * -chown_r sets ownership in ISO image: Manip. (line 47)
* -clone copies ISO directory tree: Insert. (line 185) * -clone copies ISO directory tree: Insert. (line 185)
* -close controls media closing: SetWrite. (line 401) * -close controls media closing: SetWrite. (line 401)
* -close_damaged closes damaged track and session: Writing. (line 164) * -close_damaged closes damaged track and session: Writing. (line 163)
* -close_filter_list bans filter registration: Filter. (line 50) * -close_filter_list bans filter registration: Filter. (line 50)
* -commit writes pending ISO image: Writing. (line 27) * -commit writes pending ISO image: Writing. (line 27)
* -commit_eject writes and ejects: Writing. (line 53) * -commit_eject writes and ejects: Writing. (line 53)
@ -5398,7 +5397,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -getfattr shows xattr in ISO image: Navigate. (line 69) * -getfattr shows xattr in ISO image: Navigate. (line 69)
* -getfattr_r shows xattr in ISO image: Navigate. (line 75) * -getfattr_r shows xattr in ISO image: Navigate. (line 75)
* -gid sets global ownership: SetWrite. (line 287) * -gid sets global ownership: SetWrite. (line 287)
* -grow_blindly overides next writeable address: AqDrive. (line 112) * -grow_blindly overrides next writeable address: AqDrive. (line 112)
* -hardlinks controls handling of hard links: Loading. (line 107) * -hardlinks controls handling of hard links: Loading. (line 107)
* -help prints help text: Scripting. (line 19) * -help prints help text: Scripting. (line 19)
* -hfsplus enables production of HFS+ partition: SetWrite. (line 14) * -hfsplus enables production of HFS+ partition: SetWrite. (line 14)
@ -5416,9 +5415,9 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top
* -list_arg_sorting prints sorting order of -x: ArgSort. (line 26) * -list_arg_sorting prints sorting order of -x: ArgSort. (line 26)
* -list_delimiter replaces '--': Scripting. (line 55) * -list_delimiter replaces '--': Scripting. (line 55)
* -list_extras lists compile time extra features: Scripting. (line 24) * -list_extras lists compile time extra features: Scripting. (line 24)
* -list_formats lists available formats: Writing. (line 129) * -list_formats lists available formats: Writing. (line 128)
* -list_profiles lists supported media: Writing. (line 177) * -list_profiles lists supported media: Writing. (line 176)
* -list_speeds lists available write speeds: Writing. (line 140) * -list_speeds lists available write speeds: Writing. (line 139)
* -lns creates ISO symbolic link: Insert. (line 181) * -lns creates ISO symbolic link: Insert. (line 181)
* -load addresses a particular session as input: Loading. (line 33) * -load addresses a particular session as input: Loading. (line 33)
* -local_charset sets terminal character set: Charset. (line 57) * -local_charset sets terminal character set: Charset. (line 57)
@ -5588,7 +5587,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Create, new ISO image, _definition: Methods. (line 7) * Create, new ISO image, _definition: Methods. (line 7)
* Cylinder alignment, _definition: Bootable. (line 338) * Cylinder alignment, _definition: Bootable. (line 338)
* Cylinder size, _definition: Bootable. (line 323) * Cylinder size, _definition: Bootable. (line 323)
* Damaged track and session, close, -close_damaged: Writing. (line 164) * Damaged track and session, close, -close_damaged: Writing. (line 163)
* DEC Alpha SRM boot sector, production: Bootable. (line 398) * DEC Alpha SRM boot sector, production: Bootable. (line 398)
* Delete, from ISO image, -rm: Manip. (line 20) * Delete, from ISO image, -rm: Manip. (line 20)
* Delete, from ISO image, -rm_r: Manip. (line 26) * Delete, from ISO image, -rm_r: Manip. (line 26)
@ -5614,7 +5613,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Drive, for output, -outdev: AqDrive. (line 29) * Drive, for output, -outdev: AqDrive. (line 29)
* Drive, get drive list, -devices: Inquiry. (line 7) * Drive, get drive list, -devices: Inquiry. (line 7)
* Drive, get drive list, -device_links: Inquiry. (line 17) * Drive, get drive list, -device_links: Inquiry. (line 17)
* Drive, list supported media, -list_profiles: Writing. (line 177) * Drive, list supported media, -list_profiles: Writing. (line 176)
* Drive, reduce activity, -calm_drive: Loading. (line 303) * Drive, reduce activity, -calm_drive: Loading. (line 303)
* Drive, report SCSI commands, -scsi_log: Scripting. (line 143) * Drive, report SCSI commands, -scsi_log: Scripting. (line 143)
* Drive, write and eject, -commit_eject: Writing. (line 53) * Drive, write and eject, -commit_eject: Writing. (line 53)
@ -5717,8 +5716,8 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* MD5, control handling, -md5: Loading. (line 163) * MD5, control handling, -md5: Loading. (line 163)
* Media, erase, -blank: Writing. (line 57) * Media, erase, -blank: Writing. (line 57)
* Media, format, -format: Writing. (line 87) * Media, format, -format: Writing. (line 87)
* Media, list formats, -list_formats: Writing. (line 129) * Media, list formats, -list_formats: Writing. (line 128)
* Media, list write speeds, -list_speeds: Writing. (line 140) * Media, list write speeds, -list_speeds: Writing. (line 139)
* MIPS boot file, activation: Bootable. (line 360) * MIPS boot file, activation: Bootable. (line 360)
* mkisofs, Emulation: Emulation. (line 17) * mkisofs, Emulation: Emulation. (line 17)
* Modifying, _definition: Methods. (line 28) * Modifying, _definition: Methods. (line 28)
@ -5742,7 +5741,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
* Navigate, tell ISO working directory, -pwd: Navigate. (line 19) * Navigate, tell ISO working directory, -pwd: Navigate. (line 19)
* Next writeable address, -grow_blindly: AqDrive. (line 112) * Next writeable address, -grow_blindly: AqDrive. (line 112)
* Output Character Set, _definition: Charset. (line 26) * Output Character Set, _definition: Charset. (line 26)
* Overwriteable media, _definition: Media. (line 14) * Overwritable media, _definition: Media. (line 14)
* Ownership, global in ISO image, -uid: SetWrite. (line 284) * Ownership, global in ISO image, -uid: SetWrite. (line 284)
* Ownership, in ISO image, -chown: Manip. (line 43) * Ownership, in ISO image, -chown: Manip. (line 43)
* Ownership, in ISO image, -chown_r: Manip. (line 47) * Ownership, in ISO image, -chown_r: Manip. (line 47)
@ -5865,59 +5864,59 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top
Tag Table: Tag Table:
Node: Top415 Node: Top415
Node: Overview1405 Node: Overview1405
Node: Model3442 Node: Model3441
Node: Media6346 Node: Media6344
Node: Methods9033 Node: Methods9025
Node: Drives11619 Node: Drives11611
Node: Extras15561 Node: Extras15552
Node: Processing20274 Node: Processing20264
Node: Dialog23909 Node: Dialog23899
Node: Commands25598 Node: Commands25588
Node: ArgSort27275 Node: ArgSort27265
Node: AqDrive28769 Node: AqDrive28759
Node: Loading35926 Node: Loading35916
Node: Insert55883 Node: Insert55869
Node: SetInsert67386 Node: SetInsert67372
Node: Manip76818 Node: Manip76804
Node: CmdFind86918 Node: CmdFind86904
Node: Filter105847 Node: Filter105833
Node: Writing110469 Node: Writing110455
Node: SetWrite120625 Node: SetWrite120602
Node: Bootable145384 Node: Bootable145360
Node: Jigdo172341 Node: Jigdo172315
Node: Charset176600 Node: Charset176574
Node: Exception179929 Node: Exception179903
Node: DialogCtl186058 Node: DialogCtl186032
Node: Inquiry188660 Node: Inquiry188634
Node: Navigate197544 Node: Navigate197516
Node: Verify206001 Node: Verify205973
Node: Restore216472 Node: Restore216444
Node: Emulation225149 Node: Emulation225121
Node: Scripting235608 Node: Scripting235577
Node: Frontend243391 Node: Frontend243360
Node: Examples253017 Node: Examples252986
Node: ExDevices254195 Node: ExDevices254164
Node: ExCreate254856 Node: ExCreate254825
Node: ExDialog256156 Node: ExDialog256125
Node: ExGrowing257427 Node: ExGrowing257396
Node: ExModifying258236 Node: ExModifying258205
Node: ExBootable258746 Node: ExBootable258715
Node: ExCharset259301 Node: ExCharset259270
Node: ExPseudo260197 Node: ExPseudo260166
Node: ExCdrecord261124 Node: ExCdrecord261093
Node: ExMkisofs261444 Node: ExMkisofs261413
Node: ExGrowisofs263342 Node: ExGrowisofs263310
Node: ExException264496 Node: ExException264463
Node: ExTime264954 Node: ExTime264921
Node: ExIncBackup265412 Node: ExIncBackup265379
Node: ExRestore269438 Node: ExRestore269405
Node: ExRecovery270384 Node: ExRecovery270351
Node: Files270956 Node: Files270923
Node: Environ272290 Node: Environ272257
Node: Seealso273038 Node: Seealso273005
Node: Bugreport273755 Node: Bugreport273722
Node: Legal274346 Node: Legal274313
Node: CommandIdx275358 Node: CommandIdx275325
Node: ConceptIdx292901 Node: ConceptIdx292868
 
End Tag Table End Tag Table

64
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.5.3, Oct 27, 2019" @c man .TH XORRISO 1 "Version 1.5.3, Oct 28, 2019"
@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:
@ -168,7 +168,7 @@ Can check media for damages and copy readable blocks to disk.
@* @*
Can attach MD5 checksums to each data file and the whole session. Can attach MD5 checksums to each data file and the whole session.
@* @*
Scans for optical drives, blanks re-useable optical media. Scans for optical drives, blanks re-usable optical media.
@* @*
Reads its instructions from command line arguments, dialog, and files. Reads its instructions from command line arguments, dialog, and files.
@* @*
@ -241,7 +241,7 @@ Adding a session to an existing ISO image is in this text referred as
@* @*
The multi-session model of the MMC standard does not apply to all media The multi-session model of the MMC standard does not apply to all media
types. But program growisofs by Andy Polyakov showed how to extend this types. But program growisofs by Andy Polyakov showed how to extend this
functionality to overwriteable media or disk files which carry valid ISO 9660 functionality to overwritable media or disk files which carry valid ISO 9660
filesystems. filesystems.
@c man .PP @c man .PP
@sp 1 @sp 1
@ -287,8 +287,8 @@ Similar to multi-session media are DVD-R DL and minimally blanked DVD-RW.
They record 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 Overwritable media, _definition
@strong{Overwriteable media} are DVD-RAM, DVD+RW, BD-RE, and formatted DVD-RW. @strong{Overwritable media} are DVD-RAM, DVD+RW, BD-RE, and formatted DVD-RW.
They offer 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
@ -297,7 +297,7 @@ be emulated. Else only a single overall session will be visible.
DVD-RW media can be formatted by -format "full". DVD-RW media can be formatted by -format "full".
They can be made unformatted by -blank "deformat". They can be made unformatted by -blank "deformat".
@* @*
Regular files and block devices are handled as overwriteable media. Regular files and block devices are handled as overwritable media.
Pipes and other writeable file types are handled as blank multi-session media. Pipes and other writeable file types are handled as blank multi-session media.
@c man .PP @c man .PP
@sp 1 @sp 1
@ -311,15 +311,15 @@ suitable for @command{xorriso}.
@* @*
Blank is the state of newly purchased optical media. Blank is the state of newly purchased optical media.
With used CD-RW and DVD-RW it can be achieved by action -blank "as_needed". With used CD-RW and DVD-RW it can be achieved by action -blank "as_needed".
Overwriteable media are considered blank if they are new or if they have Overwritable media are considered blank if they are new or if they have
been marked as blank by @command{xorriso}. been marked as blank by @command{xorriso}.
Action -blank "as_needed" can be used to do this marking on overwriteable Action -blank "as_needed" can be used to do this marking on overwritable
media, or to apply mandatory formatting to new media if necessary. media, or to apply mandatory formatting to new media if necessary.
@* @*
@sp 1 @sp 1
@cindex Appendable media, _definition @cindex Appendable media, _definition
@strong{Appendable} media accept further sessions. Either they are MMC @strong{Appendable} media accept further sessions. Either they are MMC
multi-session media in appendable state, or they are overwriteable media multi-session media in appendable state, or they are overwritable media
which contain an ISO image suitable for @command{xorriso}. which contain an ISO image suitable for @command{xorriso}.
@* @*
Appendable is the state after writing a session with command -close off. Appendable is the state after writing a session with command -close off.
@ -333,7 +333,7 @@ Closed is the state of DVD-ROM media and of multi-session media which were
written with command -close on. If the drive is read-only hardware then it will written with command -close on. If the drive is read-only hardware then it will
probably show any media as closed CD-ROM or DVD-ROM. probably show any media as closed CD-ROM or DVD-ROM.
@* @*
Overwriteable media assume this state in such read-only drives or if they Overwritable media assume this state in such read-only drives or if they
contain unrecognizable data in the first 32 data blocks. contain unrecognizable data in the first 32 data blocks.
@* @*
Read-only drives may or may not show session histories of multi-session Read-only drives may or may not show session histories of multi-session
@ -418,7 +418,7 @@ of modifying and blind growing. They all are suitable for newly created images.
@sp 1 @sp 1
All drive file objects have to offer rw-permission to the user of All drive file objects have to offer rw-permission to the user of
@command{xorriso}. @command{xorriso}.
Even those which will not be useable for reading an ISO image. Even those which will not be usable for reading an ISO image.
@* @*
@cindex LBA, _definition @cindex LBA, _definition
With any type of drive object, the data are considered to be organized in With any type of drive object, the data are considered to be organized in
@ -555,7 +555,7 @@ hard-disk-like media. Several options install a @strong{MBR}
intended boot firmware and the involved boot loaders, e.g. GRUB2 or ISOLINUX. intended boot firmware and the involved boot loaders, e.g. GRUB2 or ISOLINUX.
A MBR contains boot code and a partition table. A MBR contains boot code and a partition table.
The new MBR of a follow-up session can get in effect The new MBR of a follow-up session can get in effect
only on overwriteable media. only on overwritable media.
@* @*
MBR is read by PC-BIOS when booting from USB stick or hard disk, MBR is read by PC-BIOS when booting from USB stick or hard disk,
and by PowerPC CHRP or PReP when booting. and by PowerPC CHRP or PReP when booting.
@ -989,7 +989,7 @@ If you decide so, consider to put the command into a global startup file like
/etc/opt/xorriso/rc. /etc/opt/xorriso/rc.
@c man .TP @c man .TP
@item -grow_blindly "off"|predicted_nwa @item -grow_blindly "off"|predicted_nwa
@kindex -grow_blindly overides next writeable address @kindex -grow_blindly overrides next writeable address
@cindex Next writeable address, -grow_blindly @cindex Next writeable address, -grow_blindly
If predicted_nwa is a non-negative number then perform blind growing rather If predicted_nwa is a non-negative number then perform blind growing rather
than modifying if -indev and -outdev are set to different drives. than modifying if -indev and -outdev are set to different drives.
@ -1375,7 +1375,7 @@ Else just avoid names longer than 253 characters.
Read-only drives do not tell the actual media type but show any media as Read-only drives do not tell the actual media type but show any media as
ROM (e.g. as DVD-ROM). The session history of MMC multi-session media might ROM (e.g. as DVD-ROM). The session history of MMC multi-session media might
be truncated to first and last session or even be completely false. be truncated to first and last session or even be completely false.
(The emulated history of overwriteable media is not affected by this.) (The emulated history of overwritable media is not affected by this.)
@* @*
To have in case of failure a chance of getting the session history and To have in case of failure a chance of getting the session history and
especially the address of the last session, there is a scan for ISO 9660 especially the address of the last session, there is a scan for ISO 9660
@ -1389,11 +1389,11 @@ multi-session DVD or BD. If on such a system @command{xorriso} has no own MMC
capabilities then it may still find that session from a scanned table of capabilities then it may still find that session from a scanned table of
content. Setting "force" handles any media like a ROM medium with setting "on". content. Setting "force" handles any media like a ROM medium with setting "on".
@* @*
On the other hand the emulation of session history on overwriteable media On the other hand the emulation of session history on overwritable media
can hamper reading of partly damaged media. Setting "off:emul_off" disables can hamper reading of partly damaged media. Setting "off:emul_off" disables
the elsewise trustworthy table-of-content scan for those media. the elsewise trustworthy table-of-content scan for those media.
@* @*
The table-of-content scan on overwriteable media normally searches only up to The table-of-content scan on overwritable media normally searches only up to
the end of the session that is pointed to by the superblock at block 0. the end of the session that is pointed to by the superblock at block 0.
Setting "on:emul_wide" lets the scan continue up to the end of the medium. Setting "on:emul_wide" lets the scan continue up to the end of the medium.
This may be useful after copying a medium with -check_media patch_lba0=on This may be useful after copying a medium with -check_media patch_lba0=on
@ -1428,7 +1428,7 @@ effective access permissions. This implies to try opening those files for
writing, which otherwise will happen only later and only if actual writing, which otherwise will happen only later and only if actual
writing is desired. writing is desired.
@* @*
The test result is used for classifying the pseudo drives as overwriteable, The test result is used for classifying the pseudo drives as overwritable,
read-only, write-only, or uselessly empty. This may lead to earlier detection read-only, write-only, or uselessly empty. This may lead to earlier detection
of severe problems, and may avoid some less severe error events. of severe problems, and may avoid some less severe error events.
@* @*
@ -2979,16 +2979,16 @@ then this command leads to a FAILURE event.
Defined modes are: Defined modes are:
as_needed, fast, all, deformat, deformat_quickest as_needed, fast, all, deformat, deformat_quickest
@* @*
"as_needed" cares for used CD-RW, DVD-RW and for used overwriteable media "as_needed" cares for used CD-RW, DVD-RW and for used overwritable media
by applying -blank "fast". It applies -format "full" to yet unformatted by applying -blank "fast". It applies -format "full" to yet unformatted
DVD-RAM and BD-RE. Other media in blank state are gracefully ignored. DVD-RAM and BD-RE. Other media in blank state are gracefully ignored.
Media which cannot be made ready for writing from scratch cause a FAILURE Media which cannot be made ready for writing from scratch cause a FAILURE
event. event.
@* @*
"fast" makes CD-RW and unformatted DVD-RW re-usable, or invalidates "fast" makes CD-RW and unformatted DVD-RW re-usable, or invalidates
overwriteable ISO images. "all" might work more thoroughly and need more time. overwritable ISO images. "all" might work more thoroughly and need more time.
@* @*
"deformat" converts overwriteable DVD-RW into unformatted ones. "deformat" converts overwritable DVD-RW into unformatted ones.
@* @*
"deformat_quickest" is a faster way to deformat or blank DVD-RW "deformat_quickest" is a faster way to deformat or blank DVD-RW
but produces media which are only suitable for a single session. but produces media which are only suitable for a single session.
@ -3010,7 +3010,7 @@ Blanking will nevertheless only succeed if the drive is willing to do it.
@item -format mode @item -format mode
@kindex -format formats media @kindex -format formats media
@cindex Media, format, -format @cindex Media, format, -format
Convert unformatted DVD-RW into overwriteable ones, "de-ice" DVD+RW, format Convert unformatted DVD-RW into overwritable ones, "de-ice" DVD+RW, format
newly purchased BD-RE or BD-R, re-format DVD-RAM or BD-RE. newly purchased BD-RE or BD-R, re-format DVD-RAM or BD-RE.
@* @*
Defined modes are: Defined modes are:
@ -3290,7 +3290,7 @@ Default is "old_rr" which uses Rock Ridge version 1.10. This implies also
"aaip_susp_1_10" allows AAIP to be written as unofficial extension of RRIP "aaip_susp_1_10" allows AAIP to be written as unofficial extension of RRIP
rather than as official extension under SUSP-1.12. rather than as official extension under SUSP-1.12.
@* @*
"no_emul_toc" saves 64 kB with the first session on overwriteable media "no_emul_toc" saves 64 kB with the first session on overwritable media
but makes the image incapable of displaying its session history. but makes the image incapable of displaying its session history.
@* @*
"iso_9660_1999" causes the production of an additional directory tree "iso_9660_1999" causes the production of an additional directory tree
@ -3737,7 +3737,7 @@ The same effect is achieved by -padding mode "included".
@c man .PP @c man .PP
Contrary to published specifications many BIOSes will load an El Torito Contrary to published specifications many BIOSes will load an El Torito
record from the first session on media and not from the last one, which record from the first session on media and not from the last one, which
gets mounted by default. This makes no problems with overwriteable media, gets mounted by default. This makes no problems with overwritable media,
because they appear to inadverted readers as one single session. because they appear to inadverted readers as one single session.
@* @*
But with multi-session media CD-R[W], DVD-R[W], DVD+R, it implies that the But with multi-session media CD-R[W], DVD-R[W], DVD+R, it implies that the
@ -3749,7 +3749,7 @@ If a boot image from ISOLINUX or GRUB is known to be present on media then
it is advised to patch it it is advised to patch it
when a follow-up session gets written. But one should not rely on the when a follow-up session gets written. But one should not rely on the
capability to influence the bootability of the existing sessions, unless one capability to influence the bootability of the existing sessions, unless one
can assume overwriteable media. can assume overwritable media.
@* @*
Normally the boot images are data files inside the ISO filesystem. By Normally the boot images are data files inside the ISO filesystem. By
special path "--interval:appended_partition_NNN:all::" it is possible to special path "--interval:appended_partition_NNN:all::" it is possible to
@ -4798,9 +4798,9 @@ Precedence is: "dvdrw", "cdrw", "dvd", "cdrom", "cd".
Show media specific tables of content. This is the session history Show media specific tables of content. This is the session history
of the medium, not the ISO image directory tree. of the medium, not the ISO image directory tree.
@* @*
In case of overwriteable media holding a valid ISO image, it may happen that In case of overwritable media holding a valid ISO image, it may happen that
only a single session gets shown. But if the first session on the only a single session gets shown. But if the first session on the
overwriteable media was written by @command{xorriso} then a complete overwritable media was written by @command{xorriso} then a complete
session history can be emulated. session history can be emulated.
@* @*
A drive which is incapable of writing may show any media as CD-ROM or DVD-ROM A drive which is incapable of writing may show any media as CD-ROM or DVD-ROM
@ -5771,7 +5771,7 @@ same name and hardcoded parameter "on", e.g. -acl "on".
Explicit parameters are expected by @minus{}@minus{}stdio_sync Explicit parameters are expected by @minus{}@minus{}stdio_sync
and @minus{}@minus{}scdbackup_tag. and @minus{}@minus{}scdbackup_tag.
@* @*
The capability to preserve multi-session history on overwriteable media The capability to preserve multi-session history on overwritable media
gets disabled by default. It can be enabled by using @minus{}@minus{}emul-toc gets disabled by default. It can be enabled by using @minus{}@minus{}emul-toc
with the first session. See -compliance no_emul_toc. with the first session. See -compliance no_emul_toc.
@* @*
@ -5847,7 +5847,7 @@ It ignores most other options of cdrecord and cdrskin but refuses on
-audio, -scanbus, and on blanking modes unknown to @command{xorriso}. -audio, -scanbus, and on blanking modes unknown to @command{xorriso}.
@* @*
The scope is only a single data track per session to be written The scope is only a single data track per session to be written
to blank, overwriteable, or appendable media. The medium gets closed if to blank, overwritable, or appendable media. The medium gets closed if
closing is applicable and not option -multi is present. closing is applicable and not option -multi is present.
@* @*
If an input drive was acquired, then it is given up. If an input drive was acquired, then it is given up.
@ -5860,7 +5860,7 @@ If a track source is given, then an automatic -commit happens at the end of
the "cdrecord" option list. the "cdrecord" option list.
@* @*
@minus{}@minus{}grow_overwriteable_iso @minus{}@minus{}grow_overwriteable_iso
enables emulation of multi-session on overwriteable enables emulation of multi-session on overwritable
media. To enable emulation of a TOC, the first session needs -C 0,32 with media. To enable emulation of a TOC, the first session needs -C 0,32 with
-as mkisofs (but no -M) and @minus{}@minus{}grow_overwriteable_iso -as mkisofs (but no -M) and @minus{}@minus{}grow_overwriteable_iso
write_start_address=32s with -as cdrecord. write_start_address=32s with -as cdrecord.
@ -6845,7 +6845,7 @@ If this does not help, insert a run of "sleep 10" between xorriso and dd.
This example works for multi-session media only. This example works for multi-session media only.
Add cdrskin option @minus{}@minus{}grow_overwriteable_iso Add cdrskin option @minus{}@minus{}grow_overwriteable_iso
to all -as cdrecord runs to all -as cdrecord runs
in order to enable multi-session emulation on overwriteable media. in order to enable multi-session emulation on overwritable media.
@c man .SS @c man .SS
@c man .B Let xorriso work underneath growisofs @c man .B Let xorriso work underneath growisofs
@node ExGrowisofs, ExException, ExMkisofs, Examples @node ExGrowisofs, ExException, ExMkisofs, Examples
@ -6884,7 +6884,7 @@ $ growisofs -M /dev/dvd @minus{}@minus{} outdev - -update_r /my/files /files
@* @*
@sp 1 @sp 1
growisofs has excellent burn capabilities with DVD and BD. growisofs has excellent burn capabilities with DVD and BD.
It does not emulate session history on overwriteable media, though. It does not emulate session history on overwritable media, though.
@c man .SS @c man .SS
@c man .B Adjust thresholds for verbosity, exit value and program abort @c man .B Adjust thresholds for verbosity, exit value and program abort
@node ExException, ExTime, ExGrowisofs, Examples @node ExException, ExTime, ExGrowisofs, Examples
@ -7021,7 +7021,7 @@ it is possible to access the session trees which represent the older backup
versions. With CD media, GNU/Linux mount accepts session numbers directly by versions. With CD media, GNU/Linux mount accepts session numbers directly by
its option "session=". its option "session=".
@* @*
Multi-session media and most overwriteable media written by @command{xorriso} Multi-session media and most overwritable media written by @command{xorriso}
can tell the sbsectors of their sessions by @command{xorriso} command -toc. can tell the sbsectors of their sessions by @command{xorriso} command -toc.
Used after -commit the following command prints the matching mount command for Used after -commit the following command prints the matching mount command for
the newly written session (here for mount point /mnt): the newly written session (here for mount point /mnt):

2
xorriso/xorriso_eng.html
View File

@ -759,7 +759,7 @@ Many thanks to Derek Foreman and Ben Jansens for starting libburn.
Very special thanks to Andy Polyakov whose Very special thanks to Andy Polyakov whose
<A HREF="http://fy.chalmers.se/~appro/linux/DVD+RW/tools">dvd+rw-tools</A> <A HREF="http://fy.chalmers.se/~appro/linux/DVD+RW/tools">dvd+rw-tools</A>
provide the libburnia project with invaluable examples on how to deal provide the libburnia project with invaluable examples on how to deal
with DVD media and how to emulate multi-session on overwriteable media. with DVD media and how to emulate multi-session on overwritable media.
</P> </P>
<HR> <HR>

4
xorriso/xorriso_main.c
View File

@ -135,7 +135,7 @@ static void check_compatibility()
int lib_major, lib_minor, lib_micro; int lib_major, lib_minor, lib_micro;
/* First an ugly compile time check for header version compatibility. /* First an ugly compile time check for header version compatibility.
If everthing matches, then no C code is produced. In case of mismatch, If everything matches, then no C code is produced. In case of mismatch,
intentionally faulty C code will be inserted. intentionally faulty C code will be inserted.
*/ */
/* The minimum requirement of xorriso towards the libisoburn header /* The minimum requirement of xorriso towards the libisoburn header
@ -155,7 +155,7 @@ static void check_compatibility()
error: 'INTENTIONAL_ABORT_OF_COMPILATION__HEADERFILE_xorriso_dot_h_TOO_OLD__SEE_xorriso_main_dot_c' undeclared (first use in this function) error: 'INTENTIONAL_ABORT_OF_COMPILATION__HEADERFILE_xorriso_dot_h_TOO_OLD__SEE_xorriso_main_dot_c' undeclared (first use in this function)
error: 'XORRISO_MISCONFIGURATION_' undeclared (first use in this function) error: 'XORRISO_MISCONFIGURATION_' undeclared (first use in this function)
*/ */
/* The indendation is an advise of man gcc to help old compilers ignoring */ /* The indentation is an advise of man gcc to help old compilers ignoring */
#if Xorriso_req_majoR > Xorriso_header_version_majoR #if Xorriso_req_majoR > Xorriso_header_version_majoR
#define Xorriso_dot_h_too_olD 1 #define Xorriso_dot_h_too_olD 1
#endif #endif

9
xorriso/xorriso_private.h
View File

@ -175,7 +175,7 @@ struct XorrisO { /* the global context of xorriso */
bit5= with bit0: do not check tags of superblock,tree,session bit5= with bit0: do not check tags of superblock,tree,session
*/ */
int no_emul_toc; /* bit0= On overwriteables: int no_emul_toc; /* bit0= On overwritables:
write first session to LBA 0 rather than 32. write first session to LBA 0 rather than 32.
*/ */
@ -258,7 +258,7 @@ struct XorrisO { /* the global context of xorriso */
int toc_emulation_flag; /* bit0= bit3 for isoburn_drive_aquire() int toc_emulation_flag; /* bit0= bit3 for isoburn_drive_aquire()
scan -ROM profiles for ISO sessions scan -ROM profiles for ISO sessions
bit1= bit4 for isoburn_drive_aquire() bit1= bit4 for isoburn_drive_aquire()
do not emulate TOC on overwriteable media do not emulate TOC on overwritable media
bit2= bit7 for isoburn_drive_aquire() bit2= bit7 for isoburn_drive_aquire()
pretend any media to be -ROM pretend any media to be -ROM
bit3= bit9 for isoburn_drive_aquire() bit3= bit9 for isoburn_drive_aquire()
@ -425,7 +425,8 @@ struct XorrisO { /* the global context of xorriso */
int boot_image_isohybrid; /* 0=off , deprecated: 1=auto , 2=on , 3=force */ int boot_image_isohybrid; /* 0=off , deprecated: 1=auto , 2=on , 3=force */
int boot_efi_default; /* 0= no effect , int boot_efi_default; /* 0= no effect ,
1= appy --efi-boot parameters when attaching to img */ 1= apply --efi-boot parameters when attaching to img
*/
char system_area_disk_path[SfileadrL]; char system_area_disk_path[SfileadrL];
int system_area_clear_loaded; int system_area_clear_loaded;
@ -670,7 +671,7 @@ struct XorrisO { /* the global context of xorriso */
struct ExclusionS *disk_exclusions; struct ExclusionS *disk_exclusions;
int disk_excl_mode; /* bit0= on (else off) int disk_excl_mode; /* bit0= on (else off)
bit1= parameter too (else rekursion only) bit1= parameter too (else recursion only)
bit2= whole subtree banned (else only exact path) bit2= whole subtree banned (else only exact path)
bit3= when comparing ignore excluded files rather bit3= when comparing ignore excluded files rather
than to treat them as truly missing on disk than to treat them as truly missing on disk

2
xorriso/xorriso_timestamp.h
View File

@ -1 +1 @@
#define Xorriso_timestamP "2019.10.27.154326" #define Xorriso_timestamP "2019.10.28.143339"

4
xorriso/xorrisoburn.h
View File

@ -34,8 +34,8 @@ int Xorriso_detach_libraries(struct XorrisO *xorriso, int flag);
int Xorriso_create_empty_iso(struct XorrisO *xorriso, int flag); int Xorriso_create_empty_iso(struct XorrisO *xorriso, int flag);
/* @param flag bit0=aquire as isoburn input drive /* @param flag bit0=acquire as isoburn input drive
bit1=aquire as libburn output drive (as isoburn drive if bit0) bit1=acquire as libburn output drive (as isoburn drive if bit0)
@return <=0 failure , 1=success , 2=neither readable or writeable @return <=0 failure , 1=success , 2=neither readable or writeable
*/ */
int Xorriso_aquire_drive(struct XorrisO *xorriso, char *adr, char *show_adr, int Xorriso_aquire_drive(struct XorrisO *xorriso, char *adr, char *show_adr,

8
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.5.3, Oct 27, 2019" .TH XORRISOFS 1 "Version 1.5.3, Oct 28, 2019"
.\" 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:
@ -167,7 +167,7 @@ If they are missing then a new image is composed from scratch.
.TP .TP
\fB\-M\fR disk_path \fB\-M\fR disk_path
Set the path from which to load the existing ISO image directory tree Set the path from which to load the existing ISO image directory tree
on which to base the upcomming directory tree as add\-on session. on which to base the upcoming directory tree as add\-on session.
The path must lead to a random\-access readable file object. The path must lead to a random\-access readable file object.
On GNU/Linux: regular data files or block device files. On GNU/Linux: regular data files or block device files.
.br .br
@ -1737,7 +1737,7 @@ This example works for multi\-session media only:
CD\-R[W], DVD\-R[W], DVD+R, BD\-R. CD\-R[W], DVD\-R[W], DVD+R, BD\-R.
Add cdrskin option \-\-grow_overwriteable_iso Add cdrskin option \-\-grow_overwriteable_iso
to all \-as cdrecord runs to all \-as cdrecord runs
in order to enable multi\-session emulation on overwriteable media. in order to enable multi\-session emulation on overwritable media.
.br .br
The first session is written like this: The first session is written like this:
.br .br
@ -1882,7 +1882,7 @@ it is possible to access the session trees which represent the older backup
versions. With CD media, GNU/Linux mount accepts session numbers directly by versions. With CD media, GNU/Linux mount accepts session numbers directly by
its option "session=". its option "session=".
.br .br
Multi\-session media and most overwriteable media written by xorriso can tell Multi\-session media and most overwritable media written by xorriso can tell
the sbsectors of their sessions by xorriso option \-toc: the sbsectors of their sessions by xorriso option \-toc:
.br .br
$ xorriso \-dev /dev/sr0 \-toc $ xorriso \-dev /dev/sr0 \-toc

64
xorriso/xorrisofs.info
View File

@ -184,7 +184,7 @@ then a new image is composed from scratch.
-M disk_path -M disk_path
Set the path from which to load the existing ISO image directory Set the path from which to load the existing ISO image directory
tree on which to base the upcomming directory tree as add-on tree on which to base the upcoming directory tree as add-on
session. The path must lead to a random-access readable file session. The path must lead to a random-access readable file
object. On GNU/Linux: regular data files or block device files. object. On GNU/Linux: regular data files or block device files.
A special kind of pseudo disk_path has the form "/dev/fd/"number. A special kind of pseudo disk_path has the form "/dev/fd/"number.
@ -1531,8 +1531,8 @@ File: xorrisofs.info, Node: ExMkisofs, Next: ExGrowisofs, Prev: ExGraft, Up:
This example works for multi-session media only: CD-R[W], DVD-R[W], This example works for multi-session media only: CD-R[W], DVD-R[W],
DVD+R, BD-R. Add cdrskin option --grow_overwriteable_iso to all -as DVD+R, BD-R. Add cdrskin option --grow_overwriteable_iso to all -as
cdrecord runs in order to enable multi-session emulation on cdrecord runs in order to enable multi-session emulation on overwritable
overwriteable media. media.
The first session is written like this: The first session is written like this:
$ xorrisofs -graft-points \ $ xorrisofs -graft-points \
@ -1650,7 +1650,7 @@ MD5 sums against the current file content on hard disk.
or NetBSD it is possible to access the session trees which represent the or NetBSD it is possible to access the session trees which represent the
older backup versions. With CD media, GNU/Linux mount accepts session older backup versions. With CD media, GNU/Linux mount accepts session
numbers directly by its option "session=". numbers directly by its option "session=".
Multi-session media and most overwriteable media written by xorriso can Multi-session media and most overwritable media written by xorriso can
tell the sbsectors of their sessions by xorriso option -toc: tell the sbsectors of their sessions by xorriso option -toc:
$ xorriso -dev /dev/sr0 -toc $ xorriso -dev /dev/sr0 -toc
@ -2017,11 +2017,11 @@ File: xorrisofs.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: T
* -chrp-boot CHRP partition: SystemArea. (line 267) * -chrp-boot CHRP partition: SystemArea. (line 267)
* -chrp-boot-part CHRP partition: SystemArea. (line 258) * -chrp-boot-part CHRP partition: SystemArea. (line 258)
* -copyright set Copyright File path: ImageId. (line 66) * -copyright set Copyright File path: ImageId. (line 66)
* -D allow deep directory hierachies: SetExtras. (line 60) * -D allow deep directory hierarchies: SetExtras. (line 60)
* -d omit trailing dot in ISO file names: SetCompl. (line 50) * -d omit trailing dot in ISO file names: SetCompl. (line 50)
* -dev set path for loading existing ISO image: Loading. (line 23) * -dev set path for loading existing ISO image: Loading. (line 23)
* -dir-mode permissions for all directories: SetProduct. (line 87) * -dir-mode permissions for all directories: SetProduct. (line 87)
* -disable-deep-relocation allow deep directory hierachies: SetExtras. * -disable-deep-relocation allow deep directory hierarchies: SetExtras.
(line 72) (line 72)
* -disallow_dir_id_ext enforce ISO level 1 directory names: SetCompl. * -disallow_dir_id_ext enforce ISO level 1 directory names: SetCompl.
(line 23) (line 23)
@ -2408,31 +2408,31 @@ Node: Insert3770
Node: Xorriso5616 Node: Xorriso5616
Node: Options6762 Node: Options6762
Node: Loading7489 Node: Loading7489
Node: SetInsert9531 Node: SetInsert9530
Node: SetProduct13940 Node: SetProduct13939
Node: SetCompl19511 Node: SetCompl19510
Node: SetExtras22103 Node: SetExtras22102
Node: SetHide33398 Node: SetHide33397
Node: ImageId34702 Node: ImageId34701
Node: Bootable38984 Node: Bootable38983
Node: SystemArea45270 Node: SystemArea45269
Node: Charset63502 Node: Charset63501
Node: Jigdo64527 Node: Jigdo64526
Node: Miscellaneous68804 Node: Miscellaneous68803
Node: Examples70449 Node: Examples70448
Node: ExSimple70943 Node: ExSimple70942
Node: ExGraft71426 Node: ExGraft71425
Node: ExMkisofs72726 Node: ExMkisofs72725
Node: ExGrowisofs74535 Node: ExGrowisofs74533
Node: ExIncBackup75725 Node: ExIncBackup75723
Node: ExIncBckAcc78902 Node: ExIncBckAcc78899
Node: ExBootable80607 Node: ExBootable80604
Node: Files84789 Node: Files84786
Node: Environ85884 Node: Environ85881
Node: Seealso86757 Node: Seealso86754
Node: Bugreport87408 Node: Bugreport87405
Node: Legal88001 Node: Legal87998
Node: CommandIdx88898 Node: CommandIdx88895
Node: ConceptIdx104765 Node: ConceptIdx104763
 
End Tag Table End Tag Table

12
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.5.3, Oct 27, 2019" @c man .TH XORRISOFS 1 "Version 1.5.3, Oct 28, 2019"
@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:
@ -294,7 +294,7 @@ If they are missing then a new image is composed from scratch.
@kindex -M set path for loading existing ISO image @kindex -M set path for loading existing ISO image
@cindex Session, select path, -M, -prev-session, -dev @cindex Session, select path, -M, -prev-session, -dev
Set the path from which to load the existing ISO image directory tree Set the path from which to load the existing ISO image directory tree
on which to base the upcomming directory tree as add-on session. on which to base the upcoming directory tree as add-on session.
The path must lead to a random-access readable file object. The path must lead to a random-access readable file object.
On GNU/Linux: regular data files or block device files. On GNU/Linux: regular data files or block device files.
@* @*
@ -844,7 +844,7 @@ If you expect such names in or under disk_paths and plan to mount the ISO
by such Linux kernels, consider to set -file_name_limit 253. by such Linux kernels, consider to set -file_name_limit 253.
@c man .TP @c man .TP
@item -D @item -D
@kindex -D allow deep directory hierachies @kindex -D allow deep directory hierarchies
@cindex Deep directories, allow, -D, -disable-deep-relocation @cindex Deep directories, allow, -D, -disable-deep-relocation
The standard ECMA-119 demands that no path in the image shall have more The standard ECMA-119 demands that no path in the image shall have more
than 8 name components or 255 characters. Therefore it would be necessary than 8 name components or 255 characters. Therefore it would be necessary
@ -860,7 +860,7 @@ 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
@kindex -disable-deep-relocation allow deep directory hierachies @kindex -disable-deep-relocation allow deep directory hierarchies
Alias of -D. Alias of -D.
@c man .TP @c man .TP
@item -rr_reloc_dir name @item -rr_reloc_dir name
@ -2292,7 +2292,7 @@ This example works for multi-session media only:
CD-R[W], DVD-R[W], DVD+R, BD-R. CD-R[W], DVD-R[W], DVD+R, BD-R.
Add cdrskin option @minus{}@minus{}grow_overwriteable_iso Add cdrskin option @minus{}@minus{}grow_overwriteable_iso
to all -as cdrecord runs to all -as cdrecord runs
in order to enable multi-session emulation on overwriteable media. in order to enable multi-session emulation on overwritable media.
@* @*
The first session is written like this: The first session is written like this:
@* @*
@ -2456,7 +2456,7 @@ it is possible to access the session trees which represent the older backup
versions. With CD media, GNU/Linux mount accepts session numbers directly by versions. With CD media, GNU/Linux mount accepts session numbers directly by
its option "session=". its option "session=".
@* @*
Multi-session media and most overwriteable media written by xorriso can tell Multi-session media and most overwritable media written by xorriso can tell
the sbsectors of their sessions by xorriso option -toc: the sbsectors of their sessions by xorriso option -toc:
@* @*
@sp 1 @sp 1