acltostr man page on HP-UX

Printed from

acltostr(3C)							  acltostr(3C)

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

   Obsolescent Interface
       To ensure continued conformance with emerging industry standards,  fea‐
       tures  described	 in this manual entry are likely to change in a future

       converts an access control list from structure form to string represen‐
       tation.	 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  con‐
       tains newline characters.

       A user ID of and a group ID of are both represented by As with the com‐
       mand (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

       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.

       If succeeds, it returns a pointer to a null-terminated string.  If nen‐
       tries 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 nen‐
       tries is zero or less, the string is of zero length.

	      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.

       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);

       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

       is only supported on HFS file system on standard HP-UX  operating  sys‐

       was developed by HP.

       getacl(2),  setacl(2),  cpacl(3C),  chownacl(3C), setaclentry(3C), str‐
       toacl(3C), acl(5), thread_safety(5).


List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net