Name

gfs_acl_to_text — convert a Gfarm ACL to text

Synopsis

#include <gfarm/gfarm.h>
gfarm_error_t gfs_acl_to_any_text( acl,  
  prefix,  
  separator,  
  options,  
  str_p);  
gfarm_acl_t acl;
const char *prefix;
char separator;
int options;
char **str_p;
 

INPUT ARGUMENTS

acl

An ACL structure type.

prefix

If the argument prefix is not NULL, each entry can have this character string.

separator

ACL entries are separeted by this separator character.

options

Bitwise combinations of the following OPTIONS section.

str_p

A pointer to the long text form string of the ACL.

OPTIONS

GFARM_ACL_TEXT_ABBREVIATE

Instead of the full tag type keywords, single letter abbreviations are used.

GFARM_ACL_TEXT_SOME_EFFECTIVE

A comment containing the effective permissions in some ACL entries.

GFARM_ACL_TEXT_ALL_EFFECTIVE

A comment containing the effective permissions in all ACL entries.

GFARM_ACL_TEXT_SMART_INDENT

If this option is used with the GFARM_ACL_TEXT_SOME_EFFECTIVE or GFARM_ACL_TEXT_ALL_EFFECTIVE option, the effective comment is aligned to column 40.

RETURN VALUES

GFARM_ERR_NO_ERROR

The function terminated successfully.

GFARM_ERR_NO_MEMORY

Insufficient memory was available.

Others

An error except the above occurred. The reason is shown by gfarm_error_string(3).

SEE ALSO

gfs_acl_free(3), gfs_acl_to_text(3), gfs_acl_from_text(3)