diff options
-rw-r--r-- | docs/mock.1 | 94 |
1 files changed, 53 insertions, 41 deletions
diff --git a/docs/mock.1 b/docs/mock.1 index 9bcc94a..e1dd638 100644 --- a/docs/mock.1 +++ b/docs/mock.1 @@ -41,6 +41,47 @@ examples of how to set them, and their default values. For backwards compatibility, old-style commands, ("rebuild", "init", "clean", etc.) without leading '\-\-' are still accepted, but are deprecated. See COMMANDS section, below, for detailed listing of all commands. + +.SH "COMMANDS" +.LP +.TP +\fB\-\-clean\fP +Purge the chroot tree +.TP +\fB\-\-init\fP +Initialize a chroot (clean, install chroot packages, etc.) +.TP +\fB\-\-rebuild\fP +If no command is specified, rebuild is assumed. Rebuilds the specified SRPM(s). The buildroot is cleaned first, unless --no-clean is specified. +.TP +\fB\-\-shell\fP +Run the specified command interactively within the chroot (which must already be initialized -- no 'clean' is performed). If no command specified, /bin/sh is run. +.TP +\fB\-\-chroot\fP +Run the specified command non-interactively within the chroot (which must already be initialized -- no 'clean' is performed). Command output will be sent to the log files. +.TP +\fB\-\-installdeps\fP +Find out deps for SRPM or RPM, and do a yum install to put them in the buildroot. Buildroot must already be initialized -- no 'clean' is performed +.TP +\fB\-\-install\fP +Do a yum install PACKAGE inside the buildroot. Buildroot must already be initialized -- no 'clean' is performed +.TP +\fB\-\-update\fP +Do a yum update inside the buildroot. Buildroot must already be initialized -- no 'clean' is performed +.TP +\fB\-\-orphanskill\fP +No-op mode that simply checks that no stray processes are running in the chroot. Kills any processes that it finds using specified root. +.TP +\fB\-\-copyin\fP +Copies the source paths (files or directory trees) into the chroot at +the specified destination path. +.TP +\fB\-\-copyout\fP +Copies the source paths (files or directory trees) from the chroot to +the specified destination path. + + + .SH "OPTIONS" .LP .TP @@ -110,43 +151,7 @@ Show usage information and exit. .TP \fB\-\-version\fR Show version number and exit. -.SH "COMMANDS" -.LP -.TP -\fB\-\-clean\fP -Purge the chroot tree -.TP -\fB\-\-init\fP -Initialize a chroot (clean, install chroot packages, etc.) -.TP -\fB\-\-rebuild\fP -If no command is specified, rebuild is assumed. Rebuilds the specified SRPM(s). The buildroot is cleaned first, unless --no-clean is specified. -.TP -\fB\-\-shell\fP -Run the specified command interactively within the chroot (which must already be initialized -- no 'clean' is performed). If no command specified, /bin/sh is run. -.TP -\fB\-\-chroot\fP -Run the specified command non-interactively within the chroot (which must already be initialized -- no 'clean' is performed). Command output will be sent to the log files. -.TP -\fB\-\-installdeps\fP -Find out deps for SRPM or RPM, and do a yum install to put them in the buildroot. Buildroot must already be initialized -- no 'clean' is performed -.TP -\fB\-\-install\fP -Do a yum install PACKAGE inside the buildroot. Buildroot must already be initialized -- no 'clean' is performed -.TP -\fB\-\-update\fP -Do a yum update inside the buildroot. Buildroot must already be initialized -- no 'clean' is performed -.TP -\fB\-\-orphanskill\fP -No-op mode that simply checks that no stray processes are running in the chroot. Kills any processes that it finds using specified root. -.TP -\fB\-\-copyin\fP -Copies the source paths (files or directory trees) into the chroot at -the specified destination path. -.TP -\fB\-\-copyout\fP -Copies the source paths (files or directory trees) from the chroot to -the specified destination path. + .SH "FILES" .LP @@ -155,16 +160,23 @@ the specified destination path. \fI/var/lib/mock\fP \- directory where chroots are created .SH "EXAMPLES" .LP -To rebuild test.src.rpm under the default chroot: +To rebuild test.src.rpm under the default chroot. +The output RPMs will be placed under /var/lib/mock/CHROOT/results/ by default. +.LP +.RS 5 +\fBmock --rebuild /path/to/your.src.rpm\fR +.RE +.LP +To specify a different chroot, which must be defined in /etc/mock/. The argument to \-r is the name of the file in /etc/mock without the trailing .cfg. .LP .RS 5 -\fBmock --rebuild /path/to/test.src.rpm\fR +\fBmock \-r fedora\-8\-i386 --rebuild /path/to/your.src.rpm\fR .RE .LP -To specify a different chroot (which must be defined in /etc/mock): +To specify a different chroot and place the output RPMs and logs in a specified location. .LP .RS 5 -\fBmock \-r fedora\-8\-i386\-core --rebuild /path/to/test.src.rpm\fR +\fBmock \-r fedora\-8\-i386 --resultdir=./my-results /path/to/your.src.rpm\fR .RE .SH "BUGS" .LP |