Provided by: oidentd_2.0.8-1.1_i386 bug

NAME

       oidentd - TCP/IP IDENT protocol server

SYNOPSIS

       oidentd [options]

       [ -dehiImoqSv ]
       [ -a <host> ]
       [ -c <charset> ]
       [ -C <config file> ]
       [ -f <port> ]
       [ -p <port> ]
       [ -P <host> ]
       [ -o or --other=[<OS string>] ]
       [ -t or --timeout=<seconds> ]
       [ -g or --group=<group|GID> ]
       [ -l or --limit=<number>]
       [ -r or --reply=<string> ]
       [ -u or --user=<username|UID> ]

DESCRIPTION

       oidentd  is  a  server  that  implements the TCP/IP standard IDENT user
       identification protocol as specified in the RFC 1413 document.

       oidentd operates by looking up specific TCP connections  and  returning
       the user name of the process owning the connection.

OPTIONS

       -a or --address=<address|hostname>
              Listen  for connections on the specified address. The default is
              to listen for connections on all configured IP addresses.

       -c or --charset=<charset>
              Use the specified alternate charset.

       -C or --config=<config file>
              Use the specified file as the configuration  file.  The  default
              location of the configuration file is /etc/oidentd.conf.

       -d or --debug
              Enable  debugging.  This causes debugging messages to be printed
              via syslog. This option can be useful when trying to track  down
              the cause of failed lookups.

       -e or --error
              Return  "UNKNOWN-ERROR" for all errors, so as not to divulge any
              unnecessary information to remote clients.

       -f or --forward=[<port>]
              When IP masquerading support is enabled,  forward  requests  for
              machines  that  masquerade  through  us to those machines on the
              specified port. If a port is not given,  oidentd  will  use  the
              default  port for the ident service ("auth" or port 113). If the
              forwarded request fails, oidentd will fall back to  reading  the
              /etc/oidentd_masq.conf  file.  In  order for forwarding to work,
              the machine to which the connection is forwarded  must  also  be
              running  oidentd,  and  oidentd  must  be run with the -P switch
              specifying the host that is forwarding the connections.  If  the
              ident daemon on the host to which the connection is forwarded is
              capable of returning a fixed string for any lookup (for example,
              the ident server built in to the mIRC windows IRC client), it is
              not necessary to run oidentd on that host.

       -g or --group=<group|GID>
              Run with specified GID or group.

       -i or --foreground
              Run  interactively,  not  as  a  daemon.  This  is  useful  when
              debugging,  or  when  running  from  a  service  manager such as
              daemontools.

       -I or --stdio
              Service only a single client request then exit.  The  client  is
              expected to be already connected via stdin and stdout. This mode
              is useful when running from listener utilities such as inetd(8),
              xinetd(8)  or  tcpserver(8).   This  option  implies  -i (run in
              foreground) also.

       -l or --limit=<number>
              Allow, at most, the specified  number  of  open  connections  at
              once.

       -m or --masq
              Enable   support   for   ident   queries   for   masqueraded/NAT
              connections. See oidentd_masq.conf(5) for details on configuring
              support for masqueraded/NAT connections.

       -o or --other=[<string>]
              The  string  specified  will  be  returned  as  the OS string by
              default for all successful ident  lookups.  If  no  argument  is
              given,  "OTHER"  will  be  returned  instead  of the name of the
              operating system. Some requests may  be  interpreted  as  having
              failed  by the client side (with ident in general, not just with
              oidentd), when some other string  is  returned  instead  of  the
              actual name of the operating system.

       -p or --port=<port>
              Listen on the specified port.

       -P or --proxy=<host>
              The  specified  host  acts as a proxy, forwarding connections to
              us. This option must be enabled when connections on the  machine
              on which oidentd is running are masqueraded through another host
              and the host  through  which  the  connections  are  masqueraded
              forwards requests to us.

       -q or --quiet
              Quiet mode; do not log any status messages to syslog.

       -S or --nosyslog
              Log  any  status  messages to stderr, not syslog. This is useful
              for debugging or  integration  with  external  loggers  such  as
              multilog(8).

       -t or --timeout=<seconds>
              Sets  the  number  of  seconds  to  wait for input from a client
              before closing the connection.

       -u or --user=<user|UID>
              Run with specified username or UID.

       -U or --udb
              Perform lookups in  the  UDB  shared  memory  tables,  both  for
              connections  originating  on  the local host and for masqueraded
              connections. When a match is found, it will be used  instead  of
              the   values  supplied  by  the  operating  system,  for  either
              masqueraded  entries  (with  the  -m   flag)   or   normal   TCP
              connections.  Entries  in  the table which don’t match any local
              user will be returned verbatim. This allows oidentd to cooperate
              with  other  programs  (e.g.  RADIUS servers or proxies) to give
              valid replies for dynamic connections.

       -r or --reply=<string>
              Upon a failed lookup, the specified string will be  returned  to
              the client as if the lookup had succeeded.

       -v or --version
              Display version information and exit.

       -h or --help
              Display options and exit.

FILES

       /etc/oidentd.conf
              The system-wide configuration file.

       /etc/oidentd_masq.conf
              The NAT/IP masquerading mappings.

       $HOME/.oidentd.conf
              Per-user configuration file.

AUTHOR

       Ryan McCabe <ryan@numb.org>
       http://dev.ojnk.net

BUGS

       Solaris lacks IPv6 support and NAT support.

SEE ALSO

       oidentd.conf(5) oidentd_masq.conf(5)