libexplain
1.4.D001
|
00001 /* 00002 * libexplain - Explain errno values returned by libc functions 00003 * Copyright (C) 2010, 2013, 2014 Peter Miller 00004 * 00005 * This program is free software; you can redistribute it and/or modify it 00006 * under the terms of the GNU Lesser General Public License as published by 00007 * the Free Software Foundation; either version 3 of the License, or (at 00008 * your option) any later version. 00009 * 00010 * This program is distributed in the hope that it will be useful, but 00011 * WITHOUT ANY WARRANTY; without even the implied warranty of 00012 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser 00013 * General Public License for more details. 00014 * 00015 * You should have received a copy of the GNU Lesser General Public License 00016 * along with this program. If not, see <http://www.gnu.org/licenses/>. 00017 */ 00018 00019 #include <libexplain/ac/errno.h> 00020 00021 #include <libexplain/buffer/ebadf.h> 00022 #include <libexplain/buffer/errno/fpurge.h> 00023 #include <libexplain/buffer/errno/generic.h> 00024 #include <libexplain/buffer/is_the_null_pointer.h> 00025 #include <libexplain/buffer/stream.h> 00026 #include <libexplain/explanation.h> 00027 #include <libexplain/stream_to_fildes.h> 00028 00029 00030 static void 00031 explain_buffer_errno_fpurge_system_call(explain_string_buffer_t *sb, int errnum, 00032 FILE *fp) 00033 { 00034 (void)errnum; 00035 explain_string_buffer_puts(sb, "fpurge(fp = "); 00036 explain_buffer_stream(sb, fp); 00037 explain_string_buffer_putc(sb, ')'); 00038 } 00039 00040 00041 void 00042 explain_buffer_errno_fpurge_explanation(explain_string_buffer_t *sb, int errnum, 00043 const char *syscall_name, FILE *fp) 00044 { 00045 if (fp == NULL) 00046 { 00047 /* 00048 * Caution: this is one particularly nasty part of the <stdio.h> 00049 * API. Actually it means "flush all streams". Given that we 00050 * have no access to stdio's list, we can't tell you what went 00051 * wrong. 00052 */ 00053 explain_buffer_is_the_null_pointer(sb, "fp"); 00054 return; 00055 } 00056 00057 /* 00058 * http://www.opengroup.org/onlinepubs/009695399/functions/fpurge.html 00059 */ 00060 switch (errnum) 00061 { 00062 case EBADF: 00063 { 00064 int fildes; 00065 00066 fildes = explain_stream_to_fildes(fp); 00067 explain_buffer_ebadf(sb, fildes, "fp"); 00068 } 00069 break; 00070 00071 default: 00072 explain_buffer_errno_generic(sb, errnum, syscall_name); 00073 break; 00074 } 00075 } 00076 00077 00078 void 00079 explain_buffer_errno_fpurge(explain_string_buffer_t *sb, int errnum, FILE *fp) 00080 { 00081 explain_explanation_t exp; 00082 00083 explain_explanation_init(&exp, errnum); 00084 explain_buffer_errno_fpurge_system_call(&exp.system_call_sb, errnum, fp); 00085 explain_buffer_errno_fpurge_explanation(&exp.explanation_sb, errnum, 00086 "fpurge", fp); 00087 explain_explanation_assemble(&exp, sb); 00088 } 00089 00090 00091 /* vim: set ts=8 sw=4 et : */