dgclient(8)

NAME

dgclient - Request an AmprNet Dynamic Route Server to con

figure a route

SYNOPSIS

dgclient [-t msgtimer] [-k password] [-p port] [-d] <server> <network/mask>

DESCRIPTION

dgclient periodically sends a specially formatted UDP

datagram to the supplied server which is assumed to be an AmprNet

Dynamic Gateway Route Server. The datagram supplies the network

address and mask of a network that the client wishes to have

routed to it via IPIP encapsulation. An optional password may be

supplied to the server to authenticate the client to it if re

quired.

Sending the dgclient program a SIGHUP, SIGTERM, SIGUSR1,

or SIGUSR2 will cause it to send three request commands to remove

the encapsulated route and exit.

OPTIONS

-t msgtimer

specifies the time interval between refresh mes

sages sent to the server. This should always be set to a value no

larger than the dynamic route timer being used at the server. UDP

is a lossy protocol so it may be wise to make this value at most

half of the server route timeout to ensure that one lost datagram

doesn't cause the route to be lost.

-k password

specifies the optional password to supply to the

server for authentication purposes.

-p port

species an optional UDP port to use if the default

of 1234 is not being used.

-d causes the daemon stay running in the foreground of

the terminal in which it was executed. The default is to automat

ically detach from the terminal and run in the background.

server specifies the name of the Dynamic Gateway Route

Server.

network/mask

specifes the encapsulated route you wish routed to

you. This should be supplied in CIDR format, ie. 44.136.8.0/24

would specify the network address 44.136.8.0 and a netmask of

255.255.255.0; 24 bits.

AUTHORS

dgclient was written by Terry Dawson <terry@tao.lin

ux.org.au> and based on the protocol described by the MFNOS im

plementation developed by Barry Siegfried, K2MF. Bug reports

should be sent to <terry@tao.linux.org.au> or <terry@gugliel

mo.vk2ktj.ampr.org>.

SEE ALSO

dgserver(8)

Terry Dawson 26 Jan 1999

DGCLIENT(8)