libexplain
1.4.D001
|
00001 /* 00002 * libexplain - Explain errno values returned by libc functions 00003 * Copyright (C) 2008, 2009, 2011, 2013 Peter Miller 00004 * Written by Peter Miller <pmiller@opensource.org.au> 00005 * 00006 * This program is free software; you can redistribute it and/or modify 00007 * it under the terms of the GNU Lesser General Public License as 00008 * published by the Free Software Foundation; either version 3 of the 00009 * License, or (at your option) any later version. 00010 * 00011 * This program is distributed in the hope that it will be useful, 00012 * but WITHOUT ANY WARRANTY; without even the implied warranty of 00013 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 00014 * Lesser General Public License for more details. 00015 * 00016 * You should have received a copy of the GNU Lesser General Public License 00017 * along with this program. If not, see <http://www.gnu.org/licenses/>. 00018 */ 00019 00020 #include <libexplain/is_efault.h> 00021 #include <libexplain/stream_to_fildes.h> 00022 00023 00024 int 00025 explain_stream_to_fildes(FILE *fp) 00026 { 00027 /* 00028 * The Linux fclose(3) man page says 00029 * 00030 * "RETURN VALUE: Upon successful completion 0 is returned. 00031 * Otherwise, EOF is returned and the global variable errno is 00032 * set to indicate the error. In either case any further access 00033 * (including another call to fclose()) to the stream results in 00034 * undefined behavior." 00035 * 00036 * which is interesting because if close(2) fails, the file 00037 * descriptor is usually still open. Thus, we make an attempt 00038 * to recover the file descriptor, to see if we can produce some 00039 * additional information. 00040 * 00041 * If you are using glibc you are plain out of luck, because 00042 * it very carefully assigns -1 to the file descriptor member. 00043 * Other implementations may not be so careful, indeed other 00044 * implementations may keep the FILE pointer valid if the underlying 00045 * file descriptor is still valid. 00046 */ 00047 if (explain_is_efault_pointer(fp, sizeof(*fp))) 00048 return -1; 00049 return fileno(fp); 00050 } 00051 00052 00053 /* vim: set ts=8 sw=4 et : */