fsession(2) [plan9 man page]

FSESSION(2)							System Calls Manual						       FSESSION(2)

NAME

       fsession, fauth - set up authentication on a file descriptor to a file server

SYNOPSIS

       #include <u.h>
       #include <libc.h>
       #include <auth.h>

       int   fsession(int fd, char trbuf[TICKREQLEN])

       uchar fauth(int fd, char tbuf[2*TICKETLEN])

DESCRIPTION

       The first time fsession is called for the connection referred to by fd, a session (see attach(5)) message is exchanged with the file server
       at the other end of the connection.  Fsession uses the information returned by the file server and the id of the user  to  build  a  ticket
       request	message returned in trbuf.  If the file server requires no authentication or the kernel already has authentication tickets for the
       current user for this connection, trbuf[0] is set to 0.	If not, trbuf can be used to obtain tickets from an authentication server.   Fses-
       sion should be called before any mount (see bind(2)) of fd.

       Fauth is used to pass authentication tickets to the kernel for the current user.  The tickets are used to authenticate the user in any sub-
       sequent mounts of fd by that user.

       It is rare to use these functions directly; more commonly amount or authenticate (see auth(2)) is used.

SOURCE

       /sys/src/libc/9syscall

SEE ALSO

       attach(5), auth(2) (particularly amount), auth(6), auth(8)

DIAGNOSTICS

       Sets errstr.

																       FSESSION(2)

auth-relaytest(1)					      General Commands Manual						 auth-relaytest(1)

NAME

       auth-relaytest - attempt to use authenticated SMTP to relay to a DSBL-compliant host

SYNOPSIS

       auth-relaytest [-tv] ntlm <ip address[:port]>
       auth-relaytest [-tv] (cram-md5|login) <username> <password> <ip address[:port]>

DESCRIPTION

       auth-relaytest  attempts  to connect to the specified <ip address> on the specified port (default is port 25) and tries to use the supplied
       authentication data to relay mail through the host.

       auth-relaytest uses the sender_user, sender_domain, target_user, target_domain, and auth-message parameters from dsbl.conf(5)  by  default.
       If the auth-message parameter is not present, the message parameter is used instead.

       In the first mode of operation shown, auth-relaytest attempts to authenticate using anonymous NTLM authentication. A well-known bug in cer-
       tain Microsoft SMTP server implementations (described at http://www.microsoft.com/technet/security/bulletin/MS02-011.asp) will allow relay-
       ing for any client that authenticates in this way.

       In the second form of operation, auth-relaytest attempts to authenticate using either the cram-md5 or login variant of SMTP AUTH, using the
       supplied username and password.

OPTIONS

       -t     Test mode. Instead of using the target_domain parameter from dsbl.conf(5), the test_target_domain parameter is used instead. This is
	      useful for sending a test message to yourself, perhaps to check that the server is actually relaying the messages.

       -v     Verbose mode. Details of the SMTP transaction are written to standard output.

AUTHORS

       Paul Howarth <paul@city-fan.org>
       Ian Gulliver <ian@penguinhosting.net>

SEE ALSO

       dsbl.conf(5), spamtrap(1), relaytest(1)

								    2004-01-06							 auth-relaytest(1)