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