HP B2355-92068 Instruction Manual

HP-UX Reference
Section 1M: System Administration Commands
(A-M)
HP-UX 11i Version 2 December 2007 Update
Volume 3 of 10
Manufacturing Part Number : B2355-92068
E1207
Printed in USA
© Copyright 1983-2007 Hewlett-Packard Development Company LP.

2
Legal Notices
The information in this document is subject to change without notice.
Warranty
The only warranties for HP products and services are set forth in the
express warranty statements accompanying such products and services.
Nothing herein should be construed as constituting an additional
warranty. HP shall not be liable for technical or editorial errors or
omissions contained herein.
U.S. Government License
Confidential computer software. Valid license from HP required for
possession, use, or copying. Consistent with FAR 12.211 and 12.212,
Commercial Computer Software, Computer Software Documentation,
and Technical Data forCommercial Items are licensed to the U.S.
Government under vendor’s standard commercial license.
Additional Copyright Notices
This document and the software it describes may also be protected under
one or more of the following copyrights. Additional copyrights are
acknowledged in some individual manpages.
Copyright 1979, 1980, 1983, 1985-1993 The Regents of the University
of California.
Copyright 1980, 1984, 1986 Novell, Inc.
Copyright 1985, 1986, 1988 Massachusetts Institute of Technology
Copyright 1986-2000 Sun Microsystems, Inc.
Copyright 1988 Carnegie Mellon University
Copyright 1989-1991 The University of Maryland
Copyright 1989-1993 The Open Software Foundation, Inc.
Copyright 1990 Motorola, Inc.
Copyright 1990-1992 Cornell University
Copyright 1991-2003 Mentat, Inc.

3
Copyright 1996 Morning Star Technologies, Inc.
Copyright 1996 Progressive Systems, Inc.
Trademark Notices
Intel and Itanium are registered trademarks of Intel Corporation in the
US and other countries and are used under license.
Java is a US trademark of Sun Microsystems, Inc.
Microsoft and MS-DOS are U.S. registered trademarks of Microsoft
Corporation.
OSF/Motif is a trademark of The Open Group in the US and other
countries.
UNIX is a registered trademark of The Open Group.
X Window System is a trademark of The Open Group.

4

5
Preface
HP-UX is the Hewlett-Packard Company’s implementation of a UNIX
operating system that is compatible with various industry standards. It
is based on the System V Release 4 operating system and includes
important features from the Fourth Berkeley Software Distribution.
The ten volumes of this manual contain the system reference
documentation, made up of individual entries called manpages, named
for the man command (see man (1)) that displays them on the system.
The entries are also known as manual pages or reference pages.
General
Introduction
For a general introduction to HP-UX and the structure and format of the
manpages, please see the introduction (9) manpage in volume 10.
Section
Introductions
The manpages are divided into sections that also have introduction
(intro) manpages that describe the contents. These are:
intro (1) Section 1: User Commands
(A-M in volume 1; N-Z in volume 2)
intro (1M) Section 1M: System Administration Commands
(A-M in volume 3; N-Z in volume 4)
intro (2) Section 2: System Calls
(in volume 5)
intro (3C) Section 3: Library Functions
(A-M in volume 6; N-Z in volume 7)
intro (4) Section 4: File Formats
(in volume 8)
intro (5) Section 5: Miscellaneous Topics
(in volume 9)
intro (7) Section 7: Device (Special) Files
(in volume 10)
intro (9) Section 9: General Information
(in volume 10)
Index Index, All Volumes
(in volume 10)

6
Typographical Conventions
audit (5) An HP-UX manpage reference. For example, audit is
the name and 5is the section in the HP-UX Reference.
On the web and on the Instant Information CD or
DVD, it may be a hyperlink to the manpage itself. From
the HP-UX command line, you can enter “man audit”
or “man 5 audit” to view the manpage. See man (1).
Book Title The title of a book. On the web and on the Instant
Information CD or DVD, it may be a hyperlink to the
book itself.
Command A command name or qualified command phrase.
ComputerOutput Text displayed by the computer.
Emphasis Text that is emphasized.
Emphasis Text that is strongly emphasized.
ENVIRONVAR The name of an environment variable.
[ERRORNAME] The name of an error number, usually returned in the
errno variable.
KeyCap The name of a (usually) nonprinting keyboard key, such
as Ctrl-X or Tab. Note that Return and Enter both refer to
the same key.
Replaceable The name for a value that you replace in a command or
function, or information in a display that represents
several possible values.
Term The defined use of an important word or phrase.
UserInput Commands and other text that you type.
$User command prompt.
#Superuser (root) command prompt.

7
Command Syntax
Literal A word or character that you enter literally.
Replaceable A word or phrase that you replace with an appropriate
value.
- chars One or more grouped command options, such as -ikx.
The chars are usually a string of literal characters
that each represent a specific option. For example, the
entry -ikx is equivalent to the individual options -i,
-k, and -x. The plus character (+) is sometimes used as
an option prefix.
- word A single command option, such as -help. The word is a
literal keyword. The difference from - chars is usually
obvious and is clarified in an Options description. The
plus character (+) and the double hyphen (--) are
sometimes used as option prefixes.
[ ] The bracket metacharacters enclose optional content in
formats and command descriptions.
{ } The brace metacharacters enclose required content in
formats and command descriptions.
| The bar metacharacter separates alternatives in a list
of choices, usually in brackets or braces.
... The ellipsis metacharacter after a token ( abc ...) or a
right bracket ([ ]...) or a right brace ({ }...)
metacharacter indicates that the preceding element
and its preceding whitespace, if any, may be repeated
an arbitrary number of times.
... Ellipsis is sometimes used to indicate omitted items in
a range.

8
Function Synopsis and Syntax
HP-UX functions are described in a definition format rather than a
usage format. The definition format includes type information that is
omitted when the function call is actually included in a program.
The function syntax elements are the same as for commands, except for
the options; see “Command Syntax” on page 7.
Function General
Definition
The general definition form is:
type func ( type param [, type param ]... );
For example:
int setuname ( const char * name , size_t namelen );
Function Usage The usage form is:
func ( param [, param ]... );
For example:
setuname ( name [, namelen ]... );

9
Publishing History
Revisions of the HP-UX Reference are published with each initial version
release and at significant update milestones for each release. The
contents are current as of the publication dates. Since manpages are
often updated in software patches, you can find the latest version of a
manpage on an appropriately patched system, using the man command.
The list below is in reverse order of the date of publication.
Part Number Release; Date; Format; Distribution
B3921-60631 HP-UX 11i Version 2; December 2007 Update; one
volume HTML; http://docs.hp.com and Instant
Information.
B2355-92066-75 HP-UX 11i Version 2; December 2007 Update; ten
volumes PDF; http://docs.hp.com and print.
B2355-60130 HP-UX 11i Version 3; February 2007 Release; one
volume HTML; http://docs.hp.com and Instant
Information.
B2355-91017-26 HP-UX 11i Version 3; February 2007 Release; ten
volumes PDF; http://docs.hp.com, Instant Information
and print.
B2355-60127 HP-UX 11i Version 1; September 2005 Update; one
volume HTML; http://docs.hp.com and Instant
Information.
B2355-90902-11 HP-UX 11i Version 1; September 2005 Update; ten
volumes PDF; http://docs.hp.com and print.
B2355-60105 HP-UX 11i Version 2; September 2004 Update; one
volume HTML; http://docs.hp.com and Instant
Information.
B2355-90839-48 HP-UX 11i Version 2; September 2004 Update; ten
volumes PDF; http://docs.hp.com and print.
B2355-60103 HP-UX 11i Version 2; August 2003 Release; one volume
HTML; http://docs.hp.com and Instant Information.
B2355-90779-87 HP-UX 11i Version 2; August 2003 Release; nine
volumes PDF; http://docs.hp.com and print.
B9106-90010 HP-UX 11i Version 1.6; June 2002 Release; one volume
HTML; http://docs.hp.com and Instant Information.

10
B9106-90007-13 HP-UX 11i Version 1.5; June 2001 Release; seven
volumes HTML; http://docs.hp.com and Instant
Information.
B2355-90689-97 HP-UX 11i Version 1; December 2000 Release; nine
volumes PDF and HTML; http://docs.hp.com, Instant
Information and print.
B2355-90680-84 HP-UX 11.0; October 1997 Release; five volumes
HTML; http://docs.hp.com.
B2355-90166 HP-UX 11.0; October 1997 Release; five volumes PDF;
http://docs.hp.com.
B2355-90128-31 HP-UX 10.X; July 1996 Release; five volumes PDF and
HTML; http://docs.hp.com.
B2355-90052 HP-UX 10.0; July 1995 Release; four volumes PDF.
HP Encourages Your Comments
HP encourages your comments regarding this document. We are
committed to providing documentation that meets your needs. Send any
errors found, suggestions for improvement, or compliments to:
[e-mail]
Include the document title, manufacturing part number, and your
comment, error found, or suggestion for improvement that you have
concerning this document.