nmapmgr(1)
nmapmgr - NQS Machine Id manager program
SYNOPSIS
nmapmgr
DESCRIPTION
Nmapmgr is a program used by the NQS System Administrator or
System Operator to control the Machine ID configuration at
the local machine.
Definitions
A MID is a Machine IDentifier, or a number used to identify
a certain system in the NQS network. This is a 32 bit
unsigned integer. NQS proceses the MID internally and maps
to the ascii name through the MID database. Nmapmgr manages
the database which provides the association of the Machine
Names and Machine IDs. A Principal Name is the machine's
primary name. This is usually its unqualified host name.
An Alias is another name by which the system is known. This
can be the fully qualified domain name of the host or
another name for the host.
MID Assignment Strategies
There are two strategies for assigning MIDs within a
network. The first is to explicitly assign MIDs using a
manual scheme and the second is to implicitly assign MIDs
based on the IP numbers of the systems.
The first method requires that there be some coordination of
MID assignment, usually by having a central administration
that assigns MIDs as NQS is installed on various systems.
MIDs are usually assigned starting at 1, and each new
machine gets the next number. Alternatively, blocks of MIDs
could be given to various groups. This method uses the
Nmapmgr commands "Add Mid" to associate a Principal Name
with a machine, and then "Add Name" to add an alias to a
MID.
In the second method, the IP address of the host is used as
the Machine ID. This method uses the Nmapmgr commands "Add
Host" to add a Principal Name and MID to the database and
"Add Alias" to add an alias to the MID. Since IP addresses
are already assigned, there is no additional administration
of Machine IDs required.
The two methods are not incompatable, as MIDs can be
assigned by both methods. MID collisions are unlikely if
manually assigned MIDS are small integers. If there are no
outstanding reasons, such as for compatability with other
versions of NQS, then for new installations it is probably
easier to use the second method and assign MIDs based on IP
care must be taken to make sure that all references to the
old MID (such as pipe queue destinations) are converted to
the new.
Commands
The following paragraphs describe the syntax of each
Nmapmgr(1m) command. All command keywords are recognized
regardless of upper or lower case usage. Keyword characters
shown in uppercase indicate the smallest possible
abbreviation of the keyword for the particular command being
described.
Add Uid from_mid from_uid to_uid
Creates the mapping of the remote uid (from_uid) from
the remote system (from_mid) to the local uid (to_uid).
UID mapping is currently unimplemented in NQS.
Add Gid from_mid from_gid to_gid
Create the mapping of the remote gid (from_gid) from
the remote system (from_mid) to the local gid (to_gid).
GID mapping is currently unimplemented in NQS.
Add Alias name principal-name
Add an alias to the MID for the IP address of the
principal name.
Add Host principal-name
Create a MID for the principal name which is determined
by its IP address.
Add Name name to_mid
Add an alias to the MID indicated by the to_mid
parameter. The to_mid is an integer. This command is
used when Machine IDs are explicitly assigned.
Add Mid mid principal-name
Explicitly associate a Machine ID with a system name.
The mid is an integer. This command is used when
Machine IDs are explicitly assigned.
Change Name mid new-name
Replaces the principal name for the given Machine ID
with the new name. However, this new name is not
considered the principal name, but an alias. This is
very risky to do.
Create the necessary files in NQS_NMAP so that Machine
IDs can be added. Normally the empty database is
created automatically the first time nmapmgr is
invoked.
Delete Uid from_mid from_uid
Delete the mapping of the remote uid (from_uid) from
the remote system (from_mid). UID mapping is currently
unimplemented in NQS.
Delete Gid from_mid from_gid
Delete the mapping of the remote gid (from_gid) from
the remote system (from_mid). GID mapping is currently
unimplemented in NQS.
Delete DEFUid from_mid
Delete the mapping for the default UID for requests
from the given Machine. UID mapping is currently
unimplemented in NQS.
Delete DEFGid from_mid
Delete the mapping for the default GID for requests
from the given Machine. GID mapping is currently
unimplemented in NQS.
Delete Alias name
Delete the indicated alias for its Machine ID. This
command may be used no matter how MIDs were assigned.
Delete Host principal-name
Delete the mapping for the indicated Machine ID. All
information on that Machine ID is removed from the
database.
Delete Name name
Delete the indicated Principal Name or alias. If the
Principal Name is deleted while aliases remain, a
listing will indicate that the Principal Name is not in
the machines file.
Delete Mid mid
information on that Machine ID is removed from the
database.
Exit
Exit from the NQS Nmap manager subsystem.
Get Uid from_mid from_uid
Print the local UID associated with the remote Machine
ID and UID pair. UID mapping is currently
unimplemented in NQS.
Get Gid from_mid from_gid
Print the local GID associated with the remote Machine
Id and GID pair. GID mapping is currently
unimplemented in NQS.
Get Mid name
Display the Machine ID corresponding to the indicated
name.
Get Name mid
Print the Principal Name for the indicated Machine ID.
Help
List a one-line summary of each of the Nmapmgr
commands.
List
Display all known systems in Machine ID order, giving
the MID, Principal name, and any aliases.
Quit
Synonym for exit.
Set Nfds #-of-file-descrs
Adjust the number of file descriptors Nmapmgr uses.
This command has never been used to my knowledge.
Set DEFUid from_mid defuid
Set the mapping for the default UID for requests from
the given Machine. UID mapping is currently
Set DEFGid from_mid defgid
Set the mapping for the default GID for requests from
the given Machine. GID mapping is currently
unimplemented in NQS.
Show
Synonym for list.
Version
Display the current Nmapmgr version.
SEE ALSO
qmgr(1)
in the NPSN UNIX User Reference Manual.
NPSN HISTORY
Origin: Sterling Software Incorporated
August 1994 - John Roman, Monsanto Company
Release 3.36.