xref: /openbsd-src/usr.sbin/identd/identd.8 (revision 4cc355a66b0c8b31fa554f01d9b77ac30d59f757)
1*4cc355a6Sokan.\"   $OpenBSD: identd.8,v 1.11 2013/07/17 15:38:47 okan Exp $
2c32efdd3Sdlg.\"
3dd9acfedSdlg.\" Copyright (c) 2013 David Gwynne <dlg@openbsd.org>
4c32efdd3Sdlg.\"
5c32efdd3Sdlg.\" Permission to use, copy, modify, and distribute this software for any
6c32efdd3Sdlg.\" purpose with or without fee is hereby granted, provided that the above
7c32efdd3Sdlg.\" copyright notice and this permission notice appear in all copies.
8c32efdd3Sdlg.\"
9c32efdd3Sdlg.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10c32efdd3Sdlg.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11c32efdd3Sdlg.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12c32efdd3Sdlg.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13c32efdd3Sdlg.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14c32efdd3Sdlg.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15c32efdd3Sdlg.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16c32efdd3Sdlg.\"
17*4cc355a6Sokan.Dd $Mdocdate: July 17 2013 $
18c32efdd3Sdlg.Dt IDENTD 8
19c32efdd3Sdlg.Os
20c32efdd3Sdlg.Sh NAME
21c32efdd3Sdlg.Nm identd
22c32efdd3Sdlg.Nd Identification Protocol daemon
23c32efdd3Sdlg.Sh SYNOPSIS
24c32efdd3Sdlg.Nm
25*4cc355a6Sokan.Op Fl 46deHhNn
26c32efdd3Sdlg.Op Fl l Ar address
27c32efdd3Sdlg.Op Fl t Ar timeout
28c32efdd3Sdlg.Sh DESCRIPTION
29c32efdd3Sdlg.Nm
30c32efdd3Sdlgis a server which implements the Identification Protocol as specified in
31c32efdd3SdlgRFC 1413.
32c32efdd3Sdlg.Pp
33c32efdd3Sdlg.Nm
34c32efdd3Sdlgoperates by looking up specific TCP/IP connections and returning
35c32efdd3Sdlgthe name of the user running the process responsible for the connection.
36c32efdd3Sdlg.Pp
37c32efdd3SdlgThe options are as follows:
38c32efdd3Sdlg.Bl -tag -width Ds
39c32efdd3Sdlg.It Fl 4
40c32efdd3SdlgForces
41c32efdd3Sdlg.Nm
42c32efdd3Sdlgto use IPv4 addresses only.
43c32efdd3Sdlg.It Fl 6
44c32efdd3SdlgForces
45c32efdd3Sdlg.Nm
46c32efdd3Sdlgto use IPv6 addresses only.
47c32efdd3Sdlg.It Fl d
48c32efdd3SdlgDo not daemonize.
49c32efdd3SdlgIf this option is specified,
50c32efdd3Sdlg.Nm
51c32efdd3Sdlgwill run in the foreground and log to stderr.
526b9316d1Ssthen.It Fl e
536b9316d1SsthenAlways return
546b9316d1Ssthen.Dq UNKNOWN-ERROR
556b9316d1Sstheninstead of the
566b9316d1Ssthen.Dq NO-USER
576b9316d1Ssthenor
586b9316d1Ssthen.Dq INVALID-PORT
596b9316d1Ssthenerrors.
60*4cc355a6Sokan.It Fl H
61*4cc355a6SokanHide information about existing and non-existent users.
62*4cc355a6SokanThis flag implies
63*4cc355a6Sokan.Fl h .
643f52e118Sdlg.It Fl h
653f52e118SdlgHide the actual information about the user by providing an opaque
663f52e118Sdlgtoken instead.
673f52e118SdlgThis token is entered into the local system logs
683f52e118Sdlgso that the administrator can later discover who the real user was.
69c32efdd3Sdlg.It Fl l Ar address
70c32efdd3SdlgListen on the specified address.
71c32efdd3SdlgBy default
72c32efdd3Sdlg.Nm
73c32efdd3Sdlglistens on wildcard addresses.
744fe4baadSdlg.It Fl N
754fe4baadSdlgWhen replying with a user name or ID, first
764fe4baadSdlgcheck for a file
774fe4baadSdlg.Pa .noident
784fe4baadSdlgin the user's home directory.
794fe4baadSdlgIf this file is accessible, return
804fe4baadSdlg.Dq HIDDEN-USER
814fe4baadSdlginstead of the normal USERID response.
8253389e0dSdlg.It Fl n
8353389e0dSdlgAlways return UID numbers instead of usernames.
8425fb8b2aSjmc.It Fl t Ar timeout
8525fb8b2aSjmcSpecifies the idle timeout for client connections,
8625fb8b2aSjmcin seconds.
87c32efdd3SdlgThe default timeout is 120 seconds.
88c32efdd3Sdlg.El
89c32efdd3Sdlg.\" .Sh SEE ALSO
9025fb8b2aSjmc.Sh STANDARDS
9125fb8b2aSjmc.Rs
9225fb8b2aSjmc.%A M. St. Johns
9325fb8b2aSjmc.%D February 1993
9425fb8b2aSjmc.%R RFC 1413
9525fb8b2aSjmc.%T Identification Protocol
9625fb8b2aSjmc.Re
97c32efdd3Sdlg.Sh HISTORY
98c32efdd3SdlgThe
99c32efdd3Sdlg.Nm
100c32efdd3Sdlgcommand was originally a process run via
101c32efdd3Sdlg.Xr inetd 8 .
102c32efdd3SdlgIt was rewritten for
103c32efdd3Sdlg.Ox 5.4
104c32efdd3Sdlgas a persistent non-blocking daemon.
105