libexplain  1.4.D001
libexplain/readlink.h
Go to the documentation of this file.
00001 /*
00002  * libexplain - Explain errno values returned by libc functions
00003  * Copyright (C) 2008, 2009, 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,
00011  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00012  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00013  * Lesser 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 #ifndef LIBEXPLAIN_READLINK_H
00020 #define LIBEXPLAIN_READLINK_H
00021 
00027 #include <libexplain/gcc_attributes.h>
00028 #include <libexplain/large_file_support.h>
00029 
00030 #include <unistd.h>
00031 
00032 #ifdef __cplusplus
00033 extern "C" {
00034 #endif
00035 
00061 ssize_t explain_readlink_or_die(const char *pathname, char *data,
00062     size_t data_size);
00063 
00092 ssize_t explain_readlink_on_error(const char *pathname, char *data,
00093     size_t data_size)
00094                                                   LIBEXPLAIN_WARN_UNUSED_RESULT;
00095 
00140 const char *explain_readlink(const char *pathname, char *data, size_t data_size)
00141                                                   LIBEXPLAIN_WARN_UNUSED_RESULT;
00142 
00192 const char *explain_errno_readlink(int errnum, const char *pathname, char *data,
00193     size_t data_size)
00194                                                   LIBEXPLAIN_WARN_UNUSED_RESULT;
00195 
00239 void explain_message_readlink(char *message, int message_size,
00240     const char *pathname, char *data, size_t data_size);
00241 
00289 void explain_message_errno_readlink(char *message, int message_size, int errnum,
00290     const char *pathname, char *data, size_t data_size);
00291 
00292 #ifdef __cplusplus
00293 }
00294 #endif
00295 
00296 /* vim: set ts=8 sw=4 et : */
00297 #endif /* LIBEXPLAIN_READLINK_H */