hpux man page for acltostr

acltostr(3C)															      acltostr(3C)

NAME
       acltostr() - convert access control list (ACL) structure to string form (HFS File Systems only)

SYNOPSIS
   Obsolescent Interface
   Remarks
       To  ensure continued conformance with emerging industry standards, features described in this manual entry are likely to change in a future
       release.

DESCRIPTION
       converts an access control list from structure form to string representation.  takes a pointer to the first element  of	an  array  of  ACL
       entries	containing the indicated number (nentries) of valid entries (zero or more), and the output form desired or It returns a pointer to
       a static string (overwritten by the next call), which is a symbolic representation of the ACL, ending in  a  null  character.   The  output
       forms are described in acl(5).  In long form, the string returned contains newline characters.

       A  user ID of and a group ID of are both represented by As with the command (see ls(1)), if an entry contains any other user ID or group ID
       value not listed in or returns a string equivalent of the ID number instead.

       Just as in routines that manage the file, truncates user and group names to eight characters.

       Note: is complementary in function to

   Obsolescent Interface
       converts access control list (ACL) structure to string form.

RETURN VALUE
       If succeeds, it returns a pointer to a null-terminated string.  If nentries is zero or less, the string is of zero length.  If nentries	is
       greater than (defined in or if form is an invalid value, the call returns (char *) NULL .

       If succeeds, it returns 0.  If it fails, it returns -1 and sets If nentries is zero or less, the string is of zero length.

ERRORS
	      strbuf	  equals  to  NULL,  or nentries is greater than (defined in or form is not one of the valid forms, or length of strbuf is
			  too short.

	      length	  is less than or equal zero.

EXAMPLES
       The following code fragment reads the ACL on file and prints its short-form representation.

	      #include <stdio.h>
	      #include <acllib.h>

	      int nentries;
	      struct acl_entry acl [NACLENTRIES];

	      if ((nentries = getacl ("/users/ggd/test", NACLENTRIES, acl)) < 0)
		   error (...);

	      fputs (acltostr (nentries, acl, FORM_SHORT), stdout);

WARNINGS
       The value returned by is a pointer into a buffer, the contents of which are overwritten by subsequent calls to by the same thread.

       is an obsolescent interface supported only for compatibility with existing DCE applications. New multithreaded applications should use

DEPENDENCIES
       is only supported on HFS file system on standard HP-UX operating system.

AUTHOR
       was developed by HP.

FILES
SEE ALSO
       getacl(2), setacl(2), cpacl(3C), chownacl(3C), setaclentry(3C), strtoacl(3C), acl(5), thread_safety(5).

																      acltostr(3C)