From b23b454de63883a545b8c71838d54ee06122bee3 Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Sun, 11 Nov 2007 15:59:30 +0000 Subject: [PATCH] Added some examples to man page --- libisoburn/trunk/test/xorriso.1 | 102 +++++++++++++++++++++++++++++++- 1 file changed, 100 insertions(+), 2 deletions(-) diff --git a/libisoburn/trunk/test/xorriso.1 b/libisoburn/trunk/test/xorriso.1 index 300a88cd..6f53dd0b 100644 --- a/libisoburn/trunk/test/xorriso.1 +++ b/libisoburn/trunk/test/xorriso.1 @@ -2,7 +2,7 @@ .\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) -.TH XORRISO 1 "October 30, 2007" +.TH XORRISO 1 "November 11, 2007" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: @@ -771,8 +771,106 @@ Use text as this program's name and perform -help. .br .SH EXAMPLES .SS ->>> more to come +.B As superuser learn about available drives +Consider to give rw permissions to those users or groups +which shall be able to use the drives with xorriso. .br +\fB$\fR xorriso -devices +.br +0 -dev '/dev/sr0' rwrw-- : '_NEC ' 'DVD_RW ND-4570A' +.br +1 -dev '/dev/sr1' rwrw-- : 'HL-DT-ST' 'DVDRAM GSA-4082B' +.br +2 -dev '/dev/sr2' rwrw-- : 'PHILIPS ' 'SPD3300L' +.SS +.B Blank media and compose a new ISO image as batch run +Aquire drive /dev/sr2, blank media resp. invalidate existing ISO image. +Add the files from hard disk directories /home/me/sounds and /pictures. +Omit some unwanted stuff by removing it from the image directory tree. +Re-add some wanted stuff. +.br +Because no -dialog "on" is given the program will then end by committing the +session to media. +.br +\fB$\fR xorriso -dev /dev/sr2 \\ + -blank fast \\ + -graft-points \\ + -add \\ + /sounds=/home/me/sounds \\ + /pictures \\ + -- \\ + -rm_r \\ + /sounds/indecent \\ + '/pictures/*private*' \\ + /pictures/confidential \\ + -- \\ + -add \\ + /pictures/confidential/work* +.br +Note that '/pictures/*private*' is a pattern for iso_rr_paths +while /pictures/confidential/work* gets expanded by the shell +with addresses from the hard disk. +.SS +.B A dialog session doing about the same +.br +-graft-points is already given as start argument. The other activities +are done as dialog input. The pager gets set to 20 lines of 80 chracters. +.br +In order to be able to eject the media, the session needs to be committed +explicitely. +.br +\fB$\fR xorriso -graft-points -dialog on -page 20 80 +.br +enter option and arguments : +.br +.B \-dev /dev/sr2 +.br +enter option and arguments : +.br +.B \-blank fast +.br +enter option and arguments : +.br +.B \-add /sounds=/home/me/sounds /pictures +.br +enter option and arguments : +.br +.B \-rm_r /sounds/indecent /pictures/*private* /pictures/confidential +.br +enter option and arguments : +.br +.B \-add /pictures/confidential/work_office /pictures/confidential/work_factory +.br +enter option and arguments : +.br +.B \-du / +.br +enter option and arguments : +.br +.B \-commit -eject -end +.br +.SS +.B Modifying an existing ISO image +Remove (i.e. hide) directory /sounds and its subordinates. +Rename directory /pictures/confidential to /pictures/restricted. +Change access permissions of directory /pictures/restricted. +Add dummy as replacement of /pictures/confidential. +Add new directory tree /movies. Burn to DVD and eject. +.br +\fB$\fR xorriso -dev /dev/sr2 \\ + -rm_r /sounds -- \\ + -mv \\ + /pictures/confidential \\ + /pictures/restricted \\ + -- \\ + -chmod go-rwx /pictures/restricted -- \\ + -graft-points \\ + -add \\ + /sounds=/home/me/prepared_for_dvd/sounds_dummy \\ + /movies=/home/me/prepared_for_dvd/movies \\ + -- \\ + -commit \\ + -eject .SS .B Examples of input timestrings .br