lugadmin(1M)

NAME

lugadmin — long user and group name enablement and display

SYNOPSIS

lugadmin [-e] [-d num] [-l]

DESCRIPTION

The lugadmin command enables the support of long user and group names on the system, sets the default display width for long user and group names, and displays the current status of the system.

If no options are specified, the -l option is assumed.

Options

The following options are supported:

-e

Enable long user and group name support on the system. See the Enabling Long User and Group Names subsection below for details. This option requires superuser privileges.

-d num

Set num as the default display width for long user and group names. num can be in the range 0 to 255.

The -d option can be only be specified with the -e option or when long names have been previously enabled.

See the Setting the User and Group Name Display Width subsection below for details. This option requires superuser privileges.

-l

Display the current status of the system. The command displays one of:

64: The system is restricted to short (8-byte) user and group names.
256: The system is enabled for long (255-byte) user and group name support. A name string can be up to 255 bytes plus a trailing NULL byte.

Enabling Long User and Group Names

To enable long user and group names,

1.

Stop the pwgrd daemon.

# /sbin/init.d/pwgr stop 

2.

Run the lugadmin command with the -e option.

# lugadmin -e [-d num]

3.

The command requests confirmation before enabling the system.

Long user/group name once enabled cannot be disabled in future. 
Do you want to continue [yY]:  

If you respond with y or Y, the command proceeds; otherwise, it aborts.

4.

The command creates the /etc/default/lugname file.

5.

If the -d option is not specified, num defaults to 0. The specified or default value of num is written in lugname.

Setting the User and Group Name Display Width

The long user and group name default display width is set when lugadmin is executed with the -e option. It can be changed at any time by executing lugadmin with the -d option.

If -d is not specified with the -e option, the value of num defaults to 0.

Application Usage

To Determine the Long Name Status of a System

Use one of these:

sysconf(_SC_LOGIN_NAME_MAX) in program code; see sysconf(2) and the WARNINGS section.
ug_display_width() in program code; see ug_display_width(3C).
getconf _SC_LOGIN_NAME_MAX in shell scripts; see getconf(1) and the WARNINGS section.
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 system 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 abnormally 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.

AUTHOR

lugadmin was developed by HP.

FILES

/etc/default/lugname: If this file is present, the system is enabled for long user and group names; otherwise, it is not. This file contains the default display width, as set with the -d option.