DragonFly On-Line Manual Pages

Search: Section:  

ringd(1)                                                              ringd(1)


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.


SEE ALSO

       pcheck(1), pcheckd(8), pclean(8), pcontrol(1), pdeliver(1), pserv(8),
       pstatus(1), ptestpdm(1), The POPular Manual


AUTHOR

       Jochen Topf jochen@remote.org

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


COPYRIGHT

       The POPular suite is copyright (C) 1999-2002 by Jochen Topf
       jochen@remote.org.

       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

                                                                      ringd(1)

Search: Section: