mirror of https://github.com/mabam/CAP.git
118 lines
3.4 KiB
Groff
118 lines
3.4 KiB
Groff
.TH SNITCH 1 "21 Mar 1988" "Carnegie-Mellon University"
|
|
.SH NAME
|
|
snitch \- respond to AppleTalk Inter\(buPoll requests
|
|
.SH SYNOPSIS
|
|
.B snitch
|
|
[
|
|
.BI \-d " <cap-flags>"
|
|
] [
|
|
.BI \-n " <name>"
|
|
] [
|
|
.BI \-t " <type>"
|
|
] [
|
|
.BI \-f " <finderstring>"
|
|
] [
|
|
.BI \-l " <laserwriterstring>"
|
|
] [
|
|
.BI \-D n
|
|
] [
|
|
.B \-S
|
|
]
|
|
.SH DESCRIPTION
|
|
.I snitch
|
|
is a CAP program designed to run as a daemon to respond to Inter\(buPoll
|
|
requests.
|
|
It performs the same function as the "Responder" program on a Macintosh.
|
|
It registers itself as "name:type@*" via NBP, where 'name' defaults
|
|
to the host name (without the domain) and 'type' defaults to "UNIX/CAP".
|
|
You can override the default NBP name values with the
|
|
.I \-n
|
|
and
|
|
.I \-t
|
|
options.
|
|
The response packets that are sent back to Inter\(buPoll try to have useful
|
|
information about the machine you are running on and the version of CAP.
|
|
You can override this information with the
|
|
.I \-f
|
|
and
|
|
.I \-l
|
|
options.
|
|
.PP
|
|
The kinds of packets that
|
|
.I snitch
|
|
sends back are only meaningful to
|
|
Inter\(buPoll, at least for now. Also, the packet format is not documented by
|
|
Apple, so it currently is an educated guess.
|
|
.PP
|
|
To kill a
|
|
.I snitch
|
|
process cleanly, send the process a QUIT or TERM signal.
|
|
It will nbp_delete itself (as all nbp services should).
|
|
.PP
|
|
To really make this work with Inter\(buPoll, you want to modify your copy
|
|
of Inter\(buPoll on the Macintosh (with ResEdit or similar program) to
|
|
add the string "UNIX/CAP" (or your snitchtype) to the STR# resource
|
|
that specifies the kinds of expected machine types.
|
|
The first item in that STR# is a number that
|
|
indicates the number of following valid entries - add one to it and then
|
|
add "UNIX/CAP" at the end. The string list is STR# "NIP Devices".
|
|
.SH OPTIONS
|
|
.TP 10
|
|
.BI \-d " <cap-flags>"
|
|
specifies standard CAP debugging flags. See cap(3) for a list of valid
|
|
flag values.
|
|
.TP 10
|
|
.BI \-n " <name>"
|
|
specifies the NBP entity name to be used when registering
|
|
.I snitch
|
|
on the AppleTalk network. The default value is the UNIX machine host
|
|
name without the domain qualifiers.
|
|
.TP 10
|
|
.BI \-t " <type>"
|
|
specifies the NBP entity type to be used when registering
|
|
.I snitch
|
|
on the AppleTalk network. The default value is "UNIX/CAP".
|
|
.TP 10
|
|
.BI \-f " <finderstring>"
|
|
<finderstring> is a character string
|
|
that will be passed to Inter\(buPoll
|
|
to be displayed as the "Finder" version for the UNIX host.
|
|
You might use this to specify UNIX and CAP versions, for example.
|
|
The string must be no more than 100 characters long (actually, Inter\(buPoll
|
|
will only display about 60 characters) and enclosed in quotes if it contains
|
|
embedded blanks or special characters.
|
|
.TP 10
|
|
.BI \-l " <laserwriterstring>"
|
|
like the
|
|
.I \-f
|
|
option, but this string will be displayed by Inter\(buPoll as the
|
|
"LaserWriter" driver version.
|
|
.TP 10
|
|
.BI \-D n
|
|
Set
|
|
.I snitch
|
|
debugging level to
|
|
.I n.
|
|
Valid values are 1 for basic debugging messages and 2 for additional
|
|
dumps of user data. Writes to stderr.
|
|
.TP 10
|
|
.BI \-S
|
|
Tells
|
|
.I snitch
|
|
to disassociate from the terminal (like starting
|
|
.I snitch
|
|
in the background).
|
|
.SH FILES
|
|
Uses the cap file "atalk.local", usually in /etc.
|
|
.SH "SEE ALSO"
|
|
CAP(8), atis(8), cap(3)
|
|
.SH EXAMPLE
|
|
snitch -n "myCapMachine" -S
|
|
.SH DIAGNOSTICS
|
|
Are written to stderr if any debugging switches are on.
|
|
If you use the "-S" switch, you won't see anything.
|
|
.SH BUGS
|
|
Only works with Inter\(buPoll by chance, might not work with future versions.
|
|
.SH AUTHOR
|
|
Ravinder Chandhok, Carnegie-Mellon University
|