man pages

git-svn-id: https://oss.gonicus.de/repositories/gosa/trunk@12172 594d385d-05f5-0310-b6e9-bd551577e9d8

diff --git a/gosa-si/gosa-si-client.1 b/gosa-si/gosa-si-client.1
new file mode 100644 (file)
index 0000000..d4064ac
--- /dev/null
+++ b/gosa-si/gosa-si-client.1
@@ -0,0 +1,52 @@
+.TH GOSA-SI-CLIENT 1 "JULY 2008" Linux "User Manuals"
+.SH NAME
+gosa-si-client \- client for GOsa support infrastructure
+.SH SYNOPSIS
+.B gosa-si-client [-hvf] [-c 
+.I config-file 
+.B ] 
+
+
+.SH DESCRIPTION
+.B gosa-si-client 
+belongs to the support infrastructure of GOsa. 
+The client registrates at a GOsa-SI-server and accepts messages from it. Each message is related to a working instruction which will be executed at the client. Depending on the message an answer can be send back to the server. 
+
+
+.SH OPTIONS
+.IP -h
+print out this help message
+.IP "-c config-file"
+Use a specific configuration file instead of 
+.IR /etc/gosa-si/client.conf .
+.IP -f
+run program in foreground modus, process will not be forked into background
+.IP -v
+be verbose (multiple v's give more and more informations)
+
+
+.SH FILES
+.I /etc/gosa-si/client.conf
+.RS
+The system wide configuration file. See
+.BR gosa-si-client(5)
+for further details.
+
+.SH ENVIRONMENT
+.IP ?????
+TODO...
+.IR foo.conf .
+Overridden by the
+.B -c
+option.
+
+
+.SH BUGS
+The command name should have been chosen more carefully
+to reflect its purpose.
+.SH AUTHOR
+Andreas Rettenberger <rettenberger at gonicus dot de>
+.SH "SEE ALSO"
+.BR gosa-si-server (1),
+.BR server.conf (5),
+.BR client.conf (5)

diff --git a/gosa-si/gosa-si-client.conf.5 b/gosa-si/gosa-si-client.conf.5
new file mode 100644 (file)
index 0000000..c1013d8
--- /dev/null
+++ b/gosa-si/gosa-si-client.conf.5
@@ -0,0 +1,216 @@
+.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.07)
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sh \" Subsection heading
+.br
+.if t .Sp
+.ne 5
+.PP
+\fB\\$1\fR
+.PP
+..
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" Set up some character translations and predefined strings.  \*(-- will
+.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
+.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.ie n \{\
+.    ds -- \(*W-
+.    ds PI pi
+.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
+.    ds L" ""
+.    ds R" ""
+.    ds C` ""
+.    ds C' ""
+'br\}
+.el\{\
+.    ds -- \|\(em\|
+.    ds PI \(*p
+.    ds L" ``
+.    ds R" ''
+'br\}
+.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\"
+.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
+.\" entries marked with X<> in POD.  Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.ie \nF \{\
+.    de IX
+.    tm Index:\\$1\t\\n%\t"\\$2"
+..
+.    nr % 0
+.    rr F
+.\}
+.el \{\
+.    de IX
+..
+.\}
+.\"
+.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
+.    \" fudge factors for nroff and troff
+.if n \{\
+.    ds #H 0
+.    ds #V .8m
+.    ds #F .3m
+.    ds #[ \f1
+.    ds #] \fP
+.\}
+.if t \{\
+.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+.    ds #V .6m
+.    ds #F 0
+.    ds #[ \&
+.    ds #] \&
+.\}
+.    \" simple accents for nroff and troff
+.if n \{\
+.    ds ' \&
+.    ds ` \&
+.    ds ^ \&
+.    ds , \&
+.    ds ~ ~
+.    ds /
+.\}
+.if t \{\
+.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+.\}
+.    \" troff and (daisy-wheel) nroff accents
+.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+.ds ae a\h'-(\w'a'u*4/10)'e
+.ds Ae A\h'-(\w'A'u*4/10)'E
+.    \" corrections for vroff
+.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+.    \" for low resolution devices (crt and lpr)
+.if \n(.H>23 .if \n(.V>19 \
+\{\
+.    ds : e
+.    ds 8 ss
+.    ds o a
+.    ds d- d\h'-1'\(ga
+.    ds D- D\h'-1'\(hy
+.    ds th \o'bp'
+.    ds Th \o'LP'
+.    ds ae ae
+.    ds Ae AE
+.\}
+.rm #[ #] #H #V #F C
+.\" ========================================================================
+.\"
+.IX Title "CLIENT.CONF 5"
+.TH CLIENT.CONF 5 "2008-07-31" "gosa-si-server" " "
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
+.SH "NAME"
+gosa\-si\-client.conf \- Configuration file for gosa\-si\-client.
+.SH "DESCRIPTION"
+.IX Header "DESCRIPTION"
+The gosa\-si\-client.conf file defines all parameter GOsa-SI-client needs for running and communication with GOsa-SI-server. It is normally located in the \fI/etc/gosa\-si/\fR directory and is generated automatically by the \fIgosa\-si\-client\fR\|(1) program during installation.
+.SH "DIRECTIVES"
+.IX Header "DIRECTIVES"
+.Sh "[general]"
+.IX Subsection "[general]"
+.IP "log-file = /var/run/gosa\-si\-client.log" 4
+.IX Item "log-file = /var/run/gosa-si-client.log"
+Defines the location for the log file.
+.IP "pid-file = /var/run/gosa\-si\-client.pid" 4
+.IX Item "pid-file = /var/run/gosa-si-client.pid"
+Defines the location for the pid file.
+.Sh "[client]"
+.IX Subsection "[client]"
+.IP "port = 20083" 4
+.IX Item "port = 20083"
+Defines the port GOsa-SI-client is listening for incoming messages.
+.IP "ip = 0.0.0.0" 4
+.IX Item "ip = 0.0.0.0"
+If set GOsa-SI-client is forced to use this ip address. If it is not set, an automated determination is tried.
+.IP "mac-address = 00:00:00:00:00:00" 4
+.IX Item "mac-address = 00:00:00:00:00:00"
+If set GOsa-SI-client is forced to use this mac address. If it is not set, an automated determination is tried.
+.IP "server-domain =" 4
+.IX Item "server-domain ="
+???
+.IP "ldap = 1 | 0" 4
+.IX Item "ldap = 1 | 0"
+???
+.IP "ldap-config = /etc/ldap/ldap.conf" 4
+.IX Item "ldap-config = /etc/ldap/ldap.conf"
+Defines the location for ldap.conf file.
+.IP "pam-config = /etc/pam_ldap.conf" 4
+.IX Item "pam-config = /etc/pam_ldap.conf"
+Defines the location for pam\-ldap.conf file.
+.IP "nss-config = /etc/libnss\-ldap.conf" 4
+.IX Item "nss-config = /etc/libnss-ldap.conf"
+Defines the location for libnss\-ldap.conf file.
+.IP "fai-logpath = /var/log/fai/fai.log" 4
+.IX Item "fai-logpath = /var/log/fai/fai.log"
+Defines the location for fai.log file.
+.IP "force-hostname = false | true" 4
+.IX Item "force-hostname = false | true"
+???
+.Sh "[server]"
+.IX Subsection "[server]"
+.IP "ip = 127.0.0.1" 4
+.IX Item "ip = 127.0.0.1"
+If set GOsa-SI-client is forced to register at specified GOsa-SI-Server. If it is not set, GOsa-SI tries to register at GOsa-SI-servers found in \s-1DNS\s0.
+.IP "port = 20081" 4
+.IX Item "port = 20081"
+Defines the port GOsa-SI-server is listening for incoming messages.
+.IP "key =" 4
+.IX Item "key ="
+Defines the password GOsa-SI-server messages should be encrypted. This has to be modified, default value will usually not work!!!
+.IP "timeout = 10" 4
+.IX Item "timeout = 10"
+Defines in seconds the timeout GOsa-SI-client is waiting for the next try if all registraion efforts fails.
+.IP "key-lifetime = 600" 4
+.IX Item "key-lifetime = 600"
+Defines in seconds the lifetime of the key GOsa-SI-server messages should be encrypted with.
+.SH "BUGS"
+.IX Header "BUGS"
+Please report any bugs, or post any suggestions, to the GOsa mailing list <gosa\-devel@oss.gonicus.de> or to <https://oss.gonicus.de/labs/gosa>
+.SH "LICENCE AND COPYRIGHT"
+.IX Header "LICENCE AND COPYRIGHT"
+This code is part of GOsa (<http://www.gosa\-project.org>)
+.PP
+Copyright (C) 2003\-2008 \s-1GONICUS\s0 GmbH
+.PP
+This program is distributed in the hope that it will be useful,
+but \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of
+\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0.  See the
+\&\s-1GNU\s0 General Public License for more details.

diff --git a/gosa-si/gosa-si-server.1 b/gosa-si/gosa-si-server.1
new file mode 100644 (file)
index 0000000..5842a83
--- /dev/null
+++ b/gosa-si/gosa-si-server.1
@@ -0,0 +1,175 @@
+.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.07)
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sh \" Subsection heading
+.br
+.if t .Sp
+.ne 5
+.PP
+\fB\\$1\fR
+.PP
+..
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" Set up some character translations and predefined strings.  \*(-- will
+.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
+.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.ie n \{\
+.    ds -- \(*W-
+.    ds PI pi
+.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
+.    ds L" ""
+.    ds R" ""
+.    ds C` ""
+.    ds C' ""
+'br\}
+.el\{\
+.    ds -- \|\(em\|
+.    ds PI \(*p
+.    ds L" ``
+.    ds R" ''
+'br\}
+.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\"
+.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
+.\" entries marked with X<> in POD.  Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.ie \nF \{\
+.    de IX
+.    tm Index:\\$1\t\\n%\t"\\$2"
+..
+.    nr % 0
+.    rr F
+.\}
+.el \{\
+.    de IX
+..
+.\}
+.\"
+.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
+.    \" fudge factors for nroff and troff
+.if n \{\
+.    ds #H 0
+.    ds #V .8m
+.    ds #F .3m
+.    ds #[ \f1
+.    ds #] \fP
+.\}
+.if t \{\
+.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+.    ds #V .6m
+.    ds #F 0
+.    ds #[ \&
+.    ds #] \&
+.\}
+.    \" simple accents for nroff and troff
+.if n \{\
+.    ds ' \&
+.    ds ` \&
+.    ds ^ \&
+.    ds , \&
+.    ds ~ ~
+.    ds /
+.\}
+.if t \{\
+.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+.\}
+.    \" troff and (daisy-wheel) nroff accents
+.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+.ds ae a\h'-(\w'a'u*4/10)'e
+.ds Ae A\h'-(\w'A'u*4/10)'E
+.    \" corrections for vroff
+.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+.    \" for low resolution devices (crt and lpr)
+.if \n(.H>23 .if \n(.V>19 \
+\{\
+.    ds : e
+.    ds 8 ss
+.    ds o a
+.    ds d- d\h'-1'\(ga
+.    ds D- D\h'-1'\(hy
+.    ds th \o'bp'
+.    ds Th \o'LP'
+.    ds ae ae
+.    ds Ae AE
+.\}
+.rm #[ #] #H #V #F C
+.\" ========================================================================
+.\"
+.IX Title "GOSA-SI-SERVER  "
+.TH GOSA-SI-SERVER " " "2008-07-31" "gosa-si-server" "User Contributed Perl Documentation"
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
+.SH "NAME"
+gosa\-si\-server \-Support infrastructure for GOsa
+.SH "SYNOPSIS"
+.IX Header "SYNOPSIS"
+.Vb 1
+\&    gosa\-si\-server [\-hvf] [\-c config]
+.Ve
+.SH "OPTIONS"
+.IX Header "OPTIONS"
+.Vb 1
+\&    \-h        : print out this help message
+\&
+\&    \-f        : foregroud, process will not be forked to background
+\&
+\&    \-v*       : be verbose (multiple v\*(Aqs will increase verbosity)
+\&
+\&    \-c <file> : configuration file, default F</etc/gosa\-si/server.conf>
+\&
+\&    \-\-no\-arp  : starts script without connection to arp module
+.Ve
+.SH "DESCRIPTION"
+.IX Header "DESCRIPTION"
+gosa-si-server  belongs  to  the  support infrastructure of GOsa.  Several gosa-si-clients can connect to one gosa-si-server.  The server take care of the message forwarding from GOsa to si-clients.  At the client site each message is related to a working instruction which will be executed there.  Depending of the message an answer from the client to GOsa via the server is possible.  Additional to answers clients reporting events  or  information  to the server.  The server registers himself at other servers in network and shares his knowledge with them.  So messages to clients which are no registrated locally will be forward to the client corresponding server. The communication within the complete \s-1SI\s0 nework is realised by \s-1XML\s0 messages.
+.SH "BUGS"
+.IX Header "BUGS"
+Please report any bugs, or post any suggestions, to the GOsa mailing list <gosa\-devel@oss.gonicus.de> or to <https://oss.gonicus.de/labs/gosa>
+.SH "LICENCE AND COPYRIGHT"
+.IX Header "LICENCE AND COPYRIGHT"
+This code is part of GOsa (<http://www.gosa\-project.org>)
+.PP
+Copyright (C) 2003\-2008 \s-1GONICUS\s0 GmbH
+.PP
+This program is distributed in the hope that it will be useful,
+but \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of
+\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0.  See the
+\&\s-1GNU\s0 General Public License for more details.

diff --git a/gosa-si/gosa-si-server.conf.5 b/gosa-si/gosa-si-server.conf.5
new file mode 100644 (file)
index 0000000..3ffcbcd
--- /dev/null
+++ b/gosa-si/gosa-si-server.conf.5
@@ -0,0 +1,286 @@
+.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.07)
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sh \" Subsection heading
+.br
+.if t .Sp
+.ne 5
+.PP
+\fB\\$1\fR
+.PP
+..
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" Set up some character translations and predefined strings.  \*(-- will
+.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
+.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.ie n \{\
+.    ds -- \(*W-
+.    ds PI pi
+.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
+.    ds L" ""
+.    ds R" ""
+.    ds C` ""
+.    ds C' ""
+'br\}
+.el\{\
+.    ds -- \|\(em\|
+.    ds PI \(*p
+.    ds L" ``
+.    ds R" ''
+'br\}
+.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\"
+.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
+.\" entries marked with X<> in POD.  Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.ie \nF \{\
+.    de IX
+.    tm Index:\\$1\t\\n%\t"\\$2"
+..
+.    nr % 0
+.    rr F
+.\}
+.el \{\
+.    de IX
+..
+.\}
+.\"
+.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
+.    \" fudge factors for nroff and troff
+.if n \{\
+.    ds #H 0
+.    ds #V .8m
+.    ds #F .3m
+.    ds #[ \f1
+.    ds #] \fP
+.\}
+.if t \{\
+.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+.    ds #V .6m
+.    ds #F 0
+.    ds #[ \&
+.    ds #] \&
+.\}
+.    \" simple accents for nroff and troff
+.if n \{\
+.    ds ' \&
+.    ds ` \&
+.    ds ^ \&
+.    ds , \&
+.    ds ~ ~
+.    ds /
+.\}
+.if t \{\
+.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+.\}
+.    \" troff and (daisy-wheel) nroff accents
+.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+.ds ae a\h'-(\w'a'u*4/10)'e
+.ds Ae A\h'-(\w'A'u*4/10)'E
+.    \" corrections for vroff
+.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+.    \" for low resolution devices (crt and lpr)
+.if \n(.H>23 .if \n(.V>19 \
+\{\
+.    ds : e
+.    ds 8 ss
+.    ds o a
+.    ds d- d\h'-1'\(ga
+.    ds D- D\h'-1'\(hy
+.    ds th \o'bp'
+.    ds Th \o'LP'
+.    ds ae ae
+.    ds Ae AE
+.\}
+.rm #[ #] #H #V #F C
+.\" ========================================================================
+.\"
+.IX Title "SERVER.CONF 5"
+.TH SERVER.CONF 5 "2008-07-31" "gosa-si-server" " "
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
+.SH "NAME"
+gosa\-si\-server.conf \- Configuration file for gosa\-si\-server.
+.SH "DESCRIPTION"
+.IX Header "DESCRIPTION"
+The gosa\-si\-server.conf file defines all paramter GOsa-SI-server needs for running. It is normally located in the /etc/gosa\-si/ directory and is generated automatically by the \fIgosa\-si\-server\fR\|(1) program during installation.
+.SH "DIRECTIVES"
+.IX Header "DIRECTIVES"
+.Sh "[general]"
+.IX Subsection "[general]"
+.IP "logfile = /var/log/gosa\-si\-server.log" 4
+.IX Item "logfile = /var/log/gosa-si-server.log"
+Defines the location for the log file.
+.IP "pid-file = /var/run/gosa\-si\-server.pid Defines the location for the pid file." 4
+.IX Item "pid-file = /var/run/gosa-si-server.pid Defines the location for the pid file."
+.Sh "[server]"
+.IX Subsection "[server]"
+.PD 0
+.IP "port = 20081" 4
+.IX Item "port = 20081"
+.PD
+Defines the port GOsa-SI-server is listening for incoming messages.
+.IP "known-clients = /var/lib/gosa\-si/clients.db" 4
+.IX Item "known-clients = /var/lib/gosa-si/clients.db"
+Defines the location for the local \s-1DB\s0 'known_clients'.
+.IP "known-server = /var/lib/gosa\-si/servers.db" 4
+.IX Item "known-server = /var/lib/gosa-si/servers.db"
+Defines the location for the local \s-1DB\s0 'known_server'.
+.IP "incoming = /var/lib/gosa\-si/incoming.db" 4
+.IX Item "incoming = /var/lib/gosa-si/incoming.db"
+Defines the location for the local \s-1DB\s0 'incoming'.
+.IP "login-users = /var/lib/gosa\-si/users.db" 4
+.IX Item "login-users = /var/lib/gosa-si/users.db"
+Defines the location for the local \s-1DB\s0 'login_users'.
+.IP "fai-server = /var/lib/gosa\-si/fai_server.db" 4
+.IX Item "fai-server = /var/lib/gosa-si/fai_server.db"
+Defines the location for the local \s-1DB\s0 'fai_server'.
+.IP "fai-release = /var/lib/gosa\-si/fai_release.db" 4
+.IX Item "fai-release = /var/lib/gosa-si/fai_release.db"
+Defines the location for the local \s-1DB\s0 'fai_release'.
+.IP "packages-list = /var/lib/gosa\-si/packages.db" 4
+.IX Item "packages-list = /var/lib/gosa-si/packages.db"
+Defines the location for the local \s-1DB\s0 'packages_list'.
+.IP "messaging = /var/lib/gosa\-si/messaging.db" 4
+.IX Item "messaging = /var/lib/gosa-si/messaging.db"
+Defines the location for the local \s-1DB\s0 'messaging'.
+.IP "foreign-clients = /var/lib/gosa\-si/foreign_clients.db" 4
+.IX Item "foreign-clients = /var/lib/gosa-si/foreign_clients.db"
+Defines the location for the local \s-1DB\s0 'foreign_clients'.
+.IP "source-list = /etc/apt/sources.list" 4
+.IX Item "source-list = /etc/apt/sources.list"
+Defines the location for the sources file.
+.IP "repo-path = /srv/www/repository" 4
+.IX Item "repo-path = /srv/www/repository"
+???
+.IP "ldap-uri =" 4
+.IX Item "ldap-uri ="
+Defines the \s-1LDAP\s0 uniform resource identifier.
+.IP "ldap-base =" 4
+.IX Item "ldap-base ="
+Defines the \s-1LDAP\s0 base.
+.IP "ldap-admin-dn =" 4
+.IX Item "ldap-admin-dn ="
+Defines the distinguished name of the administrator.
+.IP "ldap-admin-password =" 4
+.IX Item "ldap-admin-password ="
+Defines the password of the administrator.
+.IP "gosa-unit-tag =" 4
+.IX Item "gosa-unit-tag ="
+???
+.IP "max-clients = 10" 4
+.IX Item "max-clients = 10"
+Defines the maximum number of GOsa-SI-clients connected to the GOsa-SI-server.
+.IP "wol-password =" 4
+.IX Item "wol-password ="
+Defines the password for wake on \s-1LAN\s0 (\s-1WOL\s0).
+.Sh "[GOsaPackages]"
+.IX Subsection "[GOsaPackages]"
+.IP "job-queue = /var/lib/gosa\-si/jobs.db" 4
+.IX Item "job-queue = /var/lib/gosa-si/jobs.db"
+Defines the location for the local \s-1DB\s0 'job_queue'.
+.IP "job-queue-loop-delay = 3" 4
+.IX Item "job-queue-loop-delay = 3"
+Defines the seconds the job queue is checked.
+.IP "messaging-db-loop-delay = 3" 4
+.IX Item "messaging-db-loop-delay = 3"
+Defines the seconds the messaging queue is checked.
+.IP "key = none" 4
+.IX Item "key = none"
+Defines the password incoming GOsaPackages messages should be encrypted. This has to be modified, default value will not work!!!
+.IP "dak-base = /srv/archive" 4
+.IX Item "dak-base = /srv/archive"
+???
+.IP "dak-keyring = /srv/archive/keyrings" 4
+.IX Item "dak-keyring = /srv/archive/keyrings"
+???
+.IP "dak-queue = /srv/archive/queue" 4
+.IX Item "dak-queue = /srv/archive/queue"
+???
+.IP "dak-usr = deb-dak" 4
+.IX Item "dak-usr = deb-dak"
+???
+.Sh "[ClientPackages]"
+.IX Subsection "[ClientPackages]"
+.IP "key = none" 4
+.IX Item "key = none"
+Defines the password incoming ClientPackages messages should be encrypted. This has to be modified, default value will not work!!!
+.Sh "[ServerPackages]"
+.IX Subsection "[ServerPackages]"
+.IP "address =" 4
+.IX Item "address ="
+???
+.IP "domain =" 4
+.IX Item "domain ="
+???
+.IP "key = none" 4
+.IX Item "key = none"
+Defines the password incoming ServerPackages messages should be encrypted. This has to be modified, default value will not work!!!
+.IP "key-lifetime = 120" 4
+.IX Item "key-lifetime = 120"
+Defines the lifetime in seconds of a GOsa-SI-server key. After expiring the key will be automatically renewed.
+.IP "job-synchronization-enabled = true | false" 4
+.IX Item "job-synchronization-enabled = true | false"
+Defines whether job queue informations are be shared with other GOsa-SI-server in network.
+.IP "synchronization-loog = 5" 4
+.IX Item "synchronization-loog = 5"
+Defines in seconds after which time the job queue synchronization is being done.
+.Sh "[ArpHandler]"
+.IX Subsection "[ArpHandler]"
+.IP "enabled = true | false" 4
+.IX Item "enabled = true | false"
+Defines whether the ArpHandler is being activated at GOsa-SI-server start.
+.IP "interface = all" 4
+.IX Item "interface = all"
+???
+.SH "BUGS"
+.IX Header "BUGS"
+Please report any bugs, or post any suggestions, to the GOsa mailing list <gosa\-devel@oss.gonicus.de> or to <https://oss.gonicus.de/labs/gosa>
+.SH "LICENCE AND COPYRIGHT"
+.IX Header "LICENCE AND COPYRIGHT"
+This code is part of GOsa (<http://www.gosa\-project.org>)
+.PP
+Copyright (C) 2003\-2008 \s-1GONICUS\s0 GmbH
+.PP
+This program is distributed in the hope that it will be useful,
+but \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of
+\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0.  See the
+\&\s-1GNU\s0 General Public License for more details.