.TH "ringd" "1" "" "" ""
.SH "NAME"
ringd \- Server for binding low TCP ports from non-root programs
.SH "SYNOPSIS"
.B "ringd"
[\--help]
[\--version]
[\-u \fBUSER\fR,
--user \fBUSER\fR]
[\-g \fBGROUP\fR,
--group \fBGROUP\fR]
.SH "DESCRIPTION"
.PP
\fBringd\fR is used by \fBpproxy\fR
to open TCP ports <1024 for listening\&. \fBringd\fR
runs in the background and gets requests to open a port through
a UNIX domain socket\&. It will then open a socket, bind it to
the specified port and pass it back to the calling program\&.
\fBringd\fR also stores the file descriptor itself
and if another process askes for the same port it will just hand
over the already bound socket\&. This way multiple independent
processes can share the same bound port\&. \fBringd\fR
keeps a refcount so it knows when to close the socket itself, but
this means that all processes, that got a socket through
\fBringd\fR, must make sure to tell
\fBringd\fR when they close the socket or exit\&.
.PP
\fBringd\fR will reopen its log file if it receives
a HUP signal\&.
.PP
For details see the POPular manual\&.
.SH "OPTIONS"
.TP
--help
Print short help screen\&.
.TP
--version
Print version information\&.
.TP
-u \fBUSER\fR, --user \fBUSER\fR
User which is used for ownership of the Unix domain socket
which is used to talk to the pproxy\&. This should be the same
user pproxy is running as\&. No default\&.
.TP
-g \fBGROUP\fR, --group \fBGROUP\fR
Group which is used for ownership of the Unix domain socket
which is used to talk to the pproxy\&. This should be the same
group pproxy is running as\&. Default is the primary group of
the given user\&.
.SH "FILES"
.TP
\fB/var/log/popular/ringd\fR
Log file\&.
.SH "SEE ALSO"
.PP
pcheck(1), pcheckd(8), pclean(8), pcontrol(1), pdeliver(1), pserv(8), pstatus(1), ptestpdm(1), The POPular Manual
.SH "AUTHOR"
.PP
Jochen Topf jochen@remote\&.org
.PP
\fB
http://www\&.remote\&.org/jochen/mail/popular/
\fR
<URL:http://www\&.remote\&.org/jochen/mail/popular/>
.SH "COPYRIGHT"
.PP
The POPular suite is copyright (C) 1999-2002 by Jochen Topf
jochen@remote\&.org\&.
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version\&.
.PP
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE\&. See the
GNU General Public License for more details\&.
.PP
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc\&., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA