nlist(1nuc)


nlist -- view and search network for object information

Synopsis

nlist class_type[=object_name] [property_search_spec] [options]

Description

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:

[where] property] [operator] [value]] [show] property | property_group]]

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.

See ``NDS object classes and properties'' for a list of properties for each object type, and ``Property search operators'' for a list of operators.

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.

bindery object
ACL, Back Link, Bindery Object Restrictions, Bindery Property, Bindery Type, CN, Object Class.

bindery queue
ACL, Back Link, Bindery Property, Bindery Type, CN, Description, Device, Host Resource Name, Host Server, L, Network Address, O, Object Class, Operator, OU, Queue Directory, See Also, Server, User, Volume.

computer
ACL, Back Link, Bindery Property, CN, Description, L, Network Address, O, Object Class, Operator, OU, Owner, See Also, Serial Number, Server, Status.

country
ACL, Back Link, Bindery Property, C, Description, Object Class.

directory map
ACL, Back Link, Bindery Property, CN, Description, Host Resource Name, Host Server, L, O, Object Class, OU, Path, See Also.

group
ACL, Back Link, Bindery Property, CN, Description, email Address, Full Name, GID, L, Login Script, Mailbox ID, Mailbox Location, Member, O, Object Class, OU, Owner, Profile, Profile Membership, See Also.

NCP server
Account Balance, ACL, Allow Unlimited Credit, Back Link, Bindery Property, CN, DS Revision, Full Name, Host Device, L, Messaging Server, Minimum Account Balance, Network Address, O, Object Class, Operator, OU, Private Key, Public Key, Resource, See Also, Security Equals To, Security Flags, Status, Supported Services, User, Version.

organization
ACL, Back Link, Bindery Property, Description, Detect Intruder, email Address, Facsimile Telephone Number, Intruder Attempt Reset Interval, Intruder Lockout Reset Interval, L, Lockout After Detection, Login Intruder Limit, Login Script, Mailbox ID, Mailbox Location, NNS Domain, O, Object Class, Physical Delivery Office Name, Postal Address, Postal Code, Postal Office Box, Print Job Configuration, Printer Control, S, SA, See Also, Telephone Number.

organizational role
ACL, Back Link, Bindery Property, CN, Description, email Address, Facsimile Telephone Number, L, Mailbox ID, Mailbox Location, Object Class, OU, Physical Delivery Office Name, Postal Address, Postal Code, Postal Office Box, Role Occupant, S, SA, See Also, Telephone Number.

organizational unit
ACL, Back Link, Bindery Property, Description, Detect Intruder, email Address, Facsimile Telephone Number, Intruder Attempt Reset Interval, Intruder Lockout, L, Lockout After Detection, Login Intruder Limit, Login Script, Mailbox ID, Mailbox Location, NNS Domain, Object Class, OU, Physical Delivery Office Name, Postal Address, Postal Code, Postal Office Box, Print Job Configuration, Printer Control, Reset Interval, S, SA, See Also, Telephone Number.

print server
Account Balance, ACL, Allow Unlimited Credit, Back Link, Bindery Property, CN, Description, Full Name, Host Device, L, Minimum Account Balance, Network Address, O, Object Class, Operator, OU, Print, Private Key, Public Key, Resource, SAP Name, Security Equals To, Security Flags, See Also, Status, User, Version.

printer
ACL, Back Link, Bindery Property, Cartridge, CN, Default Queue, Description, Host Device, L, Memory, Network Address, Network Address Restrictions, Notify, O, Object Class, Operator, OU, Owner, Page Description Language, Print Server, Printer Configuration, Queue, See Also, Serial Number, Status, Supported Typefaces.

profile
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.

Object Type Properties Property Groups
Group Name
Description
Managers
Member
Object ID
(All Groups)
Misc
Managers
Members
Misc
Queue Name
Directory
Object ID
Operators
Servers
Users
(All Groups)
Directory
Misc
Operators
Servers
Users
Server 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

 
 -------------------------------------------------------------------- 
| Object Type|  Properties         |  Property Groups               | 
|------------|---------------------|--------------------------------| 
| Group      |  Name               |  (All Groups)                  | 
|            |  Description        |  Misc                          | 
|            |  Managers           |  Managers                      | 
|            |  Member             |  Members                       | 
|            |  Object ID          |  Misc                          | 
|------------|---------------------|--------------------------------| 
| Queue      |  Name               |  (All Groups)                  | 
|            |  Directory          |  Directory                     | 
|            |  Object ID          |  Misc                          | 
|            |  Operators          |  Operators                     | 
|            |  Servers            |  Servers                       | 
|            |  Users              |  Users                         | 
|------------|---------------------|--------------------------------| 
| Server     |  Name               |  (All Groups)                  | 
|            |  Attachment         |  Misc                          | 
|            |  Status             |  Network                       | 
|            |  Object ID          |  Network                       | 
|            |  Network Node       |  Attachment Information        | 
|            |  Version            |  Attachment Information        | 
|            |  Accounting         |  Attachment Information        | 
|            |  Installed          |  Attachment Information        | 
|            |  Maximum Volumes    |  Attachment Information        | 
|            |  Maximum Connections|  Attachment Information        | 
|            |  Connections In Use |                                | 
|------------|---------------------|--------------------------------| 
| User       |  Name               |  Misc                          | 
|            |  Network Node       |  Misc                          | 
|            |  Connection Number  |  Misc                          | 
|            |  Login Time         |  Misc                          | 
|            |  Object ID          |  Misc                          | 
|            |  Account Disabled   |  Misc                          | 
|            |  Account Expiration |  Login Control                 | 
|            |  Date               |  Login Control                 | 
|            |  Password Allow     |  Login Control                 | 
|            |  Change             |  Login Control                 | 
|            |  Password Required  |  Login Control                 | 
|            |  Password Force     |  Login Control                 | 
|            |  Change             |  Login Control                 | 
|            |  Password Expiration|  Login Control                 | 
|            |  Days               |  Login Control                 | 
|            |  Password Expiration|  Login Control                 | 
|            |  Date               |  Login Control                 | 
|            |  Password Length    |  Login Control                 | 
|            |  Unique Password    |  Login Control                 | 
|            |  Grace Logins       |  Groups                        | 
|            |  Grace Logins       |  Managers                      | 
|            |  Remaining          |  Security Equals               | 
|            |  Maximum Connections|                                | 
|            |  Last Login         |                                | 
|            |  Groups             |                                | 
|            |  Managers           |                                | 
|            |  Security Equals    |                                | 
|------------|---------------------|--------------------------------| 
| Volume     |  Name               |  (All Groups)                  | 
|            |  Server             |  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:

Examples

Users

To list users with password < 5 characters:

nlist USER where "PASSWORD MINIMUM LENGTH" LT 5

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'').

References

nwcx(1nuc), nwlogin(1nuc)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.