---
name: "gfs_acl_to_any_text"
section: "3"
platform: "linux"
package: "libgfarm-dev"
version: "2.7.20+dfsg-1.2+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/gfs_acl_to_any_text"
---

# gfs\_acl\_to\_any\_text(3)

convert a Gfarm ACL to text

## NAME

gfs\_acl\_to\_any\_text - convert a Gfarm ACL to text

## SYNOPSIS

```
#include <gfarm/gfarm.h>
```

**gfarm\_error\_t gfs\_acl\_to\_any\_text(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_free/3.md), [**gfs\_acl\_to\_text**(3)](/gfs_acl_to_text/3.md), [**gfs\_acl\_from\_text**(3)](/gfs_acl_from_text/3.md)