libexplain
1.4.D001
|
00001 /* 00002 * libexplain - Explain errno values returned by libc functions 00003 * Copyright (C) 2010, 2011, 2013 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 00012 * ofMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNULesser 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/efault.h> 00022 #include <libexplain/buffer/einval.h> 00023 #include <libexplain/buffer/enomem.h> 00024 #include <libexplain/buffer/errno/generic.h> 00025 #include <libexplain/buffer/errno/setenv.h> 00026 #include <libexplain/buffer/int.h> 00027 #include <libexplain/buffer/is_the_null_pointer.h> 00028 #include <libexplain/buffer/pathname.h> 00029 #include <libexplain/explanation.h> 00030 #include <libexplain/is_efault.h> 00031 00032 00033 static void 00034 explain_buffer_errno_setenv_system_call(explain_string_buffer_t *sb, int errnum, 00035 const char *name, const char *value, int overwrite) 00036 { 00037 (void)errnum; 00038 explain_string_buffer_puts(sb, "setenv(name = "); 00039 explain_buffer_pathname(sb, name); 00040 explain_string_buffer_puts(sb, ", value = "); 00041 explain_buffer_pathname(sb, value); 00042 explain_string_buffer_puts(sb, ", overwrite = "); 00043 explain_buffer_int(sb, overwrite); 00044 explain_string_buffer_putc(sb, ')'); 00045 } 00046 00047 00048 void 00049 explain_buffer_errno_setenv_explanation(explain_string_buffer_t *sb, int errnum, 00050 const char *syscall_name, const char *name, const char *value, 00051 int overwrite) 00052 { 00053 /* 00054 * http://www.opengroup.org/onlinepubs/009695399/functions/setenv.html 00055 */ 00056 (void)value; 00057 (void)overwrite; 00058 switch (errnum) 00059 { 00060 case EINVAL: 00061 explain_buffer_einval_setenv(sb, name, "name"); 00062 break; 00063 00064 case ENOMEM: 00065 explain_buffer_enomem_user(sb, 0); 00066 break; 00067 00068 case EFAULT: 00069 if (!name) 00070 { 00071 explain_buffer_is_the_null_pointer(sb, "name"); 00072 break; 00073 } 00074 if (explain_is_efault_string(name)) 00075 { 00076 explain_buffer_efault(sb, "name"); 00077 break; 00078 } 00079 if (!value) 00080 { 00081 /* 00082 * While glibc treats value==NULL as meaning unsetenv, this is not 00083 * documented, and other systems may be less forgiving. 00084 */ 00085 explain_buffer_is_the_null_pointer(sb, "value"); 00086 break; 00087 } 00088 if (explain_is_efault_string(value)) 00089 { 00090 explain_buffer_efault(sb, "value"); 00091 break; 00092 } 00093 /* Fall through... */ 00094 00095 default: 00096 explain_buffer_errno_generic(sb, errnum, syscall_name); 00097 break; 00098 } 00099 } 00100 00101 00102 void 00103 explain_buffer_errno_setenv(explain_string_buffer_t *sb, int errnum, const char 00104 *name, const char *value, int overwrite) 00105 { 00106 explain_explanation_t exp; 00107 00108 explain_explanation_init(&exp, errnum); 00109 explain_buffer_errno_setenv_system_call(&exp.system_call_sb, errnum, name, 00110 value, overwrite); 00111 explain_buffer_errno_setenv_explanation(&exp.explanation_sb, errnum, 00112 "setenv", name, value, overwrite); 00113 explain_explanation_assemble(&exp, sb); 00114 } 00115 00116 00117 /* vim: set ts=8 sw=4 et : */