Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
dvdbackup(1)		     General Commands Manual		    dvdbackup(1)

NAME
     dvdbackup - Tool to backup DVDs

SYNOPSIS
     dvdbackup [OPTION]...

DESCRIPTION
     This manual page documents briefly the dvdbackup command.	This manual page
     was  written  for the Debian distribution because the original program does
     not have a manual page.  dvdbackup is a tool to  extract  data  from  video
     DVDs.  It has the advantages of being small, fast, and easy to use.

OPTIONS
     A summary of options is included below.

     -h, --help
	    print a brief usage message

     -V, --version
	    print version information

     -I, --info
	    for information about the DVD

     -M, --mirror
	    backup the whole DVD

     -F, --feature
	    backup the main feature of the DVD

     -T X, --titleset=X
	    backup title set X

     -t X, --title=X
	    backup title X

     -s X, --start=X
	    backup from chapter X

     -e X, --end=X
	    backup to chapter X

     -i DEVICE, --input=DEVICE
	    where  DEVICE is your DVD device.  This switch only needs to be used
	    if your DVD device node is not /dev/cd0

     -o DIRECTORY, --output=DIRECTORY
	    where DIRECTORY is your backup target.  If not  given,  the  current
	    working directory will be used.

     -v, --verbose
	    print more information about progress

     -n NAME, --name=NAME
	    (optional) set the title - useful if autodetection fails

     -a 0, --aspect=0
	    to get aspect ratio 4:3 instead of 16:9 if both are present

     -r {a,b,m}, --error={a,b,m}
	    select  read  error handling: a=abort, b=skip block, m=skip multiple
	    blocks (default)

     -p, --progress
	    print progress information while copying VOBs

Option notes
     -a is option to the -F switch and has no effect on other options
     -s and -e should preferably be used together with -t

General backup information
     If your backup directory is /my/dvd/backup/dir/ specified with the -o flag,
     then    dvdbackup	  will	  create    a	 DVD-Video    structure    under
     /my/dvd/backup/dir/TITLE_NAME/VIDEO_TS.   If  the	-o  flag is omitted, the
     current directory is used.

     Since the title is "unique" you can use the same directory for all your DVD
     backups. If it happens to have a generic title dvdbackup will exit  with  a
     return  value  of	2, and you will need to specify a title name with the -n
     switch.

     dvdbackup will always mimic the original DVD-Video structure. Hence if  you
     e.g.   use the -M (mirror) you will get an exact duplicate of the original.
     This means that every file will have the same size  as  the  original  one.
     Likewise also for the -F and the -T switch.

     However  the -t and (-t -s/-e) switch is a bit different the titles sectors
     will be written to the original file but not at  the  same  offset  as  the
     original  one  since there may be gaps in the cell structure that we do not
     fill.

EXAMPLES
     dvdbackup -I
	    gathers information about the DVD.	/dev/cd0 is the  default  device
	    tried - you need to use -i if your device name is different.

     dvdbackup -M
	    backups the whole DVD.  This action creates a valid DVD-Video struc-
	    ture that can be burned to a DVD-/+R(W) with help of genisoimage.

     dvdbackup -F
	    backups  the  main	feature of the DVD.  This action creates a valid
	    DVD-Video structure of the feature title set.  Note that  this  will
	    not result in an image immediately watchable - you will need another
	    program like dvdauthor to help construct the IFO files.

	    dvdbackup  defaults to get the 16:9 version of the main feature if a
	    4:3 is also present on the DVD.  To get the 4:3 version use -a 0.

	    dvdbackup makes it best to make a intelligent guess what is the main
	    feature of the DVD - in case it fails please send a bug report.

     dvdbackup -T 2
	    backups the title set 2 i.e. all VTS_02_X.XXX  files.   This  action
	    creates  a	valid  DVD-Video  structure  of the specified title set.
	    Note that this will not result in an image immediately  watchable  -
	    you  will  need another program like dvdauthor to help construct the
	    IFO files.

     dvdbackup -t 1
	    backups the title 1.  This action backups all cells that  forms  the
	    specified  title.  Note that there can be sector gaps in between one
	    cell and another. dvdbackup will backup all sectors that belongs  to
	    the title but will skip sectors that are not a part of the title.

     dvdbackup -t 1 -s 20 -e 25
	    This  action  will	backup	chapter 20 to 25 in title 1, as with the
	    backup of a title there can  be  sector  gaps  between  one  chapter
	    (cell) and on other.  dvdbackup will backup all sectors that belongs
	    to the title 1 chapter 20 to 25 but will skip sectors that are not a
	    part of the title 1 chapter 20 to 25.

	    To backup a single chapter e.g. chapter 20 do -s 20 -e 20.
	    To backup from chapter 20 to the end chapter use only -s 20.
	    To backup to chapter 20 from the first chapter use only -e 20.

	    You  can  skip the -t switch and let the program guess the title al-
	    though it is not recommended.

	    If you specify a chapter that is higher than the last chapter of the
	    title dvdbackup will truncate to the highest chapter of the title.

EXIT STATUS
     0	    on success

     1	    on usage error

     2	    on title name error

     -1     on failure

AUTHORS
     dvdbackup was written by Olaf Beck <olaf_sc@yahoo.com>, but  is  now  main-
     tained  by  Benjamin  Drung  <benjamin.drung@gmail.com>  and  Stephen  Gran
     <sgran@debian.org>.   This  manual  page  was  written  by   Stephen   Gran
     <sgran@debian.org>.

0.2				   2008-03-18			    dvdbackup(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dvdbackup&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help