1revisor(8)                                                          revisor(8)
2
3
4

NAME

6       revisor - Fedora compose and customize tool
7

SYNOPSIS

9       revisor [options]
10

DESCRIPTION

12       Revisor  is  a  customization  program for Fedora, CentOS and other Red
13       Hat-based distribution deriatives.
14
15

OPTIONS

17       The options below, if specified on the CLI, will  override  any  global
18       and model options specified in the configuration file(s) loaded.
19
20       -h, --help            show a help message and exit
21
22

Runtime Options:

24       --cli
25           Force  Revisor  to run in CLI mode. (see also 'Running in CLI or in
26       GUI mode')
27
28       --gui
29           Force Revisor to run in GUI mode. Does not fallback to CLI and thus
30       shows GUI related errors. (see also 'Running in CLI or in GUI mode')
31
32       --list-models
33           List available models. This lists the available models from a Revi‐
34       sor configuration file. See also revisor.conf(5).
35
36       --debug [level]
37           Enable debugging level. The level runs from 0 (high-level messages)
38       to 9 (very, very low-level messages).
39
40       --yes
41           Answer 'yes' to all questions.
42
43

Configuration Options:

45       --kickstart=[kickstart file]
46           Use kickstart file
47
48       --kickstart-save=[file name]
49           Save options to given file (as a kickstart)
50
51       --config=[config file]
52           Revisor configuration file to use
53
54       --source
55           Get the sources to go with the binaries
56
57       --destination-directory=[directory]
58           Destination directory for products
59
60       --working-directory=[directory]
61           Working directory
62
63       --model=[model]
64           Model to use for composing. Use --list-models to get a list of mod‐
65       els.
66
67       --respin
68           Mode to use for composing updated spins
69
70

Installation Media Options:

72       --install-cd
73           Create Installation Media CDs
74
75       --install-dvd
76           Create Installation Media DVDs
77
78       --install-unified
79           Create Unified ISO from install tree
80
81       --install-dvd-dl
82           Create Installation Media Dual-Layered DVDs
83
84       --install-raw
85           Build raw HDD install image.
86
87       --install-tree
88           Build install tree.
89
90       --kickstart-include
91           Include kickstart file on media
92
93       --kickstart-default
94           Set kickstart to boot by default
95
96       --revisor-comps
97           Use Revisor's comps file instead of the repositories.
98
99       --updates-img=[updates image]
100           Include specified updates.img on installation media.
101
102

Live Media Options:

104       --live-optical
105           Create Live Media CD/DVD
106
107       --live-usb-thumb
108           Create Live Media Thumb Drive Image
109
110       --live-usb-hd
111           Create Live Media Hard Disk Image
112
113       --live-raw
114           Create Live Media Raw Hard Disk Image
115
116       --live-shell
117           Interactively work in the live image before building the ISO image.
118
119       --skip-compression
120           Skip file system compression.
121
122       --skip-prelink
123           Skip prelinking the contents of the filesystem.
124
125       --ignore-deleted
126           Ignore filesystem overhead. Useless blocks will not be removed from
127       the filesystem.
128
129       --preferred-kernel
130           Set the preferred kernel. One of normal, PAE, xen or debug.
131
132

Virtualization Media Options (Available with revisor-modvirt):

134       --virt-xen=[guest name]
135           Build Xen virtual machine. (not implemented yet)
136
137       --virt-xen-size=[drive size in MB]
138           Xen  virtual  machine  drive  size,  in  MB. (Default: 3000MB) (not
139       implemented yet)
140
141       --virt-kvm=[guest name]
142           Build KVM virtual machine. (not implemented yet)
143
144       --virt-kvm-size=[drive size in MB]
145           KVM virtual machine drive  size,  in  MB.  (Default:  3000MB)  (not
146       implemented yet)
147
148       --virt-fstype=[filesystem type]
149           Virtual  machine file system type. (Default: ext3) (not implemented
150       yet)
151
152       --virt-sparse
153           Make virtual machine drive a sparse  filesystem.  (not  implemented
154       yet)
155
156       --virt-stateless
157           Make  virtual  machine  stateless  (changes  do  not persist.) (not
158       implemented yet)
159
160       --virt-appliance
161           Build virtual machine as an appliance  using  a  simple  raw  drive
162       image  and  yum.  (Doesn't  require virt. tech. to be running locally.)
163       (not implemented yet)
164
165

Cobbler Options (Available with revisor-modcobbler):

167       --cobbler-add=[name]
168           Add compose to a Cobbler server as both a Distribution and Profile.
169
170       --cobbler-add-profile=[profile-name]
171           Add compose options as a Profile  to  a  Cobbler  server.  Requires
172       --cobbler-use-distro to be specified as well.
173
174       --cobbler-use-distro=[distro-name]
175           Use a Cobbler distro as source for packages.
176
177       --cobbler-use-profile=[profile-name]
178           Use a Cobbler profile as source for kickstart data.
179
180       --cobbler-list
181           List options provided by cobbler.
182
183       --cobbler-server=[server-address]
184           Use remote cobbler server.
185
186

Delta Options (Available with revisor-moddelta):

188       --delta=[old-iso-image]
189           Generate  a delta ISO image. Currently only valid for a single disc
190       or directory holding Installation Media ISOs named exactly the same  as
191       the product.
192
193

Jigdo Options (Available with revisor-modjigdo):

195       --mirror-directory=[directory]
196           Use this directory as the base.
197
198

Running in CLI or in GUI mode

200       The  --cli  and  --gui  options are particularly useful when debugging.
201       When running Revisor on a server with X11Forwarding enabled, you  might
202       want  to force CLI mode with --cli while if you are troubleshooting the
203       GUI you force Revisor to run in GUI mode by specifying --gui.
204
205       Revisor will (always) first attempt to start in GUI mode. If that fails
206       because  of  some  reason,  Revisor  falls  back to running in CLI mode
207       unless of course --gui had been specified on the command line. Possible
208       reasons to fail starting in GUI mode include:
209
210           - Display environment variable not set.
211           - Connection to display refused.
212           - Package revisor-modgui not installed.
213           - Cannot open display (Also known as 'Cannot import gtk')
214
215

Modules in Revisor

217       Revisor by has a number of modules available:
218
219           - revisor-cobbler
220               Some detailed plugin description here
221
222           - revisor-delta
223               Some detailed plugin description here
224
225           - revisor-gui
226               Some detailed plugin description here
227
228           - revisor-jigdo
229               Some detailed plugin description here
230
231           - revisor-virt
232               Some detailed plugin description here
233
234

SEE ALSO

236       pungi(8), livecd-creator(8), cobbler(8), jigdo(1)
237
238
239
240Jeroen van Meeuwen           Fedora Unity Project                   revisor(8)
Impressum