The nlist command allows you to view objects on the network and
the properties of those objects. Searching on objects and properties
allows you to view specific groups of objects.
The format of the nlist command can be quite complex, depending
on the object_type specified. See
``Object-specific syntax''
for a complete list of formats for each class_type supported.
The parameters to the nlist command are shown in the following
list:
class_type
Specify an object type. Object types supported for NetWare® 4 Directory
Services (NDS) are:
alias,
bindery object, bindery queue, computer,
country, directory map, group,
netware server, organization, organizational
role, organizational unit, print server,
printer, profile, queue, unknown,
user, and volume. Class types that contain embedded
spaces must be enclosed in quotation marks (for example, ``bindery
object'').
For bindery servers (NetWare 3), only group, queue,
server, user, or volume may be specified
as a class_type.
object_name
Specify the name of the specific object you want information about.
Object names that contain embedded spaces must be enclosed in quotation
marks (for example, ``US Sales'').
property_search_spec
Specify property criteria for selecting objects, and specify the
properties to display. See
``Property search specifications''
for more information.
options
Specify one or more options; see
``Options''
for a list.
Property search specifications
The general syntax of the optional property search specification is:
The where clause of the specification describes the objects that
you want the nlist command to select from all accessible objects
of the specified class_type, or the object specified with
the object_name parameter.
The value you specify for a particular property depends on the
property. For example, a description property would take a string
value, while "password minimum length" would take an integer value.
The show clause tells nlist which property (or, for
bindery servers, property group) you want to display for the objects
selected by the where clause. If there is no where
clause, the show clause displays the given property for the
object specified with the object_name parameter or for all
objects of the specific object_type.
There can be at most one where clause and one show clause in any
nlist command.
Property search operators
Choose operator from the following list to search for a specific
property value or a range of property values.
EQ or =
equals
LT
less than
GT
greater than
NE
does not equal
LE
less than or equal to
GE
greater than or equal to
NDS object classes and properties
The following list gives the object classes and the properties associated
with them.
alias
ACL, Aliased Object Name, Back Link, Bindery Property, Object Class.
ACL, Back Link, Bindery Property, CN, Description, L,
Login Script, O, Object Class, See Also.
queue
ACL, Back Link, Bindery Property, CN, Description,
Device, Host Resource Name, Host Server, L, Network Address, O, Object Class,
Operator, OU, Queue Directory, See Also, Server, User, Volume.
unknown
ACL, Back Link, Bindery Property, Object Class.
user
Account Balance, ACL, Allow Unlimited Credit, Back Link,
Bindery Property, CN, Description, email Address,
Facsimile Telephone Number, Full Name, Generational Qualifier, Given Name,
Group Membership, Higher Privileges, Home Directory, Initials, L, Language,
Last Login Time, Locked By Intruder, Login Allowed Time Map, Login Disabled,
Login Expiration Time, Login Grace Limit, Login Grace Remaining,
Login Intruder Address, Login Intruder Attempts, Login Intruder Reset Time,
Login Maximum Simultaneous, Login Script, Login Time, Mailbox ID,
Mailbox Location, Message Server, Minimum Account Balance, Network Address,
Network Address Restrictions, Object Class, OU,
Password Allow Change, Password Expiration Interval, Password Expiration Time,
Password Minimum Length, Password Required, Password Unique Required,
Passwords Used, Physical Delivery Office Name, Postal Address,
Postal Code, Postal Office Box, Print Job Configuration, Printer Control,
Private Key, Profile, Profile Membership, Public Key, S, SA,
Security Equals To, Security Flags, See Also, Server Holds, Surname,
Telephone Number, Title, Type Creator Map, UID.
volume
ACL, Back Link, Bindery Property, CN, Description,
Host Resource Name, Host Server, L, O, Object Class, OU,
See Also, Status.
Bindery objects, their properties, and property groups
For a bindery object, you must specify a property group in show
clauses. The following table lists the object types, properties, and
property groups for bindery objects.
Name
Attachment
Status
Object ID
Network Node
Version
Accounting Installed
Maximum Volumes
Maximum Connections
Connections In Use
(All Groups)
Misc
Network
Network
Attachment Information
Attachment Information
Attachment Information
Attachment Information
Attachment Information
Attachment Information
User
Name
Network Node
Connection Number
Login Time
Object ID
Account Disabled
Account Expiration Date
Password Allow Change
Password Required
Password Force Change
Password Expiration Days
Password Expiration Date
Password Length
Unique Password
Grace Logins
Grace Logins Remaining
Maximum Connections
Last Login
Groups
Managers
Security Equals
Misc
Misc
Misc
Misc
Misc
Misc
Login Control
Login Control
Login Control
Login Control
Login Control
Login Control
Login Control
Login Control
Login Control
Login Control
Login Control
Login Control
Login Control
Groups
Managers
Security Equals
Volume
Name
Server
(All Groups)
Server
Options
The following options may be specified with the nlist
command:
-a
view a list of currently logged in users
-b[=server]
view information stored in the bindery of the specified server
(bindery servers only)
-c
scroll continuously through information
-co[=context]
set the NDS context to be searched (NDS servers only)
-d
view all object properties
-n
view object names
-s
search all levels of the NDS database, beginning at the current
context (NDS servers only)
-show [property]
view a specific property of an object
-tree
view all tree names visible from this login
-ver
prints version information for nlist
-? b
prints base option help (any other options and parameters are ignored)
-? d
prints display option help (any other options and parameters are ignored)
-? p
prints object property help (any other options and parameters are ignored)
-? r
prints property search help (any other options and parameters are ignored)
-? all
prints all help screens (any other options and parameters are ignored)
Object-specific syntax
The following table lists specific formats for retrieving various types
of information from nlist. For bindery servers, use
property_group instead of property in show
clauses. To list:
To list users whose accounts will expire by June 30, 1997:
nlist USER where "ACCOUNT EXPIRATION" LE 06-30-97
To list members of group MANAGERS:
nlist USER where "GROUP MEMBERSHIP" = MANAGERS
To list users who are currently logged in:
nlist USER -a
To list users with supervisor equivalence:
nlist USER where "SECURITY EQUAL TO" = SUPERVISOR
To list the properties of user CINDY:
nlist USER=CINDY -d
To list users managed by JOE (bindery users only):
nlist USER where MANAGERS=JOE
To list users logged in to the database:
nlist USER -a -s
To list users in the current context:
nlist USER -d
To list all login scripts in all contexts:
nlist USER show "LOGIN SCRIPT" -s
To list users whose telephone numbers begin with 4 (search subordinate
containers):
nlist USER where "TELEPHONE NUMBER" = 4"" -s
To list users in a specified context:
nlist USER -co context
To list the telephone numbers of users in the current context:
nlist USER show "TELEPHONE NUMBER"
Servers
To list servers running NetWare 4.1:
nlist SERVER where VERSION = "NOVELL NETWARE 4.10[DS]"
To list the versions of all servers:
nlist SERVER show VERSION
To list the network address of server ACCT (search all
subordinate containers) (NDS servers):
nlist SERVER=ACCT show "NETWORK ADDRESS" -s
To list the network address of server ACCT (search all
subordinate containers) (bindery servers):
nlist SERVER=ACCT show "ATTACHMENT INFORMATION"
To list servers in the current context:
nlist SERVER
To search for servers in the directory tree:
nlist SERVER -s
To see if server ACCT is up:
nlist SERVER=ACCT -a
To list servers whose name begins with ``L'':
nlist SERVER = L""
Groups
To list members of group TEMPORARY:
nlist GROUP=TEMPORARY show MEMBERS
To list groups with MSMITH as a member:
nlist GROUP where MEMBER EQ MSMITH
To list the owner of group RECORDS:
nlist GROUP=RECORDS show OWNER
To list information about group RECORDS (bindery servers only):
nlist GROUP=RECORDS show MISC
Printers
To list operators for printer P1:
nlist PRINTER=Q1 show OPERATOR
To list users for printer P1:
nlist PRINTER=Q1 show USER
To list printers whose name begins with ``P'':
nlist PRINTER where NAME = P""
To list printers in the current context and below:
nlist PRINTER -s
Print queues (bindery servers)
To list operators for print queue Q1:
nlist QUEUE=Q1 show OPERATORS
To list users for print queue Q1:
nlist QUEUE=Q1 show USERS
To list print queue names:
nlist QUEUE -n
Volumes
To list host servers where volumes beginning with ``A'' reside:
nlist VOLUME=A"*" show "HOST SERVER"
To list the bindery server where VOL1: resides:
nlist VOLUME=VOL1 show SERVER
To list the NDS server where VOL1: resides:
nlist VOLUME=VOL1 show "HOST SERVER"
Objects
To list objects named MYSERVER:
nlist "" where NAME = MYSERVER
To list objects in the current context:
nlist ""
Warnings
The nlist command will accept the wild cards and ? for object
names; however, the wild cards must be quoted in order to be interpreted
properly, since these characters are also special to the UnixWare command
line (see ``Examples'').