Mentioned FreeBSD peculiarities in our docs

This commit is contained in:
Thomas Schmitt 2008-11-18 22:46:39 +00:00
parent f6f57eb3d1
commit 8cb8c11ede
4 changed files with 31 additions and 16 deletions

View File

@ -18,7 +18,8 @@ The price for that is thorough specialization on data files in ISO-9660
filesystem images. So libisoburn is not suitable for audio (CD-DA) or any filesystem images. So libisoburn is not suitable for audio (CD-DA) or any
other CD layout which does not entirely consist of ISO-9660 sessions. other CD layout which does not entirely consist of ISO-9660 sessions.
Currently it is only supported on Linux with kernels >= 2.4. Currently it is supported on Linux with kernels >= 2.4 and on FreeBSD versions
with ATAPI/CAM support enabled in the kernel, see atapicam(4).
By using this software you agree to the disclaimer at the end of this text: By using this software you agree to the disclaimer at the end of this text:
"... without even the implied warranty ..." "... without even the implied warranty ..."

View File

@ -16,7 +16,8 @@ information of existing ISO images and it writes the session results to
optical media or to filesystem objects. optical media or to filesystem objects.
Vice versa xorriso is able to restore file objects from ISO 9660 filesystems. Vice versa xorriso is able to restore file objects from ISO 9660 filesystems.
Currently it is only supported on Linux with kernels >= 2.4. Currently it is supported on Linux with kernels >= 2.4 and on FreeBSD versions
with ATAPI/CAM support enabled in the kernel, see atapicam(4).
A special property of xorriso is that it needs neither an external ISO 9660 A special property of xorriso is that it needs neither an external ISO 9660
formatter program nor an external burn program for CD or DVD but rather formatter program nor an external burn program for CD or DVD but rather

View File

@ -2,7 +2,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 "Nov 13, 2008" .TH XORRISO 1 "Nov 17, 2008"
.\" 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:
@ -100,7 +100,8 @@ The data content of the session is called filesystem
The written image in its session can then be mounted by the operating system The written image in its session can then be mounted by the operating system
for being used read-only. Linux is able to mount ISO images from block devices, for being used read-only. Linux is able to mount ISO images from block devices,
which may represent optical media, other media or via a loop device even which may represent optical media, other media or via a loop device even
from regular disk files. from regular disk files. FreeBSD mounts ISO images from devices that represent
arbitrary media or from regular disk files.
.PP .PP
This session usage model has been extended on CD media by the concept of This session usage model has been extended on CD media by the concept of
.B multi-session , .B multi-session ,
@ -258,8 +259,6 @@ program is desired. -C $msc1,$msc2 is equivalent to:
Input drive, i.e. source of an existing or empty ISO image, can be any random Input drive, i.e. source of an existing or empty ISO image, can be any random
access readable libburn drive: optical media with readable data, access readable libburn drive: optical media with readable data,
blank optical media, regular files, block devices. blank optical media, regular files, block devices.
.br
Rock Ridge info will be generated by the program unconditionally.
.PP .PP
Output drive, i.e. target for writing, can be any libburn drive. Output drive, i.e. target for writing, can be any libburn drive.
Some drive types do not support the method of growing but only the methods Some drive types do not support the method of growing but only the methods
@ -277,6 +276,12 @@ the path of their block device or of their generic character device. E.g.
.br .br
-dev /dev/sg2 -dev /dev/sg2
.br .br
On FreeBSD the device files have names like
.br
-dev /dev/cd0
.br
-dev /dev/acd0
.br
Get a list of accessible drives by command Get a list of accessible drives by command
.br .br
-devices -devices
@ -367,10 +372,10 @@ The MBR of a follow-up session can get in effect only on overwriteable media.
Commands are either actions or settings. They consist of a command word, Commands are either actions or settings. They consist of a command word,
followed by zero or more parameter words. If the list of parameter words followed by zero or more parameter words. If the list of parameter words
is of variable length (indicated by "[...]" or "[***]") then it has to be is of variable length (indicated by "[...]" or "[***]") then it has to be
terminated by either the list delimiter, or the end of argument list, or an terminated by either the \fBlist delimiter\fR, or the end of argument list,
end of an input line. or an end of an input line.
.PP .PP
At program start the \fBlist delimiter\fR is the word "--". This may be changed At program start the list delimiter is the word "--". This may be changed
by option -list_delimiter in order to allow "--" as argument in a list of by option -list_delimiter in order to allow "--" as argument in a list of
variable length. It is advised to reset the delimiter to "--" immediately variable length. It is advised to reset the delimiter to "--" immediately
afterwards. afterwards.
@ -2356,8 +2361,8 @@ This transport becomes visible with -report_about "ALL".
\fB\-session_log\fR path \fB\-session_log\fR path
If path is not empty it gives the address of a plain text file where If path is not empty it gives the address of a plain text file where
a log record gets appended after each session. This log can be used to a log record gets appended after each session. This log can be used to
determine the start_lba of a session for mount option sbsector= from determine the start_lba of a session for mount options -o sbsector=
date or volume id. resp. -s from date or volume id.
.br .br
Record format is: timestamp start_lba size volume-id Record format is: timestamp start_lba size volume-id
.br .br
@ -2743,9 +2748,10 @@ This makes sense if the full backup leaves substantial remaining capacity
on media and if the expected changes are much smaller than the full backup. on media and if the expected changes are much smaller than the full backup.
An update run will probably save no time but last longer than a full backup. An update run will probably save no time but last longer than a full backup.
.br .br
With \fBmount\fR option \fB"sbsector="\fR it is possible to access the session With \fBmount\fR option -o \fB"sbsector="\fR on Linux resp. \fB-s\fR on FreeBSD
trees which represent the older backup versions. With CD media, Linux mount it is possible to access the session trees which represent the older backup
accepts session numbers directly by its option "session=". versions. With CD media, Linux mount accepts session numbers directly by
its option "session=".
.br .br
Multi-session media and most overwriteable media written by xorriso can tell Multi-session media and most overwriteable media written by xorriso can tell
the sbsectors of their sessions by xorriso option -toc. the sbsectors of their sessions by xorriso option -toc.
@ -2799,7 +2805,8 @@ Avoid to eventually create /home/thomas/restored without rwx-permission.
.br .br
This can be repeated several times, eventually with -eject or with other This can be repeated several times, eventually with -eject or with other
-indev drives. See the human readable part of "$HOME"/dvd_copy.map for -indev drives. See the human readable part of "$HOME"/dvd_copy.map for
addresses which can be used on "$HOME"/dvd_copy with mount option sbsector=. addresses which can be used on "$HOME"/dvd_copy with mount option -o sbsector=
resp. -s.
.br .br
If you want to make the newest session the default mount session, you If you want to make the newest session the default mount session, you
may add option "patch_lba0=on" to the final -check_media run. may add option "patch_lba0=on" to the final -check_media run.

View File

@ -48,6 +48,10 @@ and to MMC-5 for DVD or BD).
<DT>Linux with kernel 2.4 or higher (and libc, of course) :</DT> <DT>Linux with kernel 2.4 or higher (and libc, of course) :</DT>
<DD>With kernel 2.4 an ATA drive has to be under ide-scsi emulation.</DD> <DD>With kernel 2.4 an ATA drive has to be under ide-scsi emulation.</DD>
<DD>With kernel 2.6 the drive should not be under ide-scsi.</DD> <DD>With kernel 2.6 the drive should not be under ide-scsi.</DD>
<!--
<DT>or FreeBSD (with libc, of course) :</DT>
<DD>ATAPI/CAM support has to be enabled in the kernel, see atapicam(4).</DD>
-->
<DT>libpthread</DT> <DT>libpthread</DT>
<DD>is supposed to be a standard system component.</DD> <DD>is supposed to be a standard system component.</DD>
<DT>libreadline and libreadline-dev</DT> <DT>libreadline and libreadline-dev</DT>
@ -79,7 +83,9 @@ cdrecord and mkisofs.</A>
</P> </P>
<P> <P>
This program system has been tested on Intel/AMD Linux systems only.<BR> This program has been tested on Intel/AMD Linux
<!-- and FreeBSD systems -->
only.<BR>
For ports to other usable systems <A HREF="#contact">contact us</A>. For ports to other usable systems <A HREF="#contact">contact us</A>.
</P> </P>