Replaced several occurences of the word "media" by "medium"

This commit is contained in:
Thomas Schmitt 2011-11-02 14:09:45 +00:00
parent 46b7c643f0
commit f6d0a17b90
5 changed files with 59 additions and 57 deletions

View File

@ -332,7 +332,7 @@ int isoburn_is_intermediate_dvd_rw(struct burn_drive *d, int flag)
}
/** Examines the media and sets appropriate emulation if needed.
/** Examines the medium and sets appropriate emulation if needed.
@param flag bit0= pretent blank on overwriteable media
bit3= if the drive reports a -ROM profile then try to read
table of content by scanning for ISO image headers.
@ -366,7 +366,7 @@ static int isoburn_welcome_media(struct isoburn **o, struct burn_drive *d,
if(ret<=0)
profile= 0x00;
ret= burn_disc_get_multi_caps(d, BURN_WRITE_NONE, &caps, 0);
if(ret<0) /* == 0 is read-only media, but it is too early to reject it here */
if(ret<0) /*== 0 is read-only medium, but it is too early to reject it here */
goto ex;
if(ret==0 || (flag & 128))
readonly= 1;
@ -428,13 +428,13 @@ static int isoburn_welcome_media(struct isoburn **o, struct burn_drive *d,
*/
(*o)->fabricated_disc_status= BURN_DISC_FULL;
/* This might be overwriteable media in a -ROM drive.
/* This might be an overwriteable medium in a -ROM drive.
Pitfall:
Multi-session media which bear a xorriso image for overwriteables
in their first session would get a TOC of that first image rather
than of the media.
than of the medium.
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 media
BD-R with an image for overwriteables. But as soon as the medium
bears 2 logical tracks it cannot be overwriteable.
So count the number of tracks first.
*/
@ -450,7 +450,7 @@ static int isoburn_welcome_media(struct isoburn **o, struct burn_drive *d,
isoburn_toc_disc_free(disc);
}
sprintf(msg, "ROM media has libburn track count = %d", track_count);
sprintf(msg, "ROM medium has libburn track count = %d", track_count);
isoburn_msgs_submit(*o, 0x00060000, msg, 0, "DEBUG", 0);
if((flag & 16) || track_count >= 2) {
@ -605,8 +605,8 @@ ex:
}
/** Retrieve media emulation and eventual isoburn emulator of drive.
@return -1 unsuitable media, 0 generic media, 1 emulated media.
/** Retrieve medium emulation and eventual isoburn emulator of drive.
@return -1 unsuitable medium, 0 generic medium, 1 emulated medium.
*/
int isoburn_find_emulator(struct isoburn **pt,
struct burn_drive *drive, int flag)
@ -618,7 +618,7 @@ int isoburn_find_emulator(struct isoburn **pt,
return(0);
if((*pt)->emulation_mode==-1) {
isoburn_msgs_submit(*pt, 0x00060000,
"Unsuitable drive and media state", 0, "FAILURE", 0);
"Unsuitable drive and medium state", 0, "FAILURE", 0);
return(-1);
}
if((*pt)->emulation_mode==0)
@ -764,7 +764,7 @@ int isoburn_disc_get_msc1(struct burn_drive *d, int *start_lba)
if(isoburn_disc_get_status(d)!=BURN_DISC_APPENDABLE &&
isoburn_disc_get_status(d)!=BURN_DISC_FULL) {
isoburn_msgs_submit(NULL, 0x00060000,
"Media contains no recognizable data", 0, "SORRY", 0);
"Medium contains no recognizable data", 0, "SORRY", 0);
return(0);
}
ret= isoburn_find_emulator(&o, d, 0);
@ -1346,7 +1346,7 @@ int isoburn_emulate_toc(struct burn_drive *d, int flag)
if(msg == NULL || size_text == NULL)
{ret= -1; goto ex;}
/* is the media emulated multi-session ? */
/* is the medium emulated multi-session ? */
ret= isoburn_find_emulator(&o, d, 0);
if(ret<0)
{ret= -1; goto ex;}
@ -1378,7 +1378,7 @@ int isoburn_emulate_toc(struct burn_drive *d, int flag)
with_enclosure= 1;
if((flag & 16) && o->emulation_mode == 1) {
ret= 1;
goto failure; /* This will represent the media as single session */
goto failure; /* This will represent the medium as single session */
}
}
while(lba<image_size || (flag&2)) {
@ -1574,7 +1574,7 @@ struct isoburn_toc_disc *isoburn_toc_drive_get_disc(struct burn_drive *d)
toc_disc->track_count= 0;
toc_disc->toc= NULL;
/* is the media emulated multi-session ? */
/* is the medium emulated multi-session ? */
ret= isoburn_find_emulator(&o, d, 0);
if(ret<0)
goto libburn;

View File

@ -69,9 +69,9 @@ struct isoburn {
Most isoburn calls will use a burn_drive as object handle */
struct burn_drive *drive;
/* -1= inappropriate media state detected
0= libburn multi-session media, resp. undecided yet
1= random access media */
/* -1= inappropriate medium state detected
0= libburn multi-session medium, resp. undecided yet
1= random access medium */
int emulation_mode;
/* Although rarely used, libburn can operate on several
@ -215,7 +215,7 @@ int isoburn_invalidate_iso(struct isoburn *o, int flag);
with no emulation activated by isoburn.
@param drive The drive to be searched for
@param flag unused yet
@return -1 unsuitable media, 0 generic media, 1 emulated media.
@return -1 unsuitable medium, 0 generic medium, 1 emulated medium.
*/
int isoburn_find_emulator(struct isoburn **pt,
struct burn_drive *drive, int flag);
@ -227,7 +227,7 @@ int isoburn_msgs_submit(struct isoburn *o, int error_code, char msg_text[],
int os_errno, char severity[], int flag);
/** Set the start address for an emulated add-on session. The value will
be rounded up to the alignment necessary for the media. The aligned
be rounded up to the alignment necessary for the medium. The aligned
value will be divided by 2048 and then put into o->nwa .
@param o The isoburn object to be programmed.
@param value The start address in bytes
@ -543,7 +543,7 @@ struct isoburn_imgen_opts {
int fifo_size;
/** Output value: Block address of session start as evaluated from media
/** Output value: Block address of session start as evaluated from medium
and other options by libisoburn and libburn.
If <0 : Invalid
If >=0: Valid block number. Block size is always 2 KiB.
@ -652,7 +652,7 @@ struct isoburn_imgen_opts {
Libisoburn_nwa_alignemenT it should be possible to predict the start
of the next session header.
The LBA 0 header is written by isoburn_activate_session() already
with the first session. So the media is mountable.
with the first session. So the medium is mountable.
A problem arises with DVD-RW in Intermediate State. They cannot be
written by random access before they were written sequentially.
In this case, no copy of the session 1 header is maintained and no TOC

View File

@ -492,7 +492,7 @@ int isoburn_start_emulation(struct isoburn *o, int flag)
ret = burn_get_read_capacity(drive, &capacity, 0);
if (ret <= 0)
capacity = -1;
if (role == 5) { /* random access write-only media */
if (role == 5) { /* random access write-only medium */
s = burn_disc_get_status(drive);
o->fabricated_disc_status= s;
burn_disc_track_lba_nwa(drive, NULL, 0, &dummy, &(o->nwa));
@ -524,7 +524,7 @@ int isoburn_start_emulation(struct isoburn *o, int flag)
{ret= 1; goto ex;}
}
} else {
/* No read capacity means blank media */
/* No read capacity means blank medium */
if(!(flag & 1))
o->fabricated_disc_status= BURN_DISC_BLANK;
{ret= 1; goto ex;}
@ -587,9 +587,9 @@ ex:;
}
/** Alters and writes the first 64 kB of a "media" to invalidate
/** Alters and writes the first 64 kB of a "medium" to invalidate
an ISO image. (It shall stay restorable by skilled humans, though).
The result shall especially keep libisoburn from accepting the media
The result shall especially keep libisoburn from accepting the medium
image as ISO filesystem.
@param o A fully activated isoburn object. isoburn_start_emulation()
was already called.

View File

@ -10,7 +10,7 @@
/** Overview
libisoburn is a frontend for libraries libburn and libisofs which enables
creation and expansion of ISO-9660 filesystems on all CD/DVD media supported
creation and expansion of ISO-9660 filesystems on all CD/DVD/BD media supported
by libburn. This includes media like DVD+RW, which do not support multi-session
management on media level and even plain disk files or block devices.
@ -101,7 +101,7 @@ To prepare for such an image generation run, use isoburn_prepare_new_image().
Blind Growing:
This method reads the old image from one drive and writes the add-on session
to a different drive. That output drive is nevertheless supposed to
finally lead to the same media from where the session was loaded. Usually it
finally lead to the same medium from where the session was loaded. Usually it
will be stdio:/dev/fd/1 (i.e. stdout) being piped into some burn program
like with this classic gesture:
mkisofs -M $dev -C $msc1,$nwa | cdrecord -waiti dev=$dev
@ -472,7 +472,7 @@ int isoburn_drive_set_msgs_submit(struct burn_drive *d,
void *submit_handle, int submit_flag, int flag);
/** Inquire the media status. Expect the whole spectrum of libburn BURN_DISC_*
/** Inquire the medium status. Expect the whole spectrum of libburn BURN_DISC_*
with multi-session media. Emulated states with random access media are
BURN_DISC_BLANK and BURN_DISC_APPENDABLE.
Wrapper for: burn_disc_get_status()
@ -488,7 +488,7 @@ enum burn_disc_status isoburn_disc_get_status(struct burn_drive *drive);
#endif
/** Tells whether the media can be treated by isoburn_disc_erase().
/** Tells whether the medium can be treated by isoburn_disc_erase().
Wrapper for: burn_disc_erasable()
@since 0.1.0
@param d The drive to inquire.
@ -497,13 +497,13 @@ enum burn_disc_status isoburn_disc_get_status(struct burn_drive *drive);
int isoburn_disc_erasable(struct burn_drive *d);
/** Mark the media as blank. With multi-session media this will call
/** Mark the medium as blank. With multi-session media this will call
burn_disc_erase(). With random access media, an eventual ISO-9660
filesystem will get invalidated by altering its start blocks on media.
In case of success, the media is in status BURN_DISC_BLANK afterwards.
filesystem will get invalidated by altering its start blocks on the medium.
In case of success, the medium is in status BURN_DISC_BLANK afterwards.
Wrapper for: burn_disc_erase()
@since 0.1.0
@param drive The drive with the media to erase.
@param drive The drive with the medium to erase.
@param fast 1=fast erase, 0=thorough erase
With DVD-RW, fast erase yields media incapable of multi-session.
*/
@ -574,7 +574,7 @@ struct isoburn_toc_track;
isoburn_toc_disc_free() when no longer needed.
Wrapper for: burn_drive_get_disc()
@since 0.1.6
@param d The drive with the media to inspect
@param d The drive with the medium to inspect
@return NULL in case there is no content info, else it is a valid handle
*/
struct isoburn_toc_disc *isoburn_toc_drive_get_disc(struct burn_drive *d);
@ -584,7 +584,7 @@ struct isoburn_toc_disc *isoburn_toc_drive_get_disc(struct burn_drive *d);
This number includes the eventual gaps between sessions and tracks.
So this call is not really a wrapper for burn_disc_get_sectors().
@since 0.1.6
@param disc The master handle of the media
@param disc The master handle of the medium
@return Number of blocks, <=0 indicates unknown or unreadable state
*/
int isoburn_toc_disc_get_sectors(struct isoburn_toc_disc *disc);
@ -593,7 +593,7 @@ int isoburn_toc_disc_get_sectors(struct isoburn_toc_disc *disc);
/** Get the array of session handles from the table of content.
Wrapper for: burn_disc_get_sessions()
@since 0.1.6
@param disc The master handle of the media
@param disc The master handle of the medium
@param num returns the number of sessions in the array
@return the address of the array of session handles
*/
@ -663,11 +663,11 @@ int isoburn_toc_track_get_emul(struct isoburn_toc_track *t, int *start_lba,
/** Release the memory associated with a master handle of media.
/** Release the memory associated with a master handle of a medium.
The handle is invalid afterwards and may not be used any more.
Wrapper for: burn_disc_free()
@since 0.1.6
@param disc The master handle of the media
@param disc The master handle of the medium
*/
void isoburn_toc_disc_free(struct isoburn_toc_disc *disc);
@ -676,7 +676,7 @@ void isoburn_toc_disc_free(struct isoburn_toc_disc *disc);
image header and obtain its alleged size. Depending on the info mode
one other string of text information can be retrieved too.
@since 0.1.6
@param d The drive with the media to inspect
@param d The drive with the medium to inspect
@param lba The block number from where to read
@param image_blocks Returns the number of 2048 bytes blocks in the session
@param info Caller provided memory, enough to take eventual info reply
@ -686,7 +686,8 @@ void isoburn_toc_disc_free(struct isoburn_toc_disc *disc);
2= @since 0.2.2 :
copy 64 kB header to info (needs 65536 bytes)
bit13= @since 0.2.2:
do not read head from media but use first 64 kB from info
do not read head from medium but use first 64 kB from
info
bit14= check both half buffers (not only second)
return 2 if found in first block
bit15= return -1 on read error
@ -1292,11 +1293,11 @@ int isoburn_igopt_get_fifo_size(struct isoburn_imgen_opts *o, int *fifo_size);
/** Obtain after image preparation the block address where the session will
start on media.
start on the medium.
This value cannot be set by the application but only be inquired.
@since 0.1.4
@param o The option set to work on
@param lba The block number of the session start on media.
@param lba The block number of the session start on the medium.
<0 means that no address has been determined yet.
@return 1 success, <=0 failure
*/
@ -1310,7 +1311,7 @@ int isoburn_igopt_get_effective_lba(struct isoburn_imgen_opts *o, int *lba);
This value cannot be set by the application but only be inquired.
@since 0.3.6
@param o The option set to work on
@param lba The block number of the session start on media.
@param lba The block number of the session start on the medium.
<0 means that no address has been determined yet.
@return 1 success, <=0 failure
*/
@ -1621,7 +1622,7 @@ int isoburn_igopt_get_disc_label(struct isoburn_imgen_opts *opts,
IsoImage *isoburn_get_attached_image(struct burn_drive *d);
/** Load the ISO filesystem directory tree from the media in the given drive.
/** Load the ISO filesystem directory tree from the medium in the given drive.
This will give libisoburn the base on which it can let libisofs perform
image growing or image modification. The loaded volset gets attached
to the drive object and handed out to the application.
@ -1689,7 +1690,7 @@ int isoburn_get_img_partition_offset(struct burn_drive *drive,
/** Set the IsoImage to be used with a drive. This eventually releases
the reference to the old IsoImage attached to the drive.
Caution: Use with care. It hardly makes sense to replace an image that
reflects a valid ISO image on media.
reflects a valid ISO image on the medium.
This call is rather intended for writing a newly created and populated
image to blank media. The use case in xorriso is to let an image survive
the change or demise of the outdev target drive.
@ -1706,7 +1707,7 @@ int isoburn_attach_image(struct burn_drive *d, IsoImage *image);
/** Return the best possible estimation of the currently available capacity of
the media. This might depend on particular write option settings and on
the medium. This might depend on particular write option settings and on
drive state.
An eventual start address for emulated multi-session will be subtracted
from the capacity estimation given by burn_disc_available_space().
@ -1721,7 +1722,7 @@ off_t isoburn_disc_available_space(struct burn_drive *d,
struct burn_write_opts *o);
/** Obtain the start block number of the most recent session on media. In
/** Obtain the start block number of the most recent session on the medium. In
case of random access media this will normally be 0. Successfull return is
not a guarantee that there is a ISO-9660 image at all. The call will fail,
nevertheless,if isoburn_disc_get_status() returns not BURN_DISC_APPENDABLE
@ -1757,7 +1758,7 @@ int isoburn_disc_track_lba_nwa(struct burn_drive *d, struct burn_write_opts *o,
overwriteable media. This value is supposed to be <= 2048 * nwa as of
isoburn_disc_track_lba_nwa().
@since 0.1.0
@param d The drive holding the media.
@param d The drive holding the medium.
@param start_byte The reply value counted in bytes, not in sectors.
@param flag Unused yet. Submit 0.
@return 1=stat_byte is valid, 0=not an emulated appendable, -1=error
@ -1768,7 +1769,7 @@ int isoburn_get_min_start_byte(struct burn_drive *d, off_t *start_byte,
/** To choose the expansion method of Growing:
Create a disc object for writing the new session from the created or loaded
iso_volset which has been manipulated via libisofs, to the same media from
iso_volset which has been manipulated via libisofs, to the same medium from
where the image was eventually loaded. This struct burn_disc is ready for
use by a subsequent call to isoburn_disc_write().
After this asynchronous writing has ended and the drive is BURN_DRIVE_IDLE
@ -1787,7 +1788,7 @@ int isoburn_prepare_disc(struct burn_drive *drive, struct burn_disc **disc,
/** To choose the expansion method of Modifying:
Create a disc object for producing a new image from a previous image
plus the changes made by user. The generated burn_disc is suitable
to be written to a grabbed drive with blank writeable media.
to be written to a grabbed drive with blank writeable medium.
But you must not use the same drive for input and output, because data
will be read from the source drive while at the same time the target
drive is already writing.
@ -1798,7 +1799,8 @@ int isoburn_prepare_disc(struct burn_drive *drive, struct burn_disc **disc,
@param in_drive The input drive, grabbed with isoburn_drive_aquire() or
one of its alternatives.
@param disc Returns the newly created burn_disc object.
@param opts Options for image generation and data transport to media.
@param opts Options for image generation and data transport to the
medium.
@param out_drive The output drive, from isoburn_drive_aquire() et.al..
@return <=0 error , 1 = success
*/
@ -1818,9 +1820,9 @@ int isoburn_prepare_new_image(struct burn_drive *in_drive,
Parameter translation into libisoburn:
$dev is the address by which parameter in_drive of this call was aquired
$msc1 was set by isoburn_set_msc1() before image reading
or was detected from the in_drive media
or was detected from the in_drive medium
$nwa is a parameter of this call
or can be used as detected from the in_drive media
or can be used as detected from the in_drive medium
This call waits for libisofs output to become available and then detaches
the input drive object from the data source object by which libisofs was
@ -1841,10 +1843,10 @@ int isoburn_prepare_new_image(struct burn_drive *in_drive,
@param out_drive The output drive, from isoburn_drive_aquire() et.al..
typically stdio:/dev/fd/1 .
@param nwa The address (2048 byte block count) where the add-on
session will be finally stored on a mountable media
session will be finally stored on a mountable medium
or in a mountable file.
If nwa is -1 then the address is used as determined from
the in_drive media.
the in_drive medium.
@return <=0 error , 1 = success
*/
int isoburn_prepare_blind_grow(struct burn_drive *in_drive,
@ -1970,7 +1972,7 @@ int isoburn_sync_after_write(struct burn_drive *input_drive,
Wrapper for: burn_drive_release()
@since 0.1.0
@param drive The drive to be released
@param eject 1= eject media from drive , 0= do not eject
@param eject 1= eject medium from drive , 0= do not eject
*/
void isoburn_drive_release(struct burn_drive *drive, int eject);
@ -1988,7 +1990,7 @@ void isoburn_finish(void);
*/
/** Inquire wether the media needs emulation or would be suitable for
/** Inquire wether the medium needs emulation or would be suitable for
generic multi-session via libburn.
@since 0.1.0
@param d The drive to inquire

View File

@ -1 +1 @@
#define Xorriso_timestamP "2011.10.26.085213"
#define Xorriso_timestamP "2011.11.02.140829"