acltostr_r man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

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,  fea‐
       tures  described	 in this manual entry are likely to change in a future
       release.

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

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  sys‐
       tem.

AUTHOR
       was developed by HP.

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

								  acltostr(3C)
[top]

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]
Tweet
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