'\" t
.\"     Title: piuparts_slave_run
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 2017-03-06
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "PIUPARTS_SLAVE_RUN" "8" "2017\-03\-06" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
piuparts_slave_run \- start up piuparts\-slave instance(s) in screen
.SH "SYNOPSIS"
.sp
\fBpiuparts_slave_run\fR [\fISLAVE\-NUMBERS\fR]
.SH "DESCRIPTION"
.sp
\fBpiuparts_slave_run\fR runs piuparts\-slave instance(s) in \fBscreen\fR which run \fBpiuparts\fR tests which test whether Debian packages handle installation, upgrading, and removal correctly\&.
.sp
By default, \fBpiuparts_slave_run\fR will start the number of slaves specified by the \fIslave\-count\fR parameter in the piuparts\&.conf file\&. If \fIslave\-count\fR is not defined, a single slave will be started\&. If a single argument is supplied to \fBpiuparts_slave_run\fR, consisting of a space\-separated list of numbers between 1 and \fIslave\-count\fR, only those slaves will be started\&.
.SH "OPTIONS"
.sp
There are no options to this command currently\&. Note however that \fBthis interface is under development\fR and may change\&.
.SH "ENVIRONMENT"
.sp
Running piuparts in master\-slave mode requires configuration in \fI/etc/piuparts\fR\&.
.SH "BUGS"
.sp
\fBpiuparts_slave_run\fR should be able to run slaves in different ways: 1\&. all, in a new screen (only this is implemented at the moment) 2\&. a specific one, in a specified screen slot in a (running) screen 3\&. append one to a (running) screen using a "random" slot 4\&. start slave in the current directory in the current shell in foreground\&.
.SH "NOTES"
.sp
Make sure to also read \fB/usr/share/doc/piuparts\-master/README_server\&.txt\fR\&.
.SH "SEE ALSO"
.sp
\fBpiuparts\fR(1), \fBpiuparts_slave_join\fR(8), \fBpiuparts_slave_stop\fR(8), \fBscreen\fR(1)
.SH "AUTHOR"
.sp
Holger Levsen (holger@layer\-acht\&.org)