[net.sources] manual page for mkpath

mcm (03/01/83)

.TH MKPATH 1
.SH NAME
mkpath \- make a Usenet path data base
.SH SYNOPSIS
.B mkpath
[
.B \-2
] [
.B \-lsite
] [
.B \-dsite
] [
.B \-dsite1!site2
] [
.B \-asite1!site2
]
mapfiles...
.SH DESCRIPTION
.I Mkpath
creates a list of USENET sites and the UUCP routing path to each site.
The input is a list of USENET sites and what other sites each site is
connected to.  The input data should look like:
.nf

	Name: (name of site)
	(any other fields)
	Usenet: (site names separated by blanks, commas, or newlines)
	(more site names)
	UUCP: (still more site names)
	(even more site names)
	(any other fields)

.fi
Mark and Karen Horton just happen to send Usenet connection information
in this format once a month to the news group net.news.map.
The output is sent to stdout, and looks like:
.nf

	(name of site)	(printf string of how to get there)

.fi
The routes to all possible sites are listed.

.PP
Options:
.TP 6
.B \-2
Interpret all connections as two-way links.
.TP 6
.B  \-lsite
Set the originating system name to
.I site.
If this option is not used,
.I mkpath
uses the system name from <whoami.h>.
.TP 6
.B  \-dsite
Delete all references to
.I site
before building the UUCP paths.
.TP 6
.B \-dsite1!site2
Delete the connection from
.I site1
to
.I site2
before building the UUCP paths.
.TP 6
.B \-asite1!site2
Add the connection from
.I site1
to
.I site2
before building the UUCP paths.
.dt
.SH "SEE ALSO"
nmail(1)
.SH DIAGNOSTICS
Exit code 1 is returned for an invalid command line, 2 for
an inaccessible map input, 3 for starting system not in
the input data, and 4 for not enough memory.
.SH AUTHOR
Mike Mitchell  (duke!mcnc!ikonas!mcm)
.SH ACKNOWLEDGEMENTS
Mark and Karen Horton	(cbosgd!mark)
.br
John Carl Zeigler	(duke!mcnc!ncsu!jcz)
.SH BUGS
.I Mkpath assumes every site is connected via UUCP and exchanges mail.