NAME

       explain_filename_from_fildes - obtain filename from file descriptor

SYNOPSIS

       #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.4
       Copyright (C) 2012 Peter Miller

AUTHOR

       Written by Peter Miller <pmiller@opensource.org.au>

                                                                  explain_filename_from_fildes(3)