.\" ##################################################################
.\" ############# Copyright (C) 1996-2001 Stenio Brunetta ############
.\" #################### See COPYRIGHT for details ###################
.\" ##################################################################
.\"
.\" Process this file with
.\" groff -man -Tascii aspd.8
.\"
.\" $Id: aspd.8,v 1.26 2001/02/01 19:27:26 ste Exp $
.TH ASPD 8 "February 1997" Linux "User Manual"
.SH NAME
aspd \- Address Search Protocol Daemon
.SH SYNOPSIS
.BR "aspd " "   [" -r
.IR repetitions ] 
.RB [ -i
.IR interface "] [" hostname ]
.br
.B "aspd    -V"
.P
.BR "in.aspd " [ -r
.IR repetitions "] [" hostname ]
.br
.B "in.aspd -V"
.SH DESCRIPTION
.B Aspd
is a daemon that waits for incoming address requests on
.BR asp 's
port. If
.B aspd
detects itself as being the searched host, it sends a reply to the
client, allowing the retrieval of its
.SM IP
address. It is possible to specify an alternate
.I hostname
on command line, instead of using the value returned from the
.BR gethostname (3)
function. This is useful if your hostname is dynamically changed when
the link goes up.
.P
If
.B aspd
is invoked as
.B in.aspd
it will work as a server: it makes its work and exit, instead of wait
for new requests; this is useful if you want
.BR inetd (8)
to automatically run the server when a request arrives.
.SH OPTIONS
.TP
.BI "-r " repetitions
.br
Set the number of times to re-send the reply. Default is 5 times.
.TP
.BI "-i " interface
.br
Set the interface used to get the address to send to the client, for
example
.BR ppp0 .
Note that this option can't be used if
.B aspd
is invoked
by inetd. Note also that you have to kill
.B aspd
if the interface address
changes.
.TP
.B "-V"
Show version information
.SH LOGGING
The peer
.SM IP
address and the searched hostname are logged through the
.BR syslogd (8)
system logger daemon, using the
.B daemon
facility and the 
.B notice
level. Transmission errors use the
.B warning 
level and are logged only if
.B aspd
was compiled with the debug support.
.SH FILES
.TP
.I /etc/services
Used by
.B aspd
to find the asp protocol port number.
.SH BUGS
Maybe.
.SH AUTHOR
Stenio Brunetta <stenio@brunettaeperin.it>
.RE
.PP
Comments and suggestions are welcome.
.SH "SEE ALSO"
.BR asp (1),
.BR inetd (8),
.BR syslog (3),
.BR syslogd (8).