nwsaputil(1M) nwsaputil(1M)
NAME
nwsaputil - Service Access Protocol utility
SYNOPSIS
nwsaputil [-a | -d | -q] [-t type] [-s socket] [-n name]
DESCRIPTION
Use nwsaputil to:
Stop or start advertising local server
Query the contents of the sapouts file
The nwsaputil utility lets you start and stop the advertising
of a server that resides on the local workstation. It
simultaneously adds or deletes an entry to or from the sapouts
file. It also lets you query the contents of the sapouts
file.
The sapouts file contains information about servers that have
been advertised with the "permanent" option. The permanent
option means that a server continues to be advertised even
after the termination of the process that advertised the
server, and that the server does not need to be re-advertised
after the workstation has been rebooted. The IPX stack
initialization code reads the sapouts file and automatically
advertises the indicated servers.
The options for nwsaputil are:
-a Advertise a specified server and add it to the sapouts
file. You must use the -t and -s options with this
option. You may also use the -n option to specify the
server name. If you don't use the -n option, the
configured workstation name is used as the server name.
You cannot combine this option with the -d or -q
options. You must be a privileged user to use this
option.
-d Stop advertising a specified server and delete it from
the sapouts file. You must use the -t option with this
option. You may also use the -n option to specify the
server name. If you don't use the -n option, the
configured workstation name is used as the server name.
You must be a privileged user to use this option. You
may not use the -a or -q options with this option.
Copyright 1994 Novell, Inc. Page 1
nwsaputil(1M) nwsaputil(1M)
-q Query contents of the sapouts file. You may use the -t,
-s, and -n options individually or together as a filter
of the responses. This option may not be used with the
-a or -d options.
-t Specify a server type. Replace type with the type of
server. The type may be specified in hexadecimal (0xn),
octal (0n), or decimal (n).
-s Specify a server socket number. Replace socket with the
socket number. The socket number may be specified in
hexadecimal (0xn), octal (0n), or decimal (n).
-n Specify a server name. Replace name with the server
name. The server name is case insensitive (you can use
either upper- or lower- case characters).
EXAMPLES
To advertise print server BOB with socket number 0x4068 and
add it to the sapouts file:
nwsaputil -a -s0x4068 -t0x0047 -nbob
To advertise the workstation as type 6754 with socket number
octal 467 and add it to the sapouts file:
nwsaputil -a -s0467 -t6754
To stop advertising a server called JUNK_SERVER with type 345
and remove it from sapouts file:
nwsaputil -d -t345 -njunk_server
To query all contents of sapouts file:
nwsaputil -q
To query all contents with server name LOCAL_SERVER:
nwsaputil -q -nlocal_server
FILES
/etc/netware/sapouts Permanently advertised servers file
Copyright 1994 Novell, Inc. Page 2
nwsaputil(1M) nwsaputil(1M)
SEE ALSO
nwsapinfo(1M), sapd(1M).
Copyright 1994 Novell, Inc. Page 3