ug_display_width(3C)ug_display_width(3C)NAMEug_display_width() - get current display width for user and group names
SYNOPSISDESCRIPTION
The function returns the current display width for user and group
names. This value determines how many bytes of a user or group name
that system and conforming applications will display.
On a system with long user and group names enabled, the default display
width for the system is set with the command (see lugadmin(1M)). Users
can override the default value by setting the environment variable to
an integer value in the range to
Application Usage
System and conforming applications use the return value (current dis‐
play width) for formatted output as follows:
Long user and group names are not configured on the system.
Display user and group names as per default set‐
tings.
Long user and group name are enabled but display user and group
names
as per default settings. For user and group names
longer (in bytes) than the default allowable
length, truncate the name to the maximum default
length and replace the last printed character with
a plus sign
If the name is longer (in bytes) than the current display width,
truncate the name to this length (in bytes) and
replace the last printed character with a plus sign
EXTERNAL INFLUENCES
Environment Variables
If it is set and long user and group names are enabled,
it overrides the width that is specified by the command for all
system and conforming applications that write formatted output.
RETURN VALUE
returns one of the following values:
Long user and group names are not enabled, or an internal error
occurred.
Long user and group names are enabled but set to default value.
The current display width for long user and group names.
WARNINGS
It is recommended that you do not modify the file directly. Doing so
could cause incorrect behavior.
FILES
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 command.
SEE ALSOlugadmin(1M).
ug_display_width(3C)