diff options
author | Derrell Lipman <derrell@dworkin.(none)> | 2010-04-13 20:32:14 +0200 |
---|---|---|
committer | Karolin Seeger <kseeger@samba.org> | 2010-05-06 14:08:39 +0200 |
commit | a9221148fc9b4c390cbf7b9a115a843ada4db189 (patch) | |
tree | 86d939e00b80a2155f236cec427d831cc9201faf | |
parent | 966dc709f29c93561605e77e0df10d3331971e21 (diff) | |
download | samba-a9221148fc9b4c390cbf7b9a115a843ada4db189.tar.gz |
s3-libsmbclient: Fix incomplete description of function return values in libsmbclient.h.
Fix bug #7345.
(cherry picked from commit ce565b0498608714e2c4f7c9f9373dddcbfba568)
(cherry picked from commit 8dd1f920fb74d62a8f841a81f38feb0b0d689cc8)
-rw-r--r-- | source3/include/libsmbclient.h | 22 |
1 files changed, 14 insertions, 8 deletions
diff --git a/source3/include/libsmbclient.h b/source3/include/libsmbclient.h index 869aeb6a032..3ce783585f1 100644 --- a/source3/include/libsmbclient.h +++ b/source3/include/libsmbclient.h @@ -1256,13 +1256,15 @@ int smbc_creat(const char *furl, mode_t mode); * * @param bufsize Size of buf in bytes * - * @return Number of bytes read, < 0 on error with errno set: + * @return Number of bytes read; + * 0 upon EOF; + * < 0 on error, with errno set: * - EISDIR fd refers to a directory * - EBADF fd is not a valid file descriptor or - * is not open for reading. + * is not open for reading. * - EINVAL fd is attached to an object which is - * unsuitable for reading, or no buffer passed or - * smbc_init not called. + * unsuitable for reading, or no buffer passed or + * smbc_init not called. * * @see smbc_open(), smbc_write() * @@ -1607,7 +1609,8 @@ int smbc_stat(const char *url, struct stat *st); * @param st pointer to a buffer that will be filled with * standard Unix struct stat information. * - * @return EBADF filedes is bad. + * @return 0 on success, < 0 on error with errno set: + * - EBADF filedes is bad. * - EACCES Permission denied. * - EBADF fd is not a valid file descriptor * - EINVAL Problems occurred in the underlying routines @@ -1628,7 +1631,8 @@ int smbc_fstat(int fd, struct stat *st); * @param st pointer to a buffer that will be filled with * standard Unix struct statvfs information. * - * @return EBADF filedes is bad. + * @return 0 on success, < 0 on error with errno set: + * - EBADF filedes is bad. * - EACCES Permission denied. * - EBADF fd is not a valid file descriptor * - EINVAL Problems occurred in the underlying routines @@ -1651,7 +1655,8 @@ smbc_statvfs(char *url, * @param st pointer to a buffer that will be filled with * standard Unix struct statvfs information. * - * @return EBADF filedes is bad. + * @return 0 on success, < 0 on error with errno set: + * - EBADF filedes is bad. * - EACCES Permission denied. * - EBADF fd is not a valid file descriptor * - EINVAL Problems occurred in the underlying routines @@ -1673,7 +1678,8 @@ smbc_fstatvfs(int fd, * * @param size size to truncate the file to * - * @return EBADF filedes is bad. + * @return 0 on success, < 0 on error with errno set: + * - EBADF filedes is bad. * - EACCES Permission denied. * - EBADF fd is not a valid file descriptor * - EINVAL Problems occurred in the underlying routines |