table of contents
| explain_filename_from_fildes(3) | Library Functions Manual | explain_filename_from_fildes(3) |
NAME¶
explain_filename_from_fildes - obtain filename from file descriptorSYNOPSIS¶
#include <libexplain/filename.h>int explain_filename_from_fildes(int fildes, char *data, size_t data_size);
int explain_filename_from_stream(FILE *stream, char *data, size_t data_size);
DESCRIPTION¶
The explain_filename_from_fildes function may be used to obtain the name of the file associated with the file descriptor.The explain_filename_from_stream function may be used to obtain the name of the file associated with a file stream.
The filename is returned in the array pointed to by data. The filename will always be NUL terminated. If the returned filename is longer than data_size, it will be silently truncated; a size of at least (PATH_MAX + 1) is suggested.
On success, returns zero. If the file name cannot be determined, returns -1 (but does not set errno.)
COPYRIGHT¶
libexplain version 1.4Copyright (C) 2012 Peter Miller