'\" t
.\"     Title: drblsrv
.\"    Author: Georges Khaznadar <georgesk@ofset.org>
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 12/27/2011
.\"    Manual: Administration commands
.\"    Source: drblsrv
.\"  Language: English
.\"
.TH "DRBLSRV" "8" "12/27/2011" "drblsrv" "Administration commands"
.\" -----------------------------------------------------------------
.\" * 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"
drblsrv \- program to make a DRBL server
.SH "SYNOPSIS"
.HP \w'\fBdrblsrv\fR\ 'u
\fBdrblsrv\fR [{\fB\-f\fR\ |\ \fB\-\-force\-yes\fR}] [{\fB\-i\fR\ |\ \fB\-\-install\fR}] [{\fB\-u\fR\ |\ \fB\-\-uninstall\fR}] [{\fB\-v\fR\ |\ \fB\-\-verbose\fR}] [{\fB\-t\fR\ |\ \fB\-\-testing\fR}\ {\fIy\fR\ |\ \fIn\fR}] [{\fB\-a\fR\ |\ \fB\-\-unstable\fR}\ {\fIy\fR\ |\ \fIn\fR}] [{\fB\-n\fR\ |\ \fB\-\-netinstall\fR}\ {\fIy\fR\ |\ \fIn\fR}] [{\fB\-m\fR\ |\ \fB\-\-smp\-client\fR}\ {\fIy\fR\ |\ \fIn\fR}] [{\fB\-x\fR\ |\ \fB\-\-set\-proxy\fR}\ {\fIy\fR\ |\ \fIn\fR}] [{\fB\-c\fR\ |\ \fB\-\-console\-output\fR}\ {\fIy\fR\ |\ \fIn\fR}] [{\fB\-g\fR\ |\ \fB\-\-upgrade_system\fR}\ {\fIy\fR\ |\ \fIn\fR}] [{\fB\-k\fR\ |\ \fB\-\-client_archi\fR}\ {\fI0\fR\ |\ \fI1\fR\ |\ \fI2\fR}] [{\fB\-o\fR\ |\ \fB\-\-client_kernel_from\fR}\ {\fI1\fR\ |\ \fI2\fR}] [{\fB\-s\fR\ |\ \fB\-\-skip\-select\-repository\fR}] [{\fB\-l\fR\ |\ \fB\-\-language\fR}\ {\fI0\fR\ |\ \fI1\fR\ |\ \fI2\fR}]
.HP \w'\fBdrblsrv\fR\ 'u
\fBdrblsrv\fR [{\fB\-h\fR\ |\ \fB\-\-help\fR} | {\fB\-v\fR\ |\ \fB\-\-version\fR}]
.SH "DESCRIPTION"
.PP
\fBdrblsrv\fR
is a program to build or maintain a DRBL server\&.
.SH "OPTIONS"
.PP
The program follows the usual GNU command line syntax, with long options starting with two dashes (`\-\*(Aq)\&. A summary of options is included below\&.
.PP
\fB\-f\fR, \fB\-\-force\-yes\fR
.RS 4
force yes, only for Debian\-like distribution\&. It should not be used except in very special situations\&. Using force\-yes can potentially destroy your system!
.RE
.PP
\fB\-i\fR, \fB\-\-install\fR
.RS 4
install DRBL\&.
.RE
.PP
\fB\-u\fR, \fB\-\-uninstall\fR
.RS 4
uninstall DRBL\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
verbose mode\&.
.RE
.PP
\fB\-t \fR\fB\fI[y/n]\fR\fR, \fB\-\-testing \fR\fB\fI[y/n]\fR\fR
.RS 4
use packages in testing branch or not\&.
.RE
.PP
\fB\-a \fR\fB\fI[y/n]\fR\fR, \fB\-\-unstable \fR\fB\fI[y/n]\fR\fR
.RS 4
use packages in unstable branch or not\&.
.RE
.PP
\fB\-n \fR\fB\fI[y/n]\fR\fR, \fB\-\-netinstall \fR\fB\fI[y/n]\fR\fR
.RS 4
install the network installation program or not\&.
.RE
.PP
\fB\-m \fR\fB\fI[y/n]\fR\fR, \fB\-\-smp\-client \fR\fB\fI[y/n]\fR\fR
.RS 4
use SMP kernel for DRBL clients or not\&.
.RE
.PP
\fB\-x \fR\fB\fI[y/n]\fR\fR, \fB\-\-set\-proxy \fR\fB\fI[y/n]\fR\fR
.RS 4
set proxy or not\&.
.RE
.PP
\fB\-c \fR\fB\fI[y/n]\fR\fR, \fB\-\-console\-output \fR\fB\fI[y/n]\fR\fR
.RS 4
set console output for client or not\&.
.RE
.PP
\fB\-g \fR\fB\fI[y/n]\fR\fR, \fB\-\-upgrade_system \fR\fB\fI[y/n]\fR\fR
.RS 4
upgrade system or not\&.
.RE
.PP
\fB\-k \fR\fB\fI[0|1|2]\fR\fR, \fB\-\-client_archi \fR\fB\fI[0|1|2]\fR\fR
.RS 4
set the client\*(Aqs CPU arch, 0 for i386, 1 for i586, 2 for same level with DRBL server (for x86_64, use 2)\&.
.RE
.PP
\fB\-o \fR\fB\fI[1|2]\fR\fR, \fB\-\-client_kernel_from \fR\fB\fI[1|2]\fR\fR
.RS 4
choose client\*(Aqs kernel image from, 1 from DRBL server running kernel (if available), 2 from ayo repository\&.
.RE
.PP
\fB\-s\fR, \fB\-\-skip\-select\-repository\fR
.RS 4
skip the question for selecting repository\&.
.RE
.PP
\fB\-l \fR\fB\fI[N]\fR\fR, \fB\-\-language \fR\fB\fI[N]\fR\fR
.RS 4
Set the language to be shown, where N: 0: English, 1: Traditional Chinese (Big5) \- Taiwan, 2: Traditional Chinese (UTF\-8, Unicode) \- Taiwan\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Show summary of options\&.
.RE
.PP
\fB\-v\fR, \fB\-\-version\fR
.RS 4
Show version of program\&.
.RE
.SH "FILES"
.PP
/etc/drbl/drbl\&.conf
.RS 4
The system\-wide configuration file to control the behaviour of
drblsrv\&. See
\fBdrbl.conf\fR(5)
for further details\&.
.RE
.PP
${HOME}/\&.drbl\&.conf
.RS 4
The per\-user configuration file to control the behaviour of
drblsrv\&. See
\fBdrbl.conf\fR(5)
for further details\&.
.RE
.SH "ENVIRONMENT"
.PP
\fBDRBL_SCRIPT_PATH\fR
.RS 4
If used, the defined path is used to access each of drbl\*(Aqs routine scripts\&.
.RE
.SH "DIAGNOSTICS"
.PP
The following diagnostics may be issued on
stderr:
.PP
Any error messages worth to be reported in this manpage?
.RS 4
If so, they should be documented here\&.
.RE
.PP
\fBdrblsrv\fR
provides some return codes, that can be used in scripts:
.\" line length increase to cope w/ tbl weirdness
.ll +(\n(LLu * 62u / 100u)
.TS
ll.
\fICode\fR	\fIDiagnostic\fR
T{
\fB0\fR
T}	T{
Program exited successfully\&.
T}
T{
\fB1\fR
T}	T{
is such documentation useful? If no, erase it\&.
T}
.TE
.\" line length decrease back to previous value
.ll -(\n(LLu * 62u / 100u)
.sp
.SH "KNOWN BUGS"
.PP
The program is currently limited to only work with \&.\&.\&. [some known bugs?]
.SH "SEE ALSO"
.PP

\fBdrbl.conf\fR(5),
\fBdrblpush\fR(8)
.SH "AUTHORS"
.PP
\fBGeorges Khaznadar\fR <\&georgesk@ofset\&.org\&>
.RS 4
Wrote this manpage for the Debian system, based on the output of the command "\fBdrblsrv\fR \-h"\&.
.RE
.PP
\fBSteven Shiau\fR <\&steven@nchc\&.org\&.tw\&>
.RS 4
Wrote the command \fBdrblsrv\fR, including its short documentation\&.
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2011 Georges Khaznadar
.br
.PP
This manual page was written for the Debian system (and may be used by others)\&.
.PP
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or (at your option) any later version published by the Free Software Foundation\&.
.PP
On Debian systems, the complete text of the GNU General Public License can be found in
/usr/share/common\-licenses/GPL\&.
.sp