HP-UX Reference (11i v3 07/02) - 1M System Administration Commands A-M (vol 3)

l
lugadmin(1M) lugadmin(1M)
• lugadmin -l in shell scripts
sysconf(), getconf, and lugadmin all return either
64 (short names) or 256 (long names). See
ug_display_width(3C) for its return values.
To Determine the Current Display Width
Use one of the following procedures:
• In program code, call
ug_display_width()
.
• In a shell script,
1. Run
lugadmin -l
or getconf _SC_LOGIN_NAME_MAX
to see if long names are enabled.
If not enabled, set width to
0.
2. Else, if enabled, check for the
UG_DISPLAY_WIDTH
environment variable. If the variable is
set to a value between
9-255, set width to the value. Otherwise set width to
0.
3. Else, if not set, set width to the value in the
lugname file. Set width to 0 if the value is out of
range, not an integer, or improperly formatted.
To Use the Current Display Width
The current display width is used by all system and conforming applications to display formatted output.
See
Application Usage section of ug_display_width(3C) for usage of current display width.
EXTERNAL INFLUENCES
Environment Variables
UG_DISPLAY_WIDTH
If it is set and long names are enabled, it overrides the width specified in the
lugname file for all sys-
tem and conforming applications that write formatted output.
RETURN VALUE
lugadmin exits with one of the following values:
0 Successful completion
-1 Failure
DIAGNOSTICS
Note: System is already enabled for long user/group name
You may have attempted to use the -e option for a second time.
Error: The system is not enabled for long user/group name
You tried to use the -d option before using the -e option.
Error: Can’t create file /etc/defaults/lugname
Error: Can’t open file /etc/defaults/lugname
Error: The pwgrd daemon must be killed before enabling the system. The
daemon can be restarted once the system is enabled
system() failed
A call to the system() function failed.
WARNINGS
The lugname file is the switch that marks a long name system. If it is missing, short names are assumed
and the UG_DISPLAY_WIDTH variable is ignored.
While many programs are unaffected by long names in a short name environment, some may behave abnor-
mally and some may abort.
It is recommended that you do not attempt to restore the short name environment once long names have
been enabled.
Do not use the system constant LOGIN_NAME_MAX with the getconf command or the sysconf()
function to test for name length; it is not changed when long names are enabled.
HP-UX 11i Version 3: February 2007 − 2 − Hewlett-Packard Company 461