*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->OpenBSD man pages -> rfc1413 (3)              
Title
Content
Arch
Section
 

RFC1413(3)

Contents


NAME    [Toc]    [Back]

     rfc1413 - libwrap client side ident implementation

SYNOPSIS    [Toc]    [Back]

     #include <tcpd.h>

     int
     rfc1413(struct sockaddr *rmt_sin, struct sockaddr  *our_sin,
char *dest,
             size_t dsize, int ident_timeout_time);

DESCRIPTION    [Toc]    [Back]

     rfc1413()  retrieves  a user name from a remote system using
the ident protocol
 described in RFC  1413.   It  is  implemented  in  the
libwrap.a library.

     rfc1413() takes two sockaddr pointers as parameters: rmt_sin
for the remote
 host end of a connected TCP socket, and our_sin for the
local end.
     dest  should  be  allocated by the caller to store the found
username, and
     must be of length at least dsize.  ident_timeout_time  is  a
timeout in
     seconds  on  the entire ident query, used to ensure that you
don't wait
     forever for a slow or unresponsive remote host to answer the
ident query.

RETURN VALUES    [Toc]    [Back]

     When  username  lookup  is  successful, rfc1413() strips the
trailing CRLF
     from the returned value and stores up to dsize - 1 bytes  of
the returned
     username  into dest, always terminating with a NUL byte.  In
this case 0
     is returned.  rfc1413() returns -1  if  any  failure  occurs
such that it was
     unable to retrieve the remote username.

SEE ALSO    [Toc]    [Back]

      
      
     hosts_access(3)

BUGS    [Toc]    [Back]

     The ident protocol only works on TCP sockets.

     Ident connections are made unencrypted, and nothing prevents
the remote
     server from lying about  who  the  user  is.   Consequently,
ident should never
  be  used to authenticate users.  ident is however, quite
useful for
     logging users of connections from  multiuser  machines  that
can be trusted
     not to lie about it.

OpenBSD      3.6                        February     10,     2001
[ Back ]
 Similar pages
Name OS Title
rstart Tru64 a sample implementation of a Remote Start client
tt_trace_control HP-UX control client-side tracing
rpc_broadcast_exp FreeBSD library routines for client side calls
clnt_perror NetBSD library routines for client side calls
rpc_clnt_calls FreeBSD library routines for client side calls
clnt_call NetBSD library routines for client side calls
clnt_sperror FreeBSD library routines for client side calls
clnt_call FreeBSD library routines for client side calls
clnt_perrno FreeBSD library routines for client side calls
clnt_perror FreeBSD library routines for client side calls
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service