libcdio.git - libcdio

diff --git a/doc/glossary.texi b/doc/glossary.texi
index d3ea8f30..5c642f35 100644
--- a/doc/glossary.texi
+++ b/doc/glossary.texi

@@ -1,5 +1,5 @@

Thomas Schmitt has made significant contributions to this glossary.

-See also @uref{http://www.dvdrhelp.com/glossary}.

+See also @uref{https://www.videohelp.com/glossary}.

@table @dfn

@@ -100,10 +100,10 @@ CD Text is a technology developed by Sony Corporation and Philips

Electronics in 1996 that allows storing in an audio CD and its tracks

information such as artist name, title, songwriter, composer, or

arranger. Commercially available audio CDs sometimes contain CD Text

-information.

+information.

Information on how CD Text is stored can be found in in older MMC

-standards. Specifically, try ``Annex J'' of ``mmc3r10g.pdf''.

+standards. Specifically, try ``Annex J'' of ``mmc3r10g.pdf''.

An ``Unofficial CD Text FAQ'' is at

@url{http://web.ncf.ca/aa571/cdtext.htm}

@@ -127,7 +127,7 @@ The data written on a CD-XA is consistent with and can be in ISO-9660

file system format and therefore be readable by ISO-9660 file system

translators. But also a CD-I player can read CD-XA discs even if

its own `Green Book' file system only resembles ISO 9660 and isn't

-fully compatible.

+fully compatible.

@item DVD

@cindex DVD

@@ -153,20 +153,20 @@ a SCSI Command Descriptor Block (CDB).

@item ECMA-119 (ISO-9660)

@cindex ECMA-119

-(@uref{http://www.ecma-international.org/publications/standards/Ecma-119.htm}

+@uref{http://www.ecma-international.org/publications/standards/Ecma-119.htm}

is a freely available specification which is technically identical to ISO 9660.

@item ECMA-167 (UDF)

@cindex ECMA-167

-(@uref{http://www.ecma-international.org/publications/standards/Ecma-167.htm}

+@uref{http://www.ecma-international.org/publications/standards/Ecma-167.htm}

is a freely available specification which is also approved as ISO 13346.

It serves as base for UDF.

@item ECMA-168

@cindex ECMA-168

-(@uref{http://www.ecma-international.org/publications/standards/Ecma-168.htm}

+@uref{http://www.ecma-international.org/publications/standards/Ecma-168.htm}

is a freely available specification which is also approved as ISO 13490.

@item FSF

@@ -188,13 +188,13 @@ but offers slightly less in terms of performance.

@item ISO

@cindex ISO

-International Standards Organization.

+International Standards Organization.

@item ISO 13346

@cindex ISO 13346

ISO 13346 / ECMA-167 is a filesystem framework for data exchange on

-overwriteable or pseudo-overwriteable media. It serves as base of UDF.

+overwriteable or pseudo-overwritable media. It serves as base of UDF.

@item ISO 13490

@cindex ISO 13490

@@ -282,7 +282,7 @@ called a UPC. Another identification number is ISRC.

@item @anchor{MMC}MMC

@cindex MMC (Multimedia Commands)

-MMC (Multimedia Commands).

+MMC (Multimedia Commands).

MMC are raw commands for communicating with CDROM drives,

CD-Rewriters, DVD-Rewriters, etc. The are subset of the larger SCSI

@@ -293,8 +293,8 @@ ATAPI versions of their drives.

The documents @code{libcdio} makes use of are described in the

Multi-Media Commands standard (MMC). This document generally has a

-numeric level number appended. For example MMC-5 refers to

-``Multi-Media Commands - 5.

+numeric level number appended. For example MMC-6 refers to

+``Multi-Media Commands - 6.

@item @anchor{models-profiles}Media models and profiles

@cindex Media models and profiles

@@ -348,9 +348,9 @@ They can assume three states:

@item "Closed" is only readable

@end table

CD-RW and DVD-RW can be brought back to blank state,

-or they can be formatted to become overwriteable.

+or they can be formatted to become overwritable.

-Overwriteable profiles allow random read-write access with a

+Overwritable profiles allow random read-write access with a

granularity of 2 kB or 32 kB.

One can hope for having read-write access via the normal

POSIX operations lseek(), read(), write() of the operating system.

@@ -371,10 +371,10 @@ priced Blu-ray burners as of year 2010.

A Mixed Mode is a CD that contains tracks of differing CD-ROM Mode

formats. In particular the first track may contain both computer data

(Yellow Book) CD ROM data while the remaining tracks are audio or

-video data. Video CD's can be Mixed Mode CDs.

+video data. Video CD's can be Mixed Mode CDs.

-@item Multisession

-@cindex Multisession

+@item Multisession

+@cindex Multisession

A way of writing to a CD , DVD or Blu-ray Disc that allows more data to be

added to readable discs at a later time. The media must not have been closed

@@ -401,7 +401,7 @@ ISO 9660 image at block 32 so that its descriptors get not overwritten later.

A proprietary CD image file format use by a popular program for

Microsoft Windows, Ahead Nero. The specification of this format is

-not to our knowledge published.

+not to our knowledge published.

@item Rock Ridge Extensions

@cindex Rock Ridge extensions

@@ -413,8 +413,8 @@ file. Rock Ridge is described by unapproved standard IEEE P1282 / RRIP-1.12

and based on unapproved IEEE P1281 / SUSP-1.10. It has become a de-facto

standard on X/Open systems like GNU/Linux, FreeBSD, Solaris, et.\ al.

-@item @anchor{SCSI}SCSI

-@cindex SCSI

+@item @anchor{SCSI}SCSI

+@cindex SCSI

Small Computer System Interface. A set of ANSI standard electronic

interfaces (originally developed at Apple Computer) that allow

@@ -432,16 +432,16 @@ organization @url{http://www.t10.org/}.

The documents @code{libcdio} makes use of are described in SCSI

standards documents SCSI Primary Commands (SPC), SCSI Block Commands

(SBC), and Multi-Media Commands (MMC). These documents generally have

-a numeric level number appended. For example SPC-3 refers to

+a numeric level number appended. For example SPC-3 refers to

``SCSI Primary Commands - 3'.

-In year 2010 the current versions were SPC-3, SBC-2, MMC-5.

+In year 2025, the current versions were SPC-7 (@url{https://www.t10.org/members/w_spc7.htm}), SBC-5 (@url{https://www.t10.org/members/w_sbc5.htm}), MMC-6 (@url{https://t10.org/members/w_mmc6.htm}).

@item SCSI CDB

@cindex SCSI CDB

SCSI Command Descriptor Block. The data structure that is used to

-issue a SCSI command.

+issue a SCSI command.

@item SCSI Pass Through Interface.

@cindex SCSI Pass Through Interface.

@@ -460,7 +460,7 @@ data sessions.

@item SVCD

@cindex Super VCD (SVCD)

-Super @acronym{VCD}

+Super @acronym{VCD}

An improvement of Video CD 2.0 specification which includes most

notably a switch from @acronym{MPEG}-1 (constant bit rate encoding) to

@@ -471,7 +471,7 @@ graphics and text (@dfn{OGT}) sub-channels for user switchable

subtitle displaying, closed caption text, and command lists for

controlling the @acronym{SVCD} virtual machine.

-See @uref{http://www.dvdrhelp.com/svcd}

+See @uref{https://www.videohelp.com/glossary?S#SVCD}

@item TOC

@cindex TOC (CD Table of Contents)

@@ -484,7 +484,7 @@ block address, size, copy protection, linear audio preemphasis, track format

Session and track information is also available on sequential DVD and

Blu-ray Discs. Several track properties are fixed to equivalents of CD data.

-@item Track

+@item Track

@cindex track

A unit of data of a CD. The size of a track can vary; it can occupy

@@ -492,7 +492,7 @@ the entire contents of the CD. Most CD standards however require that

tracks have a 150 frame (or ``2 second'') lead-in gap.

An abstraction of tracks for CD, DVD and Blu-ray Discs is the Logical Track

-as of MMC specs. Overwriteable media have a single logical track, sequential

+as of MMC specs. Overwritable media have a single logical track, sequential

media can have one or more logical tracks which they describe in their TOC.

@item UDF

@@ -526,12 +526,12 @@ sectors have a 2336 byte user data area, but parts of it are used for

error codes and headers when using the mode 2 form 1 or form 2

configurations.}

-@uref{http://www.dvdrhelp.com/vcd}

+@uref{https://www.videohelp.com/glossary?V#VCD}

@item Win32 ASPI

@cindex ASPI

-The ASPI interface specification was developed by Adaptec for

+The ASPI interface specification was developed by Adaptec for

sending commands to a SCSI host adapter (such as those controlling CD

and DVD drives) and used on Window 9x/NT and later. Emulation for

ATAPI drives was added so that the same sets of commands worked those

@@ -544,6 +544,8 @@ interface, and has take steps to make using ASPI more inaccessible

See also @pxref{MMC,,@acronym{MMC}}.

+@uref{https://www.videohelp.com/glossary?A#ASPI}

+

@item Win32 ioctl driver

Ioctl (Input Output ConTroLs). A Win32 function, implemented in all

diff --git a/doc/libcdio.texi b/doc/libcdio.texi
index 008402a7..e6c3ba7f 100644
--- a/doc/libcdio.texi
+++ b/doc/libcdio.texi

@@ -15,7 +15,7 @@

This manual documents @code{libcdio}, the GNU CD Input, Output, and Control

Library.

-Copyright @copyright{} 2003-2008, 2010, 2012-2014 Rocky

+Copyright @copyright{} 2003-2008, 2010, 2012-2014, 2025 Rocky

Bernstein and Herbert Valerio Riedel.

@quotation

@@ -280,47 +280,55 @@ performs low-level block reading of a CD or CD image

@item @code{iso-info}

-displays ISO-9660 information from an ISO-9660 image. Below is some

-sample output

+displays ISO-9660 information from an ISO-9660 image. Below is a sample invocation and output.

@smallexample

-iso-info version 0.82 x86_64-unknown-linux-gnu

-Copyright (c) 2003, 2004, 2005, 2007, 2008 R. Bernstein

+$ iso-info -l test/data/joliet.iso

+iso-info version 2.1.1 x86_64-pc-linux-gnu

+Copyright (c) 2003-2005, 2007-2008, 2011-2015, 2017, 2025 R. Bernstein

This is free software; see the source for copying conditions.

There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A

PARTICULAR PURPOSE.

__________________________________

-ISO 9660 image: ../test/joliet.iso

-Application: K3B THE CD KREATOR VERSION 0.11.12 (C) 2003 SEBASTIAN TRUEG AND...

-Preparer : K3b - Version 0.11.12

-Publisher : Rocky Bernstein

-System : LINUX

-Volume : K3b data project

-Volume Set :

+ISO 9660 image: test/data/joliet.iso

+Application : K3B THE CD KREATOR VERSION 0.11.12 (C) 2003 SEBASTIAN TRUEG AND THE K3B TEAM

+Preparer : K3b - Version 0.11.12

+Publisher : Rocky Bernstein

+System : LINUX

+Volume : K3b data project

+Joliet Level: 3

__________________________________

ISO-9660 Information

/:

- Oct 22 2004 19:44 .

- Oct 22 2004 19:44 ..

- Oct 22 2004 19:44 libcdio

+ d [LSN 31] 2048 Oct 22 2004 18:44:59 .

+ d [LSN 31] 2048 Oct 22 2004 18:44:59 ..

+ d [LSN 32] 2048 Oct 22 2004 18:44:59 libcdio

/libcdio/:

- Oct 22 2004 19:44 .

- Oct 22 2004 19:44 ..

- Mar 12 2004 02:18 COPYING

- Jun 26 2004 07:01 README

- Aug 12 2004 06:22 README.libcdio

- Oct 22 2004 19:44 test

+ d [LSN 32] 2048 Oct 22 2004 18:44:59 .

+ d [LSN 31] 2048 Oct 22 2004 18:44:59 ..

+ - [LSN 34] 17992 Mar 12 2004 02:18:03 COPYING

+ - [LSN 43] 2156 Jun 26 2004 06:01:09 README

+ - [LSN 45] 2849 Aug 12 2004 05:22:23 README.libcdio

+ d [LSN 33] 2048 Oct 22 2004 18:44:59 test

/libcdio/test/:

- Oct 22 2004 19:44 .

- Oct 22 2004 19:44 ..

- Jul 25 2004 06:52 isofs-m1.cue

+ d [LSN 33] 2048 Oct 22 2004 18:44:59 .

+ d [LSN 32] 2048 Oct 22 2004 18:44:59 ..

+ - [LSN 47] 74 Jul 25 2004 05:52:32 isofs-m1.cue

@end smallexample

@item @code{iso-read}

-extracts files from an ISO-9660 image.

+Extracts files from an ISO-9660 image.

+

+Below is a sample invocation and output.

+

+@smallexample

+$ iso-read -i test/data/joliet.iso -e libcdio/README -o /tmp/README

+$ ls -l /tmp/README

+-rw-rw-r-- 1 rocky rocky 2156 Jan 4 10:30 /tmp/README

+@end smallexample

@item @code{mmc-tool}

@@ -969,8 +977,8 @@ MSF rather than a LBA or LSN described below, since subtraction of two

MSF's has the awkwardness akin to subtraction using Roman Numerals.

A simpler way to address a block is to use a ``Logical Sector Number''

-(@term{LSN}) or a ``Logical Block Address (@term{LBA}). In the MMC-5

-glossary these are synonymous terms. However historically it has been

+(@term{LSN}) or a ``Logical Block Address (@term{LBA}). In the MMC-6

+glossary, these are synonymous terms. However historically it has been

used differently. In libcdio, to convert a LBA into an LSN you just

subtract 150. Both LBA's and LSN's can be negative.

@@ -1224,17 +1232,17 @@ distribution as @file{example/tracks.c}.

9: track_t i_tracks = cdio_get_num_tracks(p_cdio);

10: int j, i=first_track_num;

11:

-12: printf("CD-ROM Track List (%i - %i)\n", first_track_num, i_tracks);

+12: printf("CD-ROM Track List (%i - %i)\n", first_track_num, i_first_track+i_tracks-1);

13

14: printf(" #: LSN\n");

15:

16: for (j = 0; j < i_tracks; i++, j++) @{

17: lsn_t lsn = cdio_get_track_lsn(p_cdio, i);

18: if (CDIO_INVALID_LSN != lsn)

-19: printf("%3d: %06d\n", (int) i, lsn);

+19: printf("%3d: %06d\n", (int) i, (long unsigned int) lsn);

20: @}

21: printf("%3X: %06d leadout\n", CDIO_CDROM_LEADOUT_TRACK,

-22: cdio_get_track_lsn(p_cdio, CDIO_CDROM_LEADOUT_TRACK));

+22: (long unsigned int) cdio_get_track_lsn(p_cdio, CDIO_CDROM_LEADOUT_TRACK));

23: cdio_destroy(p_cdio);

24: return 0;

25: @}

@@ -2288,6 +2296,7 @@ One of the problems with MMC is that there are so many different

@item MMC 3 --- @url{ftp://ftp.t10.org/t10/drafts/mmc3/}

@item MMC 4 --- @url{ftp://ftp.t10.org/t10/drafts/mmc4/}

@item MMC 5 --- @url{ftp://ftp.t10.org/t10/drafts/mmc5/}

+@item MMC 6 --- @url{ftp://ftp.t10.org/t10/drafts/mmc6/}

@end itemize

along with the several ``drafts'' of these.

@@ -2328,12 +2337,12 @@ commands instead of other OS-specific mechanisms.

@node Access Modes

@section Access Modes

-There are serveral ways that you can open a CD-ROM drive for

+There are several ways that you can open a CD-ROM drive for

subsequent use. Each way is called an @emph{access

mode}. Historically libcdio only supported a reading kind of

access.

-Adding the abilty to writing to a drive for ``burning'' is being added

+Adding the ability to writing to a drive for ``burning'' is being added

by Thomas Schmitt, and this is accomplished by opening the drive in a

read-write mode. Currently writing modes are only supported via the

MMC command interface. Under this, one can get exclusive read-write