genisoimage/genisoimagerc.5

   1 .\" genisoimagerc.5 -*- nroff -*-
   2 .\" Derived from genisoimage.1
   3 .\" Copyright 1993-1998 by Yggdrasil Computing
   4 .\" Copyright 1996-1997 by Robert Leslie
   5 .\" Copyright 1997-2001 by James Pearson
   6 .\" Copyright 1999-2006 by Joerg Schilling
   7 .\" Copyright 2002-2003 by Jungshik Shin
   8 .\" Copyright 2003 by Jaakko Heinonen
   9 .\" Copyright 2006 by the Cdrkit maintainers
  10 .\"
  11 .TH GENISOIMAGERC 5 "13 Dec 2006"
  12 .\" ----------------------------------------
  13 .SH NAME
  14 genisoimagerc \- startup configuration file for genisoimage
  15 .SH DESCRIPTION
  16 .BR genisoimage (1)
  17 searches for a configuration file in several places; it uses the first
  18 one it is able to open.  First, if the
  19 .B GENISOIMAGERC
  20 environment variable is set, its value is used as the filename;
  21 likewise for the
  22 .B MKISOFSRC
  23 environment variable.  Next,
  24 .B genisoimage
  25 looks for files named
  26 .IR .genisoimagerc " or " .mkisofsrc ,
  27 first in the current working directory, then in the user's home
  28 directory.  Next, it looks for
  29 .IR /etc/genisoimagerc .
  30 Finally, it looks for a
  31 .I .genisoimagerc
  32 in the same directory as
  33 .B genisoimage
  34 itself is stored.
  35 .PP
  36 The
  37 .I .genisoimagerc
  38 file contains lines of the form
  39 .IP
  40 .BI TAG= value
  41 .PP
  42 where
  43 .B TAG
  44 is one of the settings defined below.  The case of the tag is not
  45 significant.  All settings have command-line equivalents; if the
  46 command-line parameter is specified, it takes priority over the
  47 configuration file.
  48 .PP
  49 Blank lines and lines beginning with `#' are ignored.
  50 .\" ----------------------------------------
  51 .SH "CONFIGURATION SETTINGS"
  52 .IP ABST
  53 The abstract information, typically the name of a file on the disc
  54 containing an abstract.  There is space for 37 characters.
  55 Equivalent to the
  56 .B \-abstract
  57 command-line option.
  58 .IP APPI
  59 The application identifier should describe the application that will be
  60 on the disc.  There is space for 128 characters.  Equivalent to the
  61 .B \-A
  62 command-line option.
  63 .IP BIBL
  64 The bibliographic information, often the name of a file on the disc
  65 containing a bibliography.  There is space for 37 characters.
  66 Equivalent to the
  67 .B \-biblio
  68 command-line option.
  69 .IP COPY
  70 The copyright information, typically the name of a file on the disc
  71 containing the copyright notice.  There is space for 37 characters.
  72 Equivalent to the
  73 .B \-copyright
  74 command-line option.
  75 .IP HFS_TYPE
  76 The default
  77 .B TYPE
  78 for Macintosh files. Must be exactly 4 characters.  Equivalent to the
  79 .B \-hfs\-type
  80 command-line option.  The default value is
  81 .IR TEXT .
  82 .IP HFS_CREATOR
  83 The default
  84 .B CREATOR
  85 for Macintosh files. Must be exactly 4 characters.  Equivalent to the
  86 .B \-hfs\-creator
  87 command-line option.  The default value is
  88 .IR Unix .
  89 .IP PREP
  90 This should describe the preparer of the CD-ROM, usually with a mailing
  91 address and phone number.  There is space for 128 characters.
  92 Equivalent to the
  93 .B \-p
  94 command-line option.
  95 .IP PUBL
  96 This should describe the publisher of the CD-ROM, usually with a
  97 mailing address and phone number.  There is space for 128 characters.
  98 Equivalent to the
  99 .B \-publisher
 100 command-line option.
 101 .IP SYSI
 102 The System Identifier.  There is space for 32 characters.
 103 Equivalent to the
 104 .B \-sysid
 105 command-line option.
 106 .IP VOLI
 107 The Volume Identifier.  There is space for 32 characters.
 108 Equivalent to the
 109 .B \-V
 110 command-line option.
 111 .IP VOLS
 112 The Volume Set Name.  There is space for 128 characters.
 113 Equivalent to the
 114 .B \-volset
 115 command-line option.
 116 .PP
 117 .B genisoimage
 118 can also be configured at compile time with defaults for many of these
 119 fields.  See the file
 120 .IR defaults.h .
 121 .\" ----------------------------------------
 122 .SH EXAMPLES
 123 The following file
 124 .IP
 125 .nf
 126 COPY=src/COPYING
 127 SYSI=Multics 75
 128 .fi
 129 .PP
 130 is equivalent to the
 131 .B genisoimage
 132 command-line parameters
 133 .IP
 134 .I "\-copyright src/COPYING \-sysid \(dqMultics 75\(dq"
 135 .\" ----------------------------------------
 136 .SH "SEE ALSO"
 137 .BR genisoimage (1).
 138 .\" ----------------------------------------
 139 .SH AUTHORS
 140 See the
 141 .BR genisoimage (1)
 142 manual page for credits for the
 143 .B genisoimage
 144 program and documentation.