---
name: "gfs_acl_set_file"
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_set_file"
---

# gfs\_acl\_set\_file(3)

set a Gfarm ACL by filename

## NAME

gfs\_acl\_set\_file - set a Gfarm ACL by filename

## SYNOPSIS

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

**gfarm\_error\_t gfs\_acl\_set\_file(const char \****gfarm\_url***, gfarm\_acl\_type\_t** *type***, gfarm\_acl\_t** *acl***);**

## INPUT ARGUMENTS

*gfarm\_url*

A path name in the Gfarm filesystem.

*type*

GFARM\_ACL\_TYPE\_ACCESS (to set the access ACL) or GFARM\_ACL\_TYPE\_DEFAULT (to set the default ACL).

*acl*

An ACL structure type which is sorted.

## RETURN VALUES

**GFARM\_ERR\_NO\_ERROR**

The function terminated successfully.

**GFARM\_ERR\_INVALID\_ARGUMENT**

The argument acl does not point to a valid ACL.

Others

An error except the above occurred. The reason is shown by **gfarm\_error\_string**(3).

## SEE ALSO

[**gfs\_acl\_valid**(3)](/gfs_acl_valid/3.md), [**gfs\_acl\_check**(3)](/gfs_acl_check/3.md), [**gfs\_acl\_sort**(3)](/gfs_acl_sort/3.md), [**gfs\_acl\_delete\_def\_file**(3)](/gfs_acl_delete_def_file/3.md), [**gfs\_acl\_get\_file**(3)](/gfs_acl_get_file/3.md), **gfs\_attr**(5)