NAME

ringd - Server for binding low TCP ports from non-root programs

SYNOPSIS

ringd [--help] [--version] [-u USER, --user USER] [-g GROUP, --group GROUP]

DESCRIPTION

ringd is used by pproxy to open TCP ports <1024 for listening. ringd 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. ringd 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. ringd keeps a refcount so it knows when to close the socket itself, but this means that all processes, that got a socket through ringd, must make sure to tell ringd when they close the socket or exit.

ringd will reopen its log file if it receives a HUP signal.

For details see the POPular manual.

OPTIONS

--help: Print short help screen.
--version: Print version information.
-u USER, --user USER: 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.
-g GROUP, --group GROUP: 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.

FILES

/var/log/popular/ringd: Log file.

AUTHOR

Jochen Topf jochen@remote.org

http://www.remote.org/jochen/mail/popular/ <URL:http://www.remote.org/jochen/mail/popular/>

COPYRIGHT

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.

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.

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