acl_get_fd.3




ACL_GET_FD(3) BSD Library Functions Manual ACL_GET_FD(3)

NAME

acl_get_fd — get an ACL by file descriptor

LIBRARY

Linux Access Control Lists library (libacl, −lacl).

SYNOPSIS

#include <sys/types.h>
#include <sys/acl.h>

acl_t

acl_get_fd(int fd);

DESCRIPTION

The acl_get_fd() function retrieves the access ACL associated with the file referred to by fd. The ACL is placed into working storage and acl_get_fd() returns a pointer to that storage.

In order to read an ACL from an object, a process must have read access to the object’s attributes.

This function may cause memory to be allocated. The caller should free any releasable memory, when the new ACL is no longer required, by calling acl_free(3) with the (void*)acl_t returned by acl_get_fd() as an argument.

RETURN VALUE

On success, this function shall return a pointer to the working storage. On error, a value of (acl_t)NULL shall be returned, and errno is set appropriately.

ERRORS

If any of the following conditions occur, the acl_get_fd() function returns a value of (acl_t)NULL and sets errno to the corresponding value:

[EBADF]

The fd argument is not a valid file descriptor.

[ENOMEM]

The ACL working storage requires more memory than is allowed by the hardware or system-imposed memory management constraints.

[ENOTSUP]

The file system on which the file identified by fd is located does not support ACLs, or ACLs are disabled.

STANDARDS

IEEE Std 1003.1e draft 17 (“POSIX.1e”, abandoned)

SEE ALSO

acl_free(3), acl_get_entry(3), acl_get_file(3), acl_set_fd(3), acl(5)

AUTHOR

Derived from the FreeBSD manual pages written by Robert N M Watson ⟨ rwatson@FreeBSD.org⟩ , and adapted for Linux by Andreas Gruenbacher ⟨ a.gruenbacher@bestbits.at⟩ .

Linux ACL March 23, 2002 Linux ACL



More Linux Commands

manpages/pacmd.1.html
pacmd(1) - Reconfigure a PulseAudio sound server during runt
This tool can be used to introspect or reconfigure a running PulseAudio sound server during runtime. It connects to the sound server and offers a simple live sh

manpages/tac.1.html
tac(1) - concatenate and print files in reverse (Man Page)
Write each FILE to standard output, last line first. With no FILE, or when FILE is -, read standard input. Mandatory arguments to long options are mandatory for

manpages/XAllocClassHint.3.html
XAllocClassHint(3) - allocate class hints structure and set
The XAllocClassHint function allocates and returns a pointer to a XClassHint structure. Note that the pointer fields in the XClassHint structure are initially s

manpages/cuserid.3.html
cuserid(3) - get username (Library - Linux man page)........
getlogin() returns a pointer to a string containing the name of the user logged in on the controlling terminal of the process, or a null pointer if this informa

manpages/vfs_xattr_tdb.8.html
vfs_xattr_tdb(8) - Save Extended Attributes (EAs) in a tdb f
This VFS module is part of the samba(7) suite. The vfs_xattr_tdb VFS module stores Extended Attributes (EAs) in a tdb file. This enables the usage of Extended A

manpages/xml_merge.1.html
xml_merge(1) (Commands - Linux manual page)................
xml_merge takes several xml files that have been split using xml_split and recreates a single file. OPTIONS -o &lt;output_file&gt; unless this option is used the prog

manpages/SDL_SetTimer.3.html
SDL_SetTimer(3) - Set a callback to run after the specified
Set a callback to run after the specified number of milliseconds has elapsed. The callback function is passed the current timer interval and returns the next ti

manpages/XkbTranslateKeyCode.3.html
XkbTranslateKeyCode(3) - Translate a keycode to a key symbol
mods_rtrn is backfilled with the modifiers consumed by the translation process. mods is a bitwise inclusive OR of the legal modifier masks: ShiftMask, LockMask,

manpages/setfont.8.html
setfont(8) - load EGA/VGA console screen font (Man Page)....
The setfont command reads a font from the file font.new and loads it into the EGA/VGA character generator, and optionally outputs the previous font. It can also

manpages/XtRegisterCaseConverter.3.html
XtRegisterCaseConverter(3) - convert KeySym to KeyCodes.....
The XtSetKeyTranslator function sets the specified procedure as the current key translator. The default translator is XtTranslateKey, an XtKeyProc that uses Shi

manpages/vncconfig.1.html
vncconfig(1) configure and control a VNC server (Man Page)
vncconfig is used to configure and control a running instance of Xvnc, or any other X server with the VNC extension. Note that it cannot be used to control VNC

manpages/XtAppAddInput.3.html
XtAppAddInput(3) - register and remove an input source......
The XtAppAddInput function registers with the Intrinsics read routine a new source of events, which is usually file input but can also be file output. Note that





We can't live, work or learn in freedom unless the software we use is free.