Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 en-
       tries 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  rep-
       resentation  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 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 in-
       stead.

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

       Note: is	complementary in function to

   Obsolescent Interface
       acltostr_r()  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  re-
       turns (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
	      [EINVAL]	  strbuf equals	to or nentries is  greater  than  (de-
			  fined	 in  form  is  not  one	of the valid forms, or
			  length of strbuf is too short.

	      [ERANGE]	  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  ex-
       isting 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)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | EXAMPLES | WARNINGS | DEPENDENCIES | AUTHOR | FILES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=acltostr&sektion=3c&manpath=HP-UX+11.22>

home | help