This wraps the
close() call. In case of error, %errno will be
preserved, but the error will also be stored as a
In case of success, %errno is undefined.
GError, there is another major reason to prefer this
function over the call provided by the system; on Unix, it will
attempt to correctly handle
EINTR, which has platform-specific semantics.
It is a bug to call this function with an invalid file descriptor.
Since 2.76, this function is guaranteed to be async-signal-safe if (and only
fd is a valid open file descriptor.
Available since: 2.36
A file descriptor.
The return location for a recoverable error.
The argument can be
If the return location is not
NULL, then you must initialize it to a
The argument will be left initialized to
NULLby the function if there are no errors.
In case of error, the argument will be set to a newly allocated
GError; the caller will take ownership of the data, and be responsible for freeing it.