hpux man page for ug_display_width

ug_display_width(3C)													      ug_display_width(3C)

NAME
       ug_display_width() - get current display width for user and group names

SYNOPSIS

DESCRIPTION
       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 display 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 settings.

	      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 ALSO
       lugadmin(1M).

															      ug_display_width(3C)