The Samba-Bugzilla – Attachment 2699 Details for
Bug 4053
off_t size in libsmbclient.h depends on LFS defines
Home
|
New
|
Browse
|
Search
|
[?]
|
Reports
|
Requests
|
Help
|
New Account
|
Log In
[x]
|
Forgot Password
Login:
[x]
[patch]
Proper LFS support for svn
patch-libsmbclient-64-svn (text/plain), 194.92 KB, created by
Samuel Thibault
on 2007-05-16 20:40:21 UTC
(
hide
)
Description:
Proper LFS support for svn
Filename:
MIME Type:
Creator:
Samuel Thibault
Created:
2007-05-16 20:40:21 UTC
Size:
194.92 KB
patch
obsolete
>Index: source/Makefile.in >=================================================================== >--- source/Makefile.in (révision 22956) >+++ source/Makefile.in (copie de travail) >@@ -609,7 +609,7 @@ > $(LIBREPLACE_OBJ) $(SOCKET_WRAPPER_OBJ) @BUILD_INIPARSER@ > > LIBSMBCLIENT_OBJ = libsmb/libsmbclient.o libsmb/libsmb_compat.o \ >- libsmb/libsmb_cache.o \ >+ libsmb/libsmb_cache.o libsmb/libsmb_nonlfs.o \ > $(PARAM_OBJ) $(LIB_NONSMBD_OBJ) \ > $(LIBSMB_OBJ) $(KRBCLIENT_OBJ) \ > $(LIBMSRPC_OBJ) $(LIBMSRPC_GEN_OBJ) $(RPC_PARSE_OBJ) \ >Index: source/libsmb/libsmb_compat.c >=================================================================== >--- source/libsmb/libsmb_compat.c (révision 22956) >+++ source/libsmb/libsmb_compat.c (copie de travail) >@@ -33,14 +33,14 @@ > struct smbc_compat_fdlist *next, *prev; > }; > >-static SMBCCTX * statcont = NULL; >+SMBCCTX * smbc_statcont = NULL; > static int smbc_compat_initialized = 0; > static int smbc_compat_nextfd = 0; > static struct smbc_compat_fdlist * smbc_compat_fd_in_use = NULL; > static struct smbc_compat_fdlist * smbc_compat_fd_avail = NULL; > > /* Find an fd and return the SMBCFILE * or NULL on failure */ >-static SMBCFILE * find_fd(int fd) >+SMBCFILE * smbc_find_fd(int fd) > { > struct smbc_compat_fdlist * f = smbc_compat_fd_in_use; > while (f) { >@@ -116,15 +116,15 @@ > int smbc_init(smbc_get_auth_data_fn fn, int debug) > { > if (!smbc_compat_initialized) { >- statcont = smbc_new_context(); >- if (!statcont) >+ smbc_statcont = smbc_new_context(); >+ if (!smbc_statcont) > return -1; > >- statcont->debug = debug; >- statcont->callbacks.auth_fn = fn; >+ smbc_statcont->debug = debug; >+ smbc_statcont->callbacks.auth_fn = fn; > >- if (!smbc_init_context(statcont)) { >- smbc_free_context(statcont, False); >+ if (!smbc_init_context(smbc_statcont)) { >+ smbc_free_context(smbc_statcont, False); > return -1; > } > >@@ -138,11 +138,11 @@ > > SMBCCTX *smbc_set_context(SMBCCTX * context) > { >- SMBCCTX *old_context = statcont; >+ SMBCCTX *old_context = smbc_statcont; > > if (context) { > /* Save provided context. It must have been initialized! */ >- statcont = context; >+ smbc_statcont = context; > > /* You'd better know what you're doing. We won't help you. */ > smbc_compat_initialized = 1; >@@ -157,13 +157,13 @@ > SMBCFILE * file; > int fd; > >- file = statcont->open(statcont, furl, flags, mode); >+ file = smbc_statcont->open(smbc_statcont, furl, flags, mode); > if (!file) > return -1; > > fd = add_fd(file); > if (fd == -1) >- statcont->close_fn(statcont, file); >+ smbc_statcont->close_fn(smbc_statcont, file); > return fd; > } > >@@ -173,15 +173,15 @@ > SMBCFILE * file; > int fd; > >- file = statcont->creat(statcont, furl, mode); >+ file = smbc_statcont->creat(smbc_statcont, furl, mode); > if (!file) > return -1; > > fd = add_fd(file); > if (fd == -1) { > /* Hmm... should we delete the file too ? I guess we could try */ >- statcont->close_fn(statcont, file); >- statcont->unlink(statcont, furl); >+ smbc_statcont->close_fn(smbc_statcont, file); >+ smbc_statcont->unlink(smbc_statcont, furl); > } > return fd; > } >@@ -189,37 +189,37 @@ > > ssize_t smbc_read(int fd, void *buf, size_t bufsize) > { >- SMBCFILE * file = find_fd(fd); >- return statcont->read(statcont, file, buf, bufsize); >+ SMBCFILE * file = smbc_find_fd(fd); >+ return smbc_statcont->read(smbc_statcont, file, buf, bufsize); > } > > ssize_t smbc_write(int fd, void *buf, size_t bufsize) > { >- SMBCFILE * file = find_fd(fd); >- return statcont->write(statcont, file, buf, bufsize); >+ SMBCFILE * file = smbc_find_fd(fd); >+ return smbc_statcont->write(smbc_statcont, file, buf, bufsize); > } > > off_t smbc_lseek(int fd, off_t offset, int whence) > { >- SMBCFILE * file = find_fd(fd); >- return statcont->lseek(statcont, file, offset, whence); >+ SMBCFILE * file = smbc_find_fd(fd); >+ return smbc_statcont->lseek(smbc_statcont, file, offset, whence); > } > > int smbc_close(int fd) > { >- SMBCFILE * file = find_fd(fd); >+ SMBCFILE * file = smbc_find_fd(fd); > del_fd(fd); >- return statcont->close_fn(statcont, file); >+ return smbc_statcont->close_fn(smbc_statcont, file); > } > > int smbc_unlink(const char *fname) > { >- return statcont->unlink(statcont, fname); >+ return smbc_statcont->unlink(smbc_statcont, fname); > } > > int smbc_rename(const char *ourl, const char *nurl) > { >- return statcont->rename(statcont, ourl, statcont, nurl); >+ return smbc_statcont->rename(smbc_statcont, ourl, smbc_statcont, nurl); > } > > int smbc_opendir(const char *durl) >@@ -227,77 +227,77 @@ > SMBCFILE * file; > int fd; > >- file = statcont->opendir(statcont, durl); >+ file = smbc_statcont->opendir(smbc_statcont, durl); > if (!file) > return -1; > > fd = add_fd(file); > if (fd == -1) >- statcont->closedir(statcont, file); >+ smbc_statcont->closedir(smbc_statcont, file); > > return fd; > } > > int smbc_closedir(int dh) > { >- SMBCFILE * file = find_fd(dh); >+ SMBCFILE * file = smbc_find_fd(dh); > del_fd(dh); >- return statcont->closedir(statcont, file); >+ return smbc_statcont->closedir(smbc_statcont, file); > } > > int smbc_getdents(unsigned int dh, struct smbc_dirent *dirp, int count) > { >- SMBCFILE * file = find_fd(dh); >- return statcont->getdents(statcont, file,dirp, count); >+ SMBCFILE * file = smbc_find_fd(dh); >+ return smbc_statcont->getdents(smbc_statcont, file,dirp, count); > } > > struct smbc_dirent* smbc_readdir(unsigned int dh) > { >- SMBCFILE * file = find_fd(dh); >- return statcont->readdir(statcont, file); >+ SMBCFILE * file = smbc_find_fd(dh); >+ return smbc_statcont->readdir(smbc_statcont, file); > } > > off_t smbc_telldir(int dh) > { >- SMBCFILE * file = find_fd(dh); >- return statcont->telldir(statcont, file); >+ SMBCFILE * file = smbc_find_fd(dh); >+ return smbc_statcont->telldir(smbc_statcont, file); > } > > int smbc_lseekdir(int fd, off_t offset) > { >- SMBCFILE * file = find_fd(fd); >- return statcont->lseekdir(statcont, file, offset); >+ SMBCFILE * file = smbc_find_fd(fd); >+ return smbc_statcont->lseekdir(smbc_statcont, file, offset); > } > > int smbc_mkdir(const char *durl, mode_t mode) > { >- return statcont->mkdir(statcont, durl, mode); >+ return smbc_statcont->mkdir(smbc_statcont, durl, mode); > } > > int smbc_rmdir(const char *durl) > { >- return statcont->rmdir(statcont, durl); >+ return smbc_statcont->rmdir(smbc_statcont, durl); > } > > int smbc_stat(const char *url, struct stat *st) > { >- return statcont->stat(statcont, url, st); >+ return smbc_statcont->stat(smbc_statcont, url, st); > } > > int smbc_fstat(int fd, struct stat *st) > { >- SMBCFILE * file = find_fd(fd); >- return statcont->fstat(statcont, file, st); >+ SMBCFILE * file = smbc_find_fd(fd); >+ return smbc_statcont->fstat(smbc_statcont, file, st); > } > > int smbc_chmod(const char *url, mode_t mode) > { >- return statcont->chmod(statcont, url, mode); >+ return smbc_statcont->chmod(smbc_statcont, url, mode); > } > > int smbc_utimes(const char *fname, struct timeval *tbuf) > { >- return statcont->utimes(statcont, fname, tbuf); >+ return smbc_statcont->utimes(smbc_statcont, fname, tbuf); > } > > #ifdef HAVE_UTIME_H >@@ -306,13 +306,13 @@ > struct timeval tv[2]; > > if (utbuf == NULL) >- return statcont->utimes(statcont, fname, NULL); >+ return smbc_statcont->utimes(smbc_statcont, fname, NULL); > > tv[0].tv_sec = utbuf->actime; > tv[1].tv_sec = utbuf->modtime; > tv[0].tv_usec = tv[1].tv_usec = 0; > >- return statcont->utimes(statcont, fname, tv); >+ return smbc_statcont->utimes(smbc_statcont, fname, tv); > } > #endif > >@@ -322,7 +322,7 @@ > size_t size, > int flags) > { >- return statcont->setxattr(statcont, fname, name, value, size, flags); >+ return smbc_statcont->setxattr(smbc_statcont, fname, name, value, size, flags); > } > > int smbc_lsetxattr(const char *fname, >@@ -331,7 +331,7 @@ > size_t size, > int flags) > { >- return statcont->setxattr(statcont, fname, name, value, size, flags); >+ return smbc_statcont->setxattr(smbc_statcont, fname, name, value, size, flags); > } > > int smbc_fsetxattr(int fd, >@@ -340,12 +340,12 @@ > size_t size, > int flags) > { >- SMBCFILE * file = find_fd(fd); >+ SMBCFILE * file = smbc_find_fd(fd); > if (file == NULL) { > errno = EBADF; > return -1; > } >- return statcont->setxattr(statcont, file->fname, >+ return smbc_statcont->setxattr(smbc_statcont, file->fname, > name, value, size, flags); > } > >@@ -354,7 +354,7 @@ > const void *value, > size_t size) > { >- return statcont->getxattr(statcont, fname, name, value, size); >+ return smbc_statcont->getxattr(smbc_statcont, fname, name, value, size); > } > > int smbc_lgetxattr(const char *fname, >@@ -362,7 +362,7 @@ > const void *value, > size_t size) > { >- return statcont->getxattr(statcont, fname, name, value, size); >+ return smbc_statcont->getxattr(smbc_statcont, fname, name, value, size); > } > > int smbc_fgetxattr(int fd, >@@ -370,83 +370,83 @@ > const void *value, > size_t size) > { >- SMBCFILE * file = find_fd(fd); >+ SMBCFILE * file = smbc_find_fd(fd); > if (file == NULL) { > errno = EBADF; > return -1; > } >- return statcont->getxattr(statcont, file->fname, name, value, size); >+ return smbc_statcont->getxattr(smbc_statcont, file->fname, name, value, size); > } > > int smbc_removexattr(const char *fname, > const char *name) > { >- return statcont->removexattr(statcont, fname, name); >+ return smbc_statcont->removexattr(smbc_statcont, fname, name); > } > > int smbc_lremovexattr(const char *fname, > const char *name) > { >- return statcont->removexattr(statcont, fname, name); >+ return smbc_statcont->removexattr(smbc_statcont, fname, name); > } > > int smbc_fremovexattr(int fd, > const char *name) > { >- SMBCFILE * file = find_fd(fd); >+ SMBCFILE * file = smbc_find_fd(fd); > if (file == NULL) { > errno = EBADF; > return -1; > } >- return statcont->removexattr(statcont, file->fname, name); >+ return smbc_statcont->removexattr(smbc_statcont, file->fname, name); > } > > int smbc_listxattr(const char *fname, > char *list, > size_t size) > { >- return statcont->listxattr(statcont, fname, list, size); >+ return smbc_statcont->listxattr(smbc_statcont, fname, list, size); > } > > int smbc_llistxattr(const char *fname, > char *list, > size_t size) > { >- return statcont->listxattr(statcont, fname, list, size); >+ return smbc_statcont->listxattr(smbc_statcont, fname, list, size); > } > > int smbc_flistxattr(int fd, > char *list, > size_t size) > { >- SMBCFILE * file = find_fd(fd); >+ SMBCFILE * file = smbc_find_fd(fd); > if (file == NULL) { > errno = EBADF; > return -1; > } >- return statcont->listxattr(statcont, file->fname, list, size); >+ return smbc_statcont->listxattr(smbc_statcont, file->fname, list, size); > } > > int smbc_print_file(const char *fname, const char *printq) > { >- return statcont->print_file(statcont, fname, statcont, printq); >+ return smbc_statcont->print_file(smbc_statcont, fname, smbc_statcont, printq); > } > > int smbc_open_print_job(const char *fname) > { >- SMBCFILE * file = statcont->open_print_job(statcont, fname); >+ SMBCFILE * file = smbc_statcont->open_print_job(smbc_statcont, fname); > if (!file) return -1; > return file->cli_fd; > } > > int smbc_list_print_jobs(const char *purl, smbc_list_print_job_fn fn) > { >- return statcont->list_print_jobs(statcont, purl, fn); >+ return smbc_statcont->list_print_jobs(smbc_statcont, purl, fn); > } > > int smbc_unlink_print_job(const char *purl, int id) > { >- return statcont->unlink_print_job(statcont, purl, id); >+ return smbc_statcont->unlink_print_job(smbc_statcont, purl, id); > } > > >Index: source/libsmb/libsmbclient.c >=================================================================== >--- source/libsmb/libsmbclient.c (révision 22956) >+++ source/libsmb/libsmbclient.c (copie de travail) >@@ -6217,6 +6217,11 @@ > context->callbacks.check_server_fn = smbc_check_server; > context->callbacks.remove_unused_server_fn = smbc_remove_unused_server; > >+#if defined(SMBC_FILE_OFFSET_BITS) && SMBC_FILE_OFFSET_BITS > 32 >+ /* Fill legacy methods */ >+ smbc_new_legacy_context(context); >+#endif >+ > smbc_default_cache_functions(context); > > return context; >Index: source/libsmb/libsmb_nonlfs.c >=================================================================== >--- source/libsmb/libsmb_nonlfs.c (révision 0) >+++ source/libsmb/libsmb_nonlfs.c (révision 0) >@@ -0,0 +1,200 @@ >+/* >+ Unix SMB/CIFS implementation. >+ SMB client library implementation (Old interface compatibility) >+ Copyright (C) Samuel Thibault 2007 >+ >+ This program is free software; you can redistribute it and/or modify >+ it under the terms of the GNU General Public License as published by >+ the Free Software Foundation; either version 2 of the License, or >+ (at your option) any later version. >+ >+ This program is distributed in the hope that it will be useful, >+ but WITHOUT ANY WARRANTY; without even the implied warranty of >+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the >+ GNU General Public License for more details. >+ >+ You should have received a copy of the GNU General Public License >+ along with this program; if not, write to the Free Software >+ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. >+*/ >+ >+ >+#include "config.h" >+#undef _FILE_OFFSET_BITS >+#define NO_CONFIG_H 1 >+ >+#include "includes.h" >+#include "include/libsmb_internal.h" >+ >+#if defined(SMBC_FILE_OFFSET_BITS) && SMBC_FILE_OFFSET_BITS > 32 >+/* Provide legacy functions for non-LFS programs */ >+ >+extern SMBCFILE * smbc_find_fd(int fd); >+extern SMBCCTX * smbc_statcont; >+ >+static int >+smbc_stat64_to_stat(struct stat *st, >+ const struct stat64 *st64) >+{ >+#define SET(field) \ >+ st->field = st64->field; \ >+ if (st->field != st64->field) { \ >+ errno = EOVERFLOW; \ >+ return -1; \ >+ } >+ SET(st_ino) >+ SET(st_mode) >+ SET(st_size) >+ SET(st_blksize) >+ SET(st_blocks) >+ SET(st_uid) >+ SET(st_gid) >+ SET(st_nlink) >+ SET(st_atime) >+ SET(st_ctime) >+ SET(st_mtime) >+ SET(st_dev) >+#undef SET >+ >+ return 0; >+} >+ >+static off_t >+smbc_lseek_nonlfs_ctx(SMBCCTX *context, >+ SMBCFILE *file, >+ off_t offset, >+ int whence) >+{ >+ off64_t last, offset64 = offset, ret64; >+ off_t ret; >+ last = context->lseek64(context, file, 0, SEEK_CUR); >+ if (last == (off64_t) -1) >+ return -1; >+ ret = ret64 = context->lseek64(context, file, offset64, whence); >+ if ((off64_t) ret != ret64) { >+ context->lseek64(context, file, last, SEEK_SET); >+ errno = EOVERFLOW; >+ return -1; >+ } >+ return ret; >+} >+ >+off_t >+smbc_lseek(int fd, >+ off_t offset, >+ int whence) >+{ >+ SMBCFILE * file = smbc_find_fd(fd); >+ return smbc_lseek_nonlfs_ctx(smbc_statcont, file, offset, whence); >+} >+ >+static int >+smbc_stat_nonlfs_ctx(SMBCCTX *context, >+ const char *fname, >+ struct stat *st) >+{ >+ struct stat64 st64; >+ int ret; >+ ret = context->stat64(context, fname, &st64); >+ if (ret) >+ return ret; >+ return smbc_stat64_to_stat(st, &st64); >+} >+ >+int >+smbc_stat(const char *url, >+ struct stat *st) >+{ >+ return smbc_stat_nonlfs_ctx(smbc_statcont, url, st); >+} >+ >+static int >+smbc_fstat_nonlfs_ctx(SMBCCTX *context, >+ SMBCFILE *file, >+ struct stat *st) >+{ >+ struct stat64 st64; >+ int ret; >+ ret = context->fstat64(context, file, &st64); >+ if (ret) >+ return ret; >+ return smbc_stat64_to_stat(st, &st64); >+} >+ >+int >+smbc_fstat(int fd, >+ struct stat *st) >+{ >+ SMBCFILE * file = smbc_find_fd(fd); >+ return smbc_fstat_nonlfs_ctx(smbc_statcont, file, st); >+} >+ >+static off_t >+smbc_telldir_nonlfs_ctx(SMBCCTX *context, >+ SMBCFILE *dir) >+{ >+ off64_t ret64; >+ off_t ret; >+ ret = ret64 = context->telldir64(context, dir); >+ if ((off64_t) ret != ret64) { >+ errno = EOVERFLOW; >+ return -1; >+ } >+ return ret; >+} >+ >+off_t >+smbc_telldir(int dh) >+{ >+ SMBCFILE * file = smbc_find_fd(dh); >+ return smbc_telldir_nonlfs_ctx(smbc_statcont, file); >+} >+ >+static int >+smbc_lseekdir_nonlfs_ctx(SMBCCTX *context, >+ SMBCFILE *dir, >+ off_t offset) >+{ >+ off64_t offset64 = offset; >+ int ret; >+ ret = context->lseekdir64(context, dir, offset64); >+ return ret; >+} >+ >+int >+smbc_lseekdir(int fd, >+ off_t offset) >+{ >+ SMBCFILE * file = smbc_find_fd(fd); >+ return smbc_lseekdir_nonlfs_ctx(smbc_statcont, file, offset); >+} >+ >+static int >+smbc_fstatdir_nonlfs_ctx(SMBCCTX *context, >+ SMBCFILE *dir, >+ struct stat *st) >+{ >+ struct stat64 st64; >+ int ret; >+ ret = context->fstatdir64(context, dir, &st64); >+ if (ret) >+ return ret; >+ return smbc_stat64_to_stat(st, &st64); >+} >+ >+void >+smbc_new_legacy_context(SMBCCTX *context) >+{ >+ context->lseek = smbc_lseek_nonlfs_ctx; >+ context->stat = smbc_stat_nonlfs_ctx; >+ context->fstat = smbc_fstat_nonlfs_ctx; >+ context->telldir = smbc_telldir_nonlfs_ctx; >+ context->lseekdir = smbc_lseekdir_nonlfs_ctx; >+ context->fstatdir = smbc_fstatdir_nonlfs_ctx; >+} >+#else >+void >+smbc_new_legacy_context(SMBCCTX *context) >+{ >+} >+#endif >Index: source/include/libsmbclient.h.in >=================================================================== >--- source/include/libsmbclient.h.in (révision 0) >+++ source/include/libsmbclient.h.in (révision 0) >@@ -0,0 +1,2271 @@ >+/*===================================================================== >+ Unix SMB/Netbios implementation. >+ SMB client library API definitions >+ Copyright (C) Andrew Tridgell 1998 >+ Copyright (C) Richard Sharpe 2000 >+ Copyright (C) John Terpsra 2000 >+ Copyright (C) Tom Jansen (Ninja ISD) 2002 >+ Copyright (C) Derrell Lipman 2003 >+ >+ >+ This program is free software; you can redistribute it and/or modify >+ it under the terms of the GNU General Public License as published by >+ the Free Software Foundation; either version 2 of the License, or >+ (at your option) any later version. >+ >+ This program is distributed in the hope that it will be useful, >+ but WITHOUT ANY WARRANTY; without even the implied warranty of >+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the >+ GNU General Public License for more details. >+ >+ You should have received a copy of the GNU General Public License >+ along with this program; if not, write to the Free Software >+ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. >+ =====================================================================*/ >+ >+#ifndef SMBCLIENT_H_INCLUDED >+#define SMBCLIENT_H_INCLUDED >+ >+#ifdef __cplusplus >+extern "C" { >+#endif >+ >+/*-------------------------------------------------------------------*/ >+/* The following are special comments to instruct DOXYGEN (automated >+ * documentation tool: >+*/ >+/** \defgroup libsmbclient >+*/ >+/** \defgroup structure Data Structures Type and Constants >+* \ingroup libsmbclient >+* Data structures, types, and constants >+*/ >+/** \defgroup callback Callback function types >+* \ingroup libsmbclient >+* Callback functions >+*/ >+/** \defgroup file File Functions >+* \ingroup libsmbclient >+* Functions used to access individual file contents >+*/ >+/** \defgroup directory Directory Functions >+* \ingroup libsmbclient >+* Functions used to access directory entries >+*/ >+/** \defgroup attribute Attributes Functions >+* \ingroup libsmbclient >+* Functions used to view or change file and directory attributes >+*/ >+/** \defgroup print Print Functions >+* \ingroup libsmbclient >+* Functions used to access printing functionality >+*/ >+/** \defgroup misc Miscellaneous Functions >+* \ingroup libsmbclient >+* Functions that don't fit in to other categories >+*/ >+/*-------------------------------------------------------------------*/ >+ >+/* Make sure we have the following includes for now ... */ >+#include <sys/types.h> >+#include <sys/stat.h> >+#include <fcntl.h> >+#include <utime.h> >+ >+#define SMBC_BASE_FD 10000 /* smallest file descriptor returned */ >+ >+#define SMBC_WORKGROUP 1 >+#define SMBC_SERVER 2 >+#define SMBC_FILE_SHARE 3 >+#define SMBC_PRINTER_SHARE 4 >+#define SMBC_COMMS_SHARE 5 >+#define SMBC_IPC_SHARE 6 >+#define SMBC_DIR 7 >+#define SMBC_FILE 8 >+#define SMBC_LINK 9 >+ >+/* Value of _FILE_OFFSET_BITS when libsmbclient got compiled */ >+#undef SMBC_FILE_OFFSET_BITS >+ >+#if (defined(_FILE_OFFSET_BITS) && _FILE_OFFSET_BITS > 32) /* LFS requested */ \ >+ && (!defined(SMBC_FILE_OFFSET_BITS) || SMBC_FILE_OFFSET_BITS != _FILE_OFFSET_BITS) /* Wasn't compiled with LFS support */ >+#error "LFS requested but libsmbclient wasn't compiled with LFS support" >+#endif >+ >+/**@ingroup structure >+ * Structure that represents a directory entry. >+ * >+ */ >+struct smbc_dirent >+{ >+ /** Type of entity. >+ SMBC_WORKGROUP=1, >+ SMBC_SERVER=2, >+ SMBC_FILE_SHARE=3, >+ SMBC_PRINTER_SHARE=4, >+ SMBC_COMMS_SHARE=5, >+ SMBC_IPC_SHARE=6, >+ SMBC_DIR=7, >+ SMBC_FILE=8, >+ SMBC_LINK=9,*/ >+ unsigned int smbc_type; >+ >+ /** Length of this smbc_dirent in bytes >+ */ >+ unsigned int dirlen; >+ /** The length of the comment string in bytes (does not include >+ * null terminator) >+ */ >+ unsigned int commentlen; >+ /** Points to the null terminated comment string >+ */ >+ char *comment; >+ /** The length of the name string in bytes (does not include >+ * null terminator) >+ */ >+ unsigned int namelen; >+ /** Points to the null terminated name string >+ */ >+ char name[1]; >+}; >+ >+/* >+ * Flags for smbc_setxattr() >+ * Specify a bitwise OR of these, or 0 to add or replace as necessary >+ */ >+#define SMBC_XATTR_FLAG_CREATE 0x1 /* fail if attr already exists */ >+#define SMBC_XATTR_FLAG_REPLACE 0x2 /* fail if attr does not exist */ >+ >+ >+/* >+ * Mappings of the DOS mode bits, as returned by smbc_getxattr() when the >+ * attribute name "system.dos_attr.mode" (or "system.dos_attr.*" or >+ * "system.*") is specified. >+ */ >+#define SMBC_DOS_MODE_READONLY 0x01 >+#define SMBC_DOS_MODE_HIDDEN 0x02 >+#define SMBC_DOS_MODE_SYSTEM 0x04 >+#define SMBC_DOS_MODE_VOLUME_ID 0x08 >+#define SMBC_DOS_MODE_DIRECTORY 0x10 >+#define SMBC_DOS_MODE_ARCHIVE 0x20 >+ >+/* >+ * Valid values for the option "open_share_mode", when calling >+ * smbc_option_set() >+ */ >+typedef enum smbc_share_mode >+{ >+ SMBC_SHAREMODE_DENY_DOS = 0, >+ SMBC_SHAREMODE_DENY_ALL = 1, >+ SMBC_SHAREMODE_DENY_WRITE = 2, >+ SMBC_SHAREMODE_DENY_READ = 3, >+ SMBC_SHAREMODE_DENY_NONE = 4, >+ SMBC_SHAREMODE_DENY_FCB = 7 >+} smbc_share_mode; >+ >+ >+#ifndef ENOATTR >+# define ENOATTR ENOENT /* No such attribute */ >+#endif >+ >+ >+ >+ >+/**@ingroup structure >+ * Structure that represents a print job. >+ * >+ */ >+#ifndef _CLIENT_H >+struct print_job_info >+{ >+ /** numeric ID of the print job >+ */ >+ unsigned short id; >+ >+ /** represents print job priority (lower numbers mean higher priority) >+ */ >+ unsigned short priority; >+ >+ /** Size of the print job >+ */ >+ size_t size; >+ >+ /** Name of the user that owns the print job >+ */ >+ char user[128]; >+ >+ /** Name of the print job. This will have no name if an anonymous print >+ * file was opened. Ie smb://server/printer >+ */ >+ char name[128]; >+ >+ /** Time the print job was spooled >+ */ >+ time_t t; >+}; >+#endif /* _CLIENT_H */ >+ >+ >+/**@ingroup structure >+ * Server handle >+ */ >+typedef struct _SMBCSRV SMBCSRV; >+ >+/**@ingroup structure >+ * File or directory handle >+ */ >+typedef struct _SMBCFILE SMBCFILE; >+ >+/**@ingroup structure >+ * File or directory handle >+ */ >+typedef struct _SMBCCTX SMBCCTX; >+ >+ >+ >+ >+ >+/**@ingroup callback >+ * Authentication callback function type (traditional method) >+ * >+ * Type for the the authentication function called by the library to >+ * obtain authentication credentals >+ * >+ * @param srv Server being authenticated to >+ * >+ * @param shr Share being authenticated to >+ * >+ * @param wg Pointer to buffer containing a "hint" for the >+ * workgroup to be authenticated. Should be filled in >+ * with the correct workgroup if the hint is wrong. >+ * >+ * @param wglen The size of the workgroup buffer in bytes >+ * >+ * @param un Pointer to buffer containing a "hint" for the >+ * user name to be use for authentication. Should be >+ * filled in with the correct workgroup if the hint is >+ * wrong. >+ * >+ * @param unlen The size of the username buffer in bytes >+ * >+ * @param pw Pointer to buffer containing to which password >+ * copied >+ * >+ * @param pwlen The size of the password buffer in bytes >+ * >+ */ >+typedef void (*smbc_get_auth_data_fn)(const char *srv, >+ const char *shr, >+ char *wg, int wglen, >+ char *un, int unlen, >+ char *pw, int pwlen); >+/**@ingroup callback >+ * Authentication callback function type (method that includes context) >+ * >+ * Type for the the authentication function called by the library to >+ * obtain authentication credentals >+ * >+ * @param c Pointer to the smb context >+ * >+ * @param srv Server being authenticated to >+ * >+ * @param shr Share being authenticated to >+ * >+ * @param wg Pointer to buffer containing a "hint" for the >+ * workgroup to be authenticated. Should be filled in >+ * with the correct workgroup if the hint is wrong. >+ * >+ * @param wglen The size of the workgroup buffer in bytes >+ * >+ * @param un Pointer to buffer containing a "hint" for the >+ * user name to be use for authentication. Should be >+ * filled in with the correct workgroup if the hint is >+ * wrong. >+ * >+ * @param unlen The size of the username buffer in bytes >+ * >+ * @param pw Pointer to buffer containing to which password >+ * copied >+ * >+ * @param pwlen The size of the password buffer in bytes >+ * >+ */ >+typedef void (*smbc_get_auth_data_with_context_fn)(SMBCCTX *c, >+ const char *srv, >+ const char *shr, >+ char *wg, int wglen, >+ char *un, int unlen, >+ char *pw, int pwlen); >+ >+ >+/**@ingroup callback >+ * Print job info callback function type. >+ * >+ * @param i pointer to print job information structure >+ * >+ */ >+typedef void (*smbc_list_print_job_fn)(struct print_job_info *i); >+ >+ >+/**@ingroup callback >+ * Check if a server is still good >+ * >+ * @param c pointer to smb context >+ * >+ * @param srv pointer to server to check >+ * >+ * @return 0 when connection is good. 1 on error. >+ * >+ */ >+typedef int (*smbc_check_server_fn)(SMBCCTX * c, SMBCSRV *srv); >+ >+/**@ingroup callback >+ * Remove a server if unused >+ * >+ * @param c pointer to smb context >+ * >+ * @param srv pointer to server to remove >+ * >+ * @return 0 on success. 1 on failure. >+ * >+ */ >+typedef int (*smbc_remove_unused_server_fn)(SMBCCTX * c, SMBCSRV *srv); >+ >+ >+/**@ingroup callback >+ * Add a server to the cache system >+ * >+ * @param c pointer to smb context >+ * >+ * @param srv pointer to server to add >+ * >+ * @param server server name >+ * >+ * @param share share name >+ * >+ * @param workgroup workgroup used to connect >+ * >+ * @param username username used to connect >+ * >+ * @return 0 on success. 1 on failure. >+ * >+ */ >+typedef int (*smbc_add_cached_srv_fn) (SMBCCTX * c, SMBCSRV *srv, >+ const char * server, const char * share, >+ const char * workgroup, const char * username); >+ >+/**@ingroup callback >+ * Look up a server in the cache system >+ * >+ * @param c pointer to smb context >+ * >+ * @param server server name to match >+ * >+ * @param share share name to match >+ * >+ * @param workgroup workgroup to match >+ * >+ * @param username username to match >+ * >+ * @return pointer to SMBCSRV on success. NULL on failure. >+ * >+ */ >+typedef SMBCSRV * (*smbc_get_cached_srv_fn) (SMBCCTX * c, const char * server, >+ const char * share, const char * workgroup, >+ const char * username); >+ >+/**@ingroup callback >+ * Check if a server is still good >+ * >+ * @param c pointer to smb context >+ * >+ * @param srv pointer to server to remove >+ * >+ * @return 0 when found and removed. 1 on failure. >+ * >+ */ >+typedef int (*smbc_remove_cached_srv_fn)(SMBCCTX * c, SMBCSRV *srv); >+ >+ >+/**@ingroup callback >+ * Try to remove all servers from the cache system and disconnect >+ * >+ * @param c pointer to smb context >+ * >+ * @return 0 when found and removed. 1 on failure. >+ * >+ */ >+typedef int (*smbc_purge_cached_fn) (SMBCCTX * c); >+ >+ >+/**@ingroup structure >+ * Structure that contains a client context information >+ * This structure is know as SMBCCTX >+ */ >+struct _SMBCCTX { >+ /** debug level >+ */ >+ int debug; >+ >+ /** netbios name used for making connections >+ */ >+ char * netbios_name; >+ >+ /** workgroup name used for making connections >+ */ >+ char * workgroup; >+ >+ /** username used for making connections >+ */ >+ char * user; >+ >+ /** timeout used for waiting on connections / response data (in milliseconds) >+ */ >+ int timeout; >+ >+ /** callable functions for files: >+ * For usage and return values see the smbc_* functions >+ */ >+ SMBCFILE * (*open) (SMBCCTX *c, const char *fname, int flags, mode_t mode); >+ SMBCFILE * (*creat) (SMBCCTX *c, const char *path, mode_t mode); >+ ssize_t (*read) (SMBCCTX *c, SMBCFILE *file, void *buf, size_t count); >+ ssize_t (*write) (SMBCCTX *c, SMBCFILE *file, void *buf, size_t count); >+ int (*unlink) (SMBCCTX *c, const char *fname); >+ int (*rename) (SMBCCTX *ocontext, const char *oname, >+ SMBCCTX *ncontext, const char *nname); >+#if defined(_FILE_OFFSET_BITS) && _FILE_OFFSET_BITS > 32 >+ /* just for keeping room, don't use them */ >+ void (*nonlfs_lseek) (void); >+ void (*nonlfs_stat) (void); >+ void (*nonlfs_fstat) (void); >+#else >+ /* legacy non-LFS versions */ >+ off_t (*lseek) (SMBCCTX *c, SMBCFILE * file, off_t offset, int whence); >+ int (*stat) (SMBCCTX *c, const char *fname, struct stat *st); >+ int (*fstat) (SMBCCTX *c, SMBCFILE *file, struct stat *st); >+#endif >+ int (*close_fn) (SMBCCTX *c, SMBCFILE *file); >+ >+ /** callable functions for dirs >+ */ >+ SMBCFILE * (*opendir) (SMBCCTX *c, const char *fname); >+ int (*closedir)(SMBCCTX *c, SMBCFILE *dir); >+ struct smbc_dirent * (*readdir)(SMBCCTX *c, SMBCFILE *dir); >+ int (*getdents)(SMBCCTX *c, SMBCFILE *dir, >+ struct smbc_dirent *dirp, int count); >+ int (*mkdir) (SMBCCTX *c, const char *fname, mode_t mode); >+ int (*rmdir) (SMBCCTX *c, const char *fname); >+#if defined(_FILE_OFFSET_BITS) && _FILE_OFFSET_BITS > 32 >+ /* just for keeping room, don't use them */ >+ void (*nonlfs_telldir) (void); >+ void (*nonlfs_lseekdir)(void); >+ void (*nonlfs_fstatdir)(void); >+#else >+ /* legacy non-LFS versions */ >+ off_t (*telldir) (SMBCCTX *c, SMBCFILE *dir); >+ int (*lseekdir)(SMBCCTX *c, SMBCFILE *dir, off_t offset); >+ int (*fstatdir)(SMBCCTX *c, SMBCFILE *dir, struct stat *st); >+#endif >+ int (*chmod)(SMBCCTX *c, const char *fname, mode_t mode); >+ int (*utimes)(SMBCCTX *c, >+ const char *fname, struct timeval *tbuf); >+ int (*setxattr)(SMBCCTX *context, >+ const char *fname, >+ const char *name, >+ const void *value, >+ size_t size, >+ int flags); >+ int (*getxattr)(SMBCCTX *context, >+ const char *fname, >+ const char *name, >+ const void *value, >+ size_t size); >+ int (*removexattr)(SMBCCTX *context, >+ const char *fname, >+ const char *name); >+ int (*listxattr)(SMBCCTX *context, >+ const char *fname, >+ char *list, >+ size_t size); >+ >+ /** callable functions for printing >+ */ >+ int (*print_file)(SMBCCTX *c_file, const char *fname, >+ SMBCCTX *c_print, const char *printq); >+ SMBCFILE * (*open_print_job)(SMBCCTX *c, const char *fname); >+ int (*list_print_jobs)(SMBCCTX *c, const char *fname, smbc_list_print_job_fn fn); >+ int (*unlink_print_job)(SMBCCTX *c, const char *fname, int id); >+ >+ >+ /* >+ ** Callbacks >+ * These callbacks _always_ have to be initialized because they will >+ * not be checked at dereference for increased speed. >+ */ >+ struct _smbc_callbacks { >+ /** authentication function callback: called upon auth requests >+ */ >+ smbc_get_auth_data_fn auth_fn; >+ >+ /** check if a server is still good >+ */ >+ smbc_check_server_fn check_server_fn; >+ >+ /** remove a server if unused >+ */ >+ smbc_remove_unused_server_fn remove_unused_server_fn; >+ >+ /** Cache subsystem >+ * For an example cache system see samba/source/libsmb/libsmb_cache.c >+ * Cache subsystem functions follow. >+ */ >+ >+ /** server cache addition >+ */ >+ smbc_add_cached_srv_fn add_cached_srv_fn; >+ >+ /** server cache lookup >+ */ >+ smbc_get_cached_srv_fn get_cached_srv_fn; >+ >+ /** server cache removal >+ */ >+ smbc_remove_cached_srv_fn remove_cached_srv_fn; >+ >+ /** server cache purging, try to remove all cached servers (disconnect) >+ */ >+ smbc_purge_cached_fn purge_cached_fn; >+ } callbacks; >+ >+ >+ /** Space to store private data of the server cache. >+ */ >+ struct smbc_server_cache * server_cache; >+ >+ int flags; >+ >+ /** user options selections that apply to this session >+ */ >+ struct _smbc_options { >+ >+ /* >+ * From how many local master browsers should the list of >+ * workgroups be retrieved? It can take up to 12 minutes or >+ * longer after a server becomes a local master browser, for >+ * it to have the entire browse list (the list of >+ * workgroups/domains) from an entire network. Since a client >+ * never knows which local master browser will be found first, >+ * the one which is found first and used to retrieve a browse >+ * list may have an incomplete or empty browse list. By >+ * requesting the browse list from multiple local master >+ * browsers, a more complete list can be generated. For small >+ * networks (few workgroups), it is recommended that this >+ * value be set to 0, causing the browse lists from all found >+ * local master browsers to be retrieved and merged. For >+ * networks with many workgroups, a suitable value for this >+ * variable is probably somewhere around 3. (Default: 3). >+ */ >+ int browse_max_lmb_count; >+ >+ /* >+ * There is a difference in the desired return strings from >+ * smbc_readdir() depending upon whether the filenames are to >+ * be displayed to the user, or whether they are to be >+ * appended to the path name passed to smbc_opendir() to call >+ * a further smbc_ function (e.g. open the file with >+ * smbc_open()). In the former case, the filename should be >+ * in "human readable" form. In the latter case, the smbc_ >+ * functions expect a URL which must be url-encoded. Those >+ * functions decode the URL. If, for example, smbc_readdir() >+ * returned a file name of "abc%20def.txt", passing a path >+ * with this file name attached to smbc_open() would cause >+ * smbc_open to attempt to open the file "abc def.txt" since >+ * the %20 is decoded into a space. >+ * >+ * Set this option to True if the names returned by >+ * smbc_readdir() should be url-encoded such that they can be >+ * passed back to another smbc_ call. Set it to False if the >+ * names returned by smbc_readdir() are to be presented to the >+ * user. >+ * >+ * For backwards compatibility, this option defaults to False. >+ */ >+ int urlencode_readdir_entries; >+ >+ /* >+ * Some Windows versions appear to have a limit to the number >+ * of concurrent SESSIONs and/or TREE CONNECTions. In >+ * one-shot programs (i.e. the program runs and then quickly >+ * ends, thereby shutting down all connections), it is >+ * probably reasonable to establish a new connection for each >+ * share. In long-running applications, the limitation can be >+ * avoided by using only a single connection to each server, >+ * and issuing a new TREE CONNECT when the share is accessed. >+ */ >+ int one_share_per_server; >+ } options; >+ >+ /* LFS64 versions */ >+#if defined(_FILE_OFFSET_BITS) && _FILE_OFFSET_BITS == 64 >+ off_t (*lseek) (SMBCCTX *c, SMBCFILE * file, off_t offset, int whence); >+ int (*stat) (SMBCCTX *c, const char *fname, struct stat *st); >+ int (*fstat) (SMBCCTX *c, SMBCFILE *file, struct stat *st); >+ off_t (*telldir) (SMBCCTX *c, SMBCFILE *dir); >+ int (*lseekdir)(SMBCCTX *c, SMBCFILE *dir, off_t offset); >+ int (*fstatdir)(SMBCCTX *c, SMBCFILE *dir, struct stat *st); >+#else >+#if defined(_LARGEFILE64_SOURCE) >+ off64_t (*lseek64) (SMBCCTX *c, SMBCFILE * file, off64_t offset, int whence); >+ int (*stat64) (SMBCCTX *c, const char *fname, struct stat64 *st); >+ int (*fstat64) (SMBCCTX *c, SMBCFILE *file, struct stat64 *st); >+ off64_t (*telldir64) (SMBCCTX *c, SMBCFILE *dir); >+ int (*lseekdir64)(SMBCCTX *c, SMBCFILE *dir, off64_t offset); >+ int (*fstatdir64)(SMBCCTX *c, SMBCFILE *dir, struct stat64 *st); >+#else >+ /* just for keeping room, don't use them */ >+ void (*lfs_lseek) (void); >+ void (*lfs_stat) (void); >+ void (*lfs_fstat) (void); >+ void (*lfs_telldir) (void); >+ void (*lfs_lseekdir)(void); >+ void (*lfs_fstatdir)(void); >+#endif >+#endif >+ >+ /** INTERNAL DATA >+ * do _NOT_ touch this from your program ! >+ */ >+ struct smbc_internal_data * internal; >+}; >+ >+/* Flags for SMBCCTX->flags */ >+#define SMB_CTX_FLAG_USE_KERBEROS (1 << 0) >+#define SMB_CTX_FLAG_FALLBACK_AFTER_KERBEROS (1 << 1) >+#define SMBCCTX_FLAG_NO_AUTO_ANONYMOUS_LOGON (1 << 2) /* don't try to do automatic anon login */ >+ >+/**@ingroup misc >+ * Create a new SBMCCTX (a context). >+ * >+ * Must be called before the context is passed to smbc_context_init() >+ * >+ * @return The given SMBCCTX pointer on success, NULL on error with errno set: >+ * - ENOMEM Out of memory >+ * >+ * @see smbc_free_context(), smbc_init_context() >+ * >+ * @note Do not forget to smbc_init_context() the returned SMBCCTX pointer ! >+ */ >+SMBCCTX * smbc_new_context(void); >+ >+/**@ingroup misc >+ * Delete a SBMCCTX (a context) acquired from smbc_new_context(). >+ * >+ * The context will be deleted if possible. >+ * >+ * @param context A pointer to a SMBCCTX obtained from smbc_new_context() >+ * >+ * @param shutdown_ctx If 1, all connections and files will be closed even if they are busy. >+ * >+ * >+ * @return Returns 0 on succes. Returns 1 on failure with errno set: >+ * - EBUSY Server connections are still used, Files are open or cache >+ * could not be purged >+ * - EBADF context == NULL >+ * >+ * @see smbc_new_context() >+ * >+ * @note It is advised to clean up all the contexts with shutdown_ctx set to 1 >+ * just before exit()'ing. When shutdown_ctx is 0, this function can be >+ * use in periodical cleanup functions for example. >+ */ >+int smbc_free_context(SMBCCTX * context, int shutdown_ctx); >+ >+ >+/**@ingroup misc >+ * Each time the context structure is changed, we have binary backward >+ * compatibility issues. Instead of modifying the public portions of the >+ * context structure to add new options, instead, we put them in the internal >+ * portion of the context structure and provide a set function for these new >+ * options. >+ * >+ * @param context A pointer to a SMBCCTX obtained from smbc_new_context() >+ * >+ * @param option_name >+ * The name of the option for which the value is to be set >+ * >+ * @param option_value >+ * The new value of the option being set >+ * >+ */ >+void >+smbc_option_set(SMBCCTX *context, >+ char *option_name, >+ ... /* option_value */); >+/* >+ * Retrieve the current value of an option >+ * >+ * @param context A pointer to a SMBCCTX obtained from smbc_new_context() >+ * >+ * @param option_name >+ * The name of the option for which the value is to be >+ * retrieved >+ * >+ * @return The value of the specified option. >+ */ >+void * >+smbc_option_get(SMBCCTX *context, >+ char *option_name); >+ >+/**@ingroup misc >+ * Initialize a SBMCCTX (a context). >+ * >+ * Must be called before using any SMBCCTX API function >+ * >+ * @param context A pointer to a SMBCCTX obtained from smbc_new_context() >+ * >+ * @return A pointer to the given SMBCCTX on success, >+ * NULL on error with errno set: >+ * - EBADF NULL context given >+ * - ENOMEM Out of memory >+ * - ENOENT The smb.conf file would not load >+ * >+ * @see smbc_new_context() >+ * >+ * @note my_context = smbc_init_context(smbc_new_context()) >+ * is perfectly safe, but it might leak memory on >+ * smbc_context_init() failure. Avoid this. >+ * You'll have to call smbc_free_context() yourself >+ * on failure. >+ */ >+ >+SMBCCTX * smbc_init_context(SMBCCTX * context); >+ >+/**@ingroup misc >+ * Initialize the samba client library. >+ * >+ * Must be called before using any of the smbclient API function >+ * >+ * @param fn The function that will be called to obtaion >+ * authentication credentials. >+ * >+ * @param debug Allows caller to set the debug level. Can be >+ * changed in smb.conf file. Allows caller to set >+ * debugging if no smb.conf. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - ENOMEM Out of memory >+ * - ENOENT The smb.conf file would not load >+ * >+ */ >+ >+int smbc_init(smbc_get_auth_data_fn fn, int debug); >+ >+/**@ingroup misc >+ * Set or retrieve the compatibility library's context pointer >+ * >+ * @param context New context to use, or NULL. If a new context is provided, >+ * it must have allocated with smbc_new_context() and >+ * initialized with smbc_init_context(), followed, optionally, >+ * by some manual changes to some of the non-internal fields. >+ * >+ * @return The old context. >+ * >+ * @see smbc_new_context(), smbc_init_context(), smbc_init() >+ * >+ * @note This function may be called prior to smbc_init() to force >+ * use of the next context without any internal calls to >+ * smbc_new_context() or smbc_init_context(). It may also >+ * be called after smbc_init() has already called those two >+ * functions, to replace the existing context with a new one. >+ * Care should be taken, in this latter case, to ensure that >+ * the server cache and any data allocated by the >+ * authentication functions have been freed, if necessary. >+ */ >+ >+SMBCCTX * smbc_set_context(SMBCCTX * new_context); >+ >+/**@ingroup file >+ * Open a file on an SMB server. >+ * >+ * @param furl The smb url of the file to be opened. >+ * >+ * @param flags Is one of O_RDONLY, O_WRONLY or O_RDWR which >+ * request opening the file read-only,write-only >+ * or read/write. flags may also be bitwise-or'd with >+ * one or more of the following: >+ * O_CREAT - If the file does not exist it will be >+ * created. >+ * O_EXCL - When used with O_CREAT, if the file >+ * already exists it is an error and the open will >+ * fail. >+ * O_TRUNC - If the file already exists it will be >+ * truncated. >+ * O_APPEND The file is opened in append mode >+ * >+ * @param mode mode specifies the permissions to use if a new >+ * file is created. It is modified by the >+ * process's umask in the usual way: the permissions >+ * of the created file are (mode & ~umask) >+ * >+ * Not currently use, but there for future use. >+ * We will map this to SYSTEM, HIDDEN, etc bits >+ * that reverses the mapping that smbc_fstat does. >+ * >+ * @return Valid file handle, < 0 on error with errno set: >+ * - ENOMEM Out of memory >+ * - EINVAL if an invalid parameter passed, like no >+ * file, or smbc_init not called. >+ * - EEXIST pathname already exists and O_CREAT and >+ * O_EXCL were used. >+ * - EISDIR pathname refers to a directory and >+ * the access requested involved writing. >+ * - EACCES The requested access to the file is not >+ * allowed >+ * - ENODEV The requested share does not exist >+ * - ENOTDIR A file on the path is not a directory >+ * - ENOENT A directory component in pathname does >+ * not exist. >+ * >+ * @see smbc_creat() >+ * >+ * @note This call uses an underlying routine that may create >+ * a new connection to the server specified in the URL. >+ * If the credentials supplied in the URL, or via the >+ * auth_fn in the smbc_init call, fail, this call will >+ * try again with an empty username and password. This >+ * often gets mapped to the guest account on some machines. >+ */ >+ >+int smbc_open(const char *furl, int flags, mode_t mode); >+ >+/**@ingroup file >+ * Create a file on an SMB server. >+ * >+ * Same as calling smbc_open() with flags = O_CREAT|O_WRONLY|O_TRUNC >+ * >+ * @param furl The smb url of the file to be created >+ * >+ * @param mode mode specifies the permissions to use if a new >+ * file is created. It is modified by the >+ * process's umask in the usual way: the permissions >+ * of the created file are (mode & ~umask) >+ * >+ * NOTE, the above is not true. We are dealing with >+ * an SMB server, which has no concept of a umask! >+ * >+ * @return Valid file handle, < 0 on error with errno set: >+ * - ENOMEM Out of memory >+ * - EINVAL if an invalid parameter passed, like no >+ * file, or smbc_init not called. >+ * - EEXIST pathname already exists and O_CREAT and >+ * O_EXCL were used. >+ * - EISDIR pathname refers to a directory and >+ * the access requested involved writing. >+ * - EACCES The requested access to the file is not >+ * allowed >+ * - ENOENT A directory component in pathname does >+ * not exist. >+ * - ENODEV The requested share does not exist. >+ * @see smbc_open() >+ * >+ */ >+ >+int smbc_creat(const char *furl, mode_t mode); >+ >+/**@ingroup file >+ * Read from a file using an opened file handle. >+ * >+ * @param fd Open file handle from smbc_open() or smbc_creat() >+ * >+ * @param buf Pointer to buffer to recieve read data >+ * >+ * @param bufsize Size of buf in bytes >+ * >+ * @return Number of bytes read, < 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. >+ * - EINVAL fd is attached to an object which is >+ * unsuitable for reading, or no buffer passed or >+ * smbc_init not called. >+ * >+ * @see smbc_open(), smbc_write() >+ * >+ */ >+ssize_t smbc_read(int fd, void *buf, size_t bufsize); >+ >+ >+/**@ingroup file >+ * Write to a file using an opened file handle. >+ * >+ * @param fd Open file handle from smbc_open() or smbc_creat() >+ * >+ * @param buf Pointer to buffer to recieve read data >+ * >+ * @param bufsize Size of buf in bytes >+ * >+ * @return Number of bytes written, < 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. >+ * - EINVAL fd is attached to an object which is >+ * unsuitable for reading, or no buffer passed or >+ * smbc_init not called. >+ * >+ * @see smbc_open(), smbc_read() >+ * >+ */ >+ssize_t smbc_write(int fd, void *buf, size_t bufsize); >+ >+ >+/**@ingroup file >+ * Seek to a specific location in a file. >+ * >+ * @param fd Open file handle from smbc_open() or smbc_creat() >+ * >+ * @param offset Offset in bytes from whence >+ * >+ * @param whence A location in the file: >+ * - SEEK_SET The offset is set to offset bytes from >+ * the beginning of the file >+ * - SEEK_CUR The offset is set to current location >+ * plus offset bytes. >+ * - SEEK_END The offset is set to the size of the >+ * file plus offset bytes. >+ * >+ * @return Upon successful completion, lseek returns the >+ * resulting offset location as measured in bytes >+ * from the beginning of the file. Otherwise, a value >+ * of (off_t)-1 is returned and errno is set to >+ * indicate the error: >+ * - EBADF Fildes is not an open file descriptor. >+ * - EINVAL Whence is not a proper value or smbc_init >+ * not called. >+ * >+ * @todo Are all the whence values really supported? >+ * >+ * @todo Are errno values complete and correct? >+ */ >+off_t smbc_lseek(int fd, off_t offset, int whence); >+#if defined(SMBC_FILE_OFFSET_BITS) && SMBC_FILE_OFFSET_BITS == 64 && \ >+ defined(_FILE_OFFSET_BITS) && _FILE_OFFSET_BITS == 64 >+off_t smbc_lseek64(int fd, off_t offset, int whence); >+#define smbc_lseek smbc_lseek64 >+#endif >+ >+ >+/**@ingroup file >+ * Close an open file handle. >+ * >+ * @param fd The file handle to close >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EBADF fd isn't a valid open file descriptor >+ * - EINVAL smbc_init() failed or has not been called >+ * >+ * @see smbc_open(), smbc_creat() >+ */ >+int smbc_close(int fd); >+ >+ >+/**@ingroup directory >+ * Unlink (delete) a file or directory. >+ * >+ * @param furl The smb url of the file to delete >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EACCES or EPERM Write access to the directory >+ * containing pathname is not allowed or one >+ * of the directories in pathname did not allow >+ * search (execute) permission >+ * - ENOENT A directory component in pathname does >+ * not exist >+ * - EINVAL NULL was passed in the file param or >+ * smbc_init not called. >+ * - EACCES You do not have access to the file >+ * - ENOMEM Insufficient kernel memory was available >+ * >+ * @see smbc_rmdir()s >+ * >+ * @todo Are errno values complete and correct? >+ */ >+int smbc_unlink(const char *furl); >+ >+ >+/**@ingroup directory >+ * Rename or move a file or directory. >+ * >+ * @param ourl The original smb url (source url) of file or >+ * directory to be moved >+ * >+ * @param nurl The new smb url (destination url) of the file >+ * or directory after the move. Currently nurl must >+ * be on the same share as ourl. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EISDIR nurl is an existing directory, but ourl is >+ * not a directory. >+ * - EEXIST nurl is a non-empty directory, >+ * i.e., contains entries other than "." and ".." >+ * - EINVAL The new url contained a path prefix >+ * of the old, or, more generally, an attempt was >+ * made to make a directory a subdirectory of itself >+ * or smbc_init not called. >+ * - ENOTDIR A component used as a directory in ourl >+ * or nurl path is not, in fact, a directory. Or, >+ * ourl is a directory, and newpath exists but is not >+ * a directory. >+ * - EACCES or EPERM Write access to the directory >+ * containing ourl or nurl is not allowed for the >+ * process's effective uid, or one of the >+ * directories in ourl or nurl did not allow search >+ * (execute) permission, or ourl was a directory >+ * and did not allow write permission. >+ * - ENOENT A directory component in ourl or nurl >+ * does not exist. >+ * - EXDEV Rename across shares not supported. >+ * - ENOMEM Insufficient kernel memory was available. >+ * - EEXIST The target file, nurl, already exists. >+ * >+ * >+ * @todo Are we going to support copying when urls are not on the same >+ * share? I say no... NOTE. I agree for the moment. >+ * >+ */ >+int smbc_rename(const char *ourl, const char *nurl); >+ >+ >+/**@ingroup directory >+ * Open a directory used to obtain directory entries. >+ * >+ * @param durl The smb url of the directory to open >+ * >+ * @return Valid directory handle. < 0 on error with errno set: >+ * - EACCES Permission denied. >+ * - EINVAL A NULL file/URL was passed, or the URL would >+ * not parse, or was of incorrect form or smbc_init not >+ * called. >+ * - ENOENT durl does not exist, or name is an >+ * - ENOMEM Insufficient memory to complete the >+ * operation. >+ * - ENOTDIR name is not a directory. >+ * - EPERM the workgroup could not be found. >+ * - ENODEV the workgroup or server could not be found. >+ * >+ * @see smbc_getdents(), smbc_readdir(), smbc_closedir() >+ * >+ */ >+int smbc_opendir(const char *durl); >+ >+ >+/**@ingroup directory >+ * Close a directory handle opened by smbc_opendir(). >+ * >+ * @param dh Directory handle to close >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EBADF dh is an invalid directory handle >+ * >+ * @see smbc_opendir() >+ */ >+int smbc_closedir(int dh); >+ >+ >+/**@ingroup directory >+ * Get multiple directory entries. >+ * >+ * smbc_getdents() reads as many dirent structures from the an open >+ * directory handle into a specified memory area as will fit. >+ * >+ * @param dh Valid directory as returned by smbc_opendir() >+ * >+ * @param dirp pointer to buffer that will receive the directory >+ * entries. >+ * >+ * @param count The size of the dirp buffer in bytes >+ * >+ * @returns If any dirents returned, return will indicate the >+ * total size. If there were no more dirents available, >+ * 0 is returned. < 0 indicates an error. >+ * - EBADF Invalid directory handle >+ * - EINVAL Result buffer is too small or smbc_init >+ * not called. >+ * - ENOENT No such directory. >+ * @see , smbc_dirent, smbc_readdir(), smbc_open() >+ * >+ * @todo Are errno values complete and correct? >+ * >+ * @todo Add example code so people know how to parse buffers. >+ */ >+int smbc_getdents(unsigned int dh, struct smbc_dirent *dirp, int count); >+ >+ >+/**@ingroup directory >+ * Get a single directory entry. >+ * >+ * @param dh Valid directory as returned by smbc_opendir() >+ * >+ * @return A pointer to a smbc_dirent structure, or NULL if an >+ * error occurs or end-of-directory is reached: >+ * - EBADF Invalid directory handle >+ * - EINVAL smbc_init() failed or has not been called >+ * >+ * @see smbc_dirent, smbc_getdents(), smbc_open() >+ */ >+struct smbc_dirent* smbc_readdir(unsigned int dh); >+ >+ >+/**@ingroup directory >+ * Get the current directory offset. >+ * >+ * smbc_telldir() may be used in conjunction with smbc_readdir() and >+ * smbc_lseekdir(). >+ * >+ * @param dh Valid directory as returned by smbc_opendir() >+ * >+ * @return The current location in the directory stream or -1 >+ * if an error occur. The current location is not >+ * an offset. Becuase of the implementation, it is a >+ * handle that allows the library to find the entry >+ * later. >+ * - EBADF dh is not a valid directory handle >+ * - EINVAL smbc_init() failed or has not been called >+ * - ENOTDIR if dh is not a directory >+ * >+ * @see smbc_readdir() >+ * >+ */ >+off_t smbc_telldir(int dh); >+#if defined(SMBC_FILE_OFFSET_BITS) && SMBC_FILE_OFFSET_BITS == 64 && \ >+ defined(_FILE_OFFSET_BITS) && _FILE_OFFSET_BITS == 64 >+off_t smbc_telldir64(int dh); >+#define smbc_telldir smbc_telldir64 >+#endif >+ >+ >+/**@ingroup directory >+ * lseek on directories. >+ * >+ * smbc_lseekdir() may be used in conjunction with smbc_readdir() and >+ * smbc_telldir(). (rewind by smbc_lseekdir(fd, NULL)) >+ * >+ * @param fd Valid directory as returned by smbc_opendir() >+ * >+ * @param offset The offset (as returned by smbc_telldir). Can be >+ * NULL, in which case we will rewind >+ * >+ * @return 0 on success, -1 on failure >+ * - EBADF dh is not a valid directory handle >+ * - ENOTDIR if dh is not a directory >+ * - EINVAL offset did not refer to a valid dirent or >+ * smbc_init not called. >+ * >+ * @see smbc_telldir() >+ * >+ * >+ * @todo In what does the reture and errno values mean? >+ */ >+int smbc_lseekdir(int fd, off_t offset); >+#if defined(SMBC_FILE_OFFSET_BITS) && SMBC_FILE_OFFSET_BITS == 64 && \ >+ defined(_FILE_OFFSET_BITS) && _FILE_OFFSET_BITS == 64 >+int smbc_lseekdir64(int fd, off_t offset); >+#define smbc_lseekdir smbc_lseekdir64 >+#endif >+ >+/**@ingroup directory >+ * Create a directory. >+ * >+ * @param durl The url of the directory to create >+ * >+ * @param mode Specifies the permissions to use. It is modified >+ * by the process's umask in the usual way: the >+ * permissions of the created file are (mode & ~umask). >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EEXIST directory url already exists >+ * - EACCES The parent directory does not allow write >+ * permission to the process, or one of the directories >+ * - ENOENT A directory component in pathname does not >+ * exist. >+ * - EINVAL NULL durl passed or smbc_init not called. >+ * - ENOMEM Insufficient memory was available. >+ * >+ * @see smbc_rmdir() >+ * >+ */ >+int smbc_mkdir(const char *durl, mode_t mode); >+ >+ >+/**@ingroup directory >+ * Remove a directory. >+ * >+ * @param durl The smb url of the directory to remove >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EACCES or EPERM Write access to the directory >+ * containing pathname was not allowed. >+ * - EINVAL durl is NULL or smbc_init not called. >+ * - ENOENT A directory component in pathname does not >+ * exist. >+ * - ENOTEMPTY directory contains entries. >+ * - ENOMEM Insufficient kernel memory was available. >+ * >+ * @see smbc_mkdir(), smbc_unlink() >+ * >+ * @todo Are errno values complete and correct? >+ */ >+int smbc_rmdir(const char *durl); >+ >+ >+/**@ingroup attribute >+ * Get information about a file or directory. >+ * >+ * @param url The smb url to get information for >+ * >+ * @param st pointer to a buffer that will be filled with >+ * standard Unix struct stat information. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - ENOENT A component of the path file_name does not >+ * exist. >+ * - EINVAL a NULL url was passed or smbc_init not called. >+ * - EACCES Permission denied. >+ * - ENOMEM Out of memory >+ * - ENOTDIR The target dir, url, is not a directory. >+ * >+ * @see Unix stat() >+ * >+ */ >+int smbc_stat(const char *url, struct stat *st); >+#if defined(SMBC_FILE_OFFSET_BITS) && SMBC_FILE_OFFSET_BITS == 64 && \ >+ defined(_FILE_OFFSET_BITS) && _FILE_OFFSET_BITS == 64 >+int smbc_stat64(const char *url, struct stat *st); >+#define smbc_stat smbc_stat64 >+#endif >+ >+ >+/**@ingroup attribute >+ * Get file information via an file descriptor. >+ * >+ * @param fd Open file handle from smbc_open() or smbc_creat() >+ * >+ * @param st pointer to a buffer that will be filled with >+ * standard Unix struct stat information. >+ * >+ * @return EBADF filedes is bad. >+ * - EACCES Permission denied. >+ * - EBADF fd is not a valid file descriptor >+ * - EINVAL Problems occurred in the underlying routines >+ * or smbc_init not called. >+ * - ENOMEM Out of memory >+ * >+ * @see smbc_stat(), Unix stat() >+ * >+ */ >+int smbc_fstat(int fd, struct stat *st); >+#if defined(SMBC_FILE_OFFSET_BITS) && SMBC_FILE_OFFSET_BITS == 64 && \ >+ defined(_FILE_OFFSET_BITS) && _FILE_OFFSET_BITS == 64 >+int smbc_fstat64(int fd, struct stat *st); >+#define smbc_fstat smbc_fstat64 >+#endif >+ >+ >+/**@ingroup attribue >+ * Change the ownership of a file or directory. >+ * >+ * @param url The smb url of the file or directory to change >+ * ownership of. >+ * >+ * @param owner I have no idea? >+ * >+ * @param group I have not idea? >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EPERM The effective UID does not match the owner >+ * of the file, and is not zero; or the owner or group >+ * were specified incorrectly. >+ * - ENOENT The file does not exist. >+ * - ENOMEM Insufficient was available. >+ * - ENOENT file or directory does not exist >+ * >+ * @todo Are we actually going to be able to implement this function >+ * >+ * @todo How do we abstract owner and group uid and gid? >+ * >+ */ >+int smbc_chown(const char *url, uid_t owner, gid_t group); >+ >+ >+/**@ingroup attribute >+ * Change the permissions of a file. >+ * >+ * @param url The smb url of the file or directory to change >+ * permissions of >+ * >+ * @param mode The permissions to set: >+ * - Put good explaination of permissions here! >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EPERM The effective UID does not match the owner >+ * of the file, and is not zero >+ * - ENOENT The file does not exist. >+ * - ENOMEM Insufficient was available. >+ * - ENOENT file or directory does not exist >+ * >+ * @todo Actually implement this fuction? >+ * >+ * @todo Are errno values complete and correct? >+ */ >+int smbc_chmod(const char *url, mode_t mode); >+ >+/** >+ * @ingroup attribute >+ * Change the last modification time on a file >+ * >+ * @param url The smb url of the file or directory to change >+ * the modification time of >+ * >+ * @param tbuf An array of two timeval structures which contains, >+ * respectively, the desired access and modification times. >+ * NOTE: Only the tv_sec field off each timeval structure is >+ * used. The tv_usec (microseconds) portion is ignored. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EINVAL The client library is not properly initialized >+ * - EPERM Permission was denied. >+ * >+ */ >+int smbc_utimes(const char *url, struct timeval *tbuf); >+ >+#ifdef HAVE_UTIME_H >+/** >+ * @ingroup attribute >+ * Change the last modification time on a file >+ * >+ * @param url The smb url of the file or directory to change >+ * the modification time of >+ * >+ * @param utbuf A pointer to a utimebuf structure which contains the >+ * desired access and modification times. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EINVAL The client library is not properly initialized >+ * - ENOMEM No memory was available for internal needs >+ * - EPERM Permission was denied. >+ * >+ */ >+int smbc_utime(const char *fname, struct utimbuf *utbuf); >+#endif >+ >+/**@ingroup attribute >+ * Set extended attributes for a file. This is used for modifying a file's >+ * security descriptor (i.e. owner, group, and access control list) >+ * >+ * @param url The smb url of the file or directory to set extended >+ * attributes for. >+ * >+ * @param name The name of an attribute to be changed. Names are of >+ * one of the following forms: >+ * >+ * system.nt_sec_desc.<attribute name> >+ * system.nt_sec_desc.* >+ * system.nt_sec_desc.*+ >+ * >+ * where <attribute name> is one of: >+ * >+ * revision >+ * owner >+ * owner+ >+ * group >+ * group+ >+ * acl:<name or sid> >+ * acl+:<name or sid> >+ * >+ * In the forms "system.nt_sec_desc.*" and >+ * "system.nt_sec_desc.*+", the asterisk and plus signs are >+ * literal, i.e. the string is provided exactly as shown, and >+ * the value parameter should contain a complete security >+ * descriptor with name:value pairs separated by tabs, >+ * commas, or newlines (not spaces!). >+ * >+ * The plus sign ('+') indicates that SIDs should be mapped >+ * to names. Without the plus sign, SIDs are not mapped; >+ * rather they are simply converted to a string format. >+ * >+ * @param value The value to be assigned to the specified attribute name. >+ * This buffer should contain only the attribute value if the >+ * name was of the "system.nt_sec_desc.<attribute_name>" >+ * form. If the name was of the "system.nt_sec_desc.*" form >+ * then a complete security descriptor, with name:value pairs >+ * separated by tabs, commas, or newlines (not spaces!), >+ * should be provided in this value buffer. A complete >+ * security descriptor will contain one or more entries >+ * selected from the following: >+ * >+ * REVISION:<revision number> >+ * OWNER:<sid or name> >+ * GROUP:<sid or name> >+ * ACL:<sid or name>:<type>/<flags>/<mask> >+ * >+ * The revision of the ACL specifies the internal Windows NT >+ * ACL revision for the security descriptor. If not specified >+ * it defaults to 1. Using values other than 1 may cause >+ * strange behaviour. >+ * >+ * The owner and group specify the owner and group sids for >+ * the object. If the attribute name (either '*+' with a >+ * complete security descriptor, or individual 'owner+' or >+ * 'group+' attribute names) ended with a plus sign, the >+ * specified name is resolved to a SID value, using the >+ * server on which the file or directory resides. Otherwise, >+ * the value should be provided in SID-printable format as >+ * S-1-x-y-z, and is used directly. The <sid or name> >+ * associated with the ACL: attribute should be provided >+ * similarly. >+ * >+ * @param size The number of the bytes of data in the value buffer >+ * >+ * @param flags A bit-wise OR of zero or more of the following: >+ * SMBC_XATTR_FLAG_CREATE - >+ * fail if the named attribute already exists >+ * SMBC_XATTR_FLAG_REPLACE - >+ * fail if the attribute does not already exist >+ * >+ * If neither flag is specified, the specified attributes >+ * will be added or replace existing attributes of the same >+ * name, as necessary. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EINVAL The client library is not properly initialized >+ * or one of the parameters is not of a correct >+ * form >+ * - ENOMEM No memory was available for internal needs >+ * - EEXIST If the attribute already exists and the flag >+ * SMBC_XATTR_FLAG_CREAT was specified >+ * - ENOATTR If the attribute does not exist and the flag >+ * SMBC_XATTR_FLAG_REPLACE was specified >+ * - EPERM Permission was denied. >+ * - ENOTSUP The referenced file system does not support >+ * extended attributes >+ * >+ * @note Attribute names are compared in a case-insensitive >+ * fashion. All of the following are equivalent, although >+ * the all-lower-case name is the preferred format: >+ * system.nt_sec_desc.owner >+ * SYSTEM.NT_SEC_DESC.OWNER >+ * sYsTeM.nt_sEc_desc.owNER >+ * >+ */ >+int smbc_setxattr(const char *url, >+ const char *name, >+ const void *value, >+ size_t size, >+ int flags); >+ >+ >+/**@ingroup attribute >+ * Set extended attributes for a file. This is used for modifying a file's >+ * security descriptor (i.e. owner, group, and access control list). The >+ * POSIX function which this maps to would act on a symbolic link rather than >+ * acting on what the symbolic link points to, but with no symbolic links in >+ * SMB file systems, this function is functionally identical to >+ * smbc_setxattr(). >+ * >+ * @param url The smb url of the file or directory to set extended >+ * attributes for. >+ * >+ * @param name The name of an attribute to be changed. Names are of >+ * one of the following forms: >+ * >+ * system.nt_sec_desc.<attribute name> >+ * system.nt_sec_desc.* >+ * system.nt_sec_desc.*+ >+ * >+ * where <attribute name> is one of: >+ * >+ * revision >+ * owner >+ * owner+ >+ * group >+ * group+ >+ * acl:<name or sid> >+ * acl+:<name or sid> >+ * >+ * In the forms "system.nt_sec_desc.*" and >+ * "system.nt_sec_desc.*+", the asterisk and plus signs are >+ * literal, i.e. the string is provided exactly as shown, and >+ * the value parameter should contain a complete security >+ * descriptor with name:value pairs separated by tabs, >+ * commas, or newlines (not spaces!). >+ * >+ * The plus sign ('+') indicates that SIDs should be mapped >+ * to names. Without the plus sign, SIDs are not mapped; >+ * rather they are simply converted to a string format. >+ * >+ * @param value The value to be assigned to the specified attribute name. >+ * This buffer should contain only the attribute value if the >+ * name was of the "system.nt_sec_desc.<attribute_name>" >+ * form. If the name was of the "system.nt_sec_desc.*" form >+ * then a complete security descriptor, with name:value pairs >+ * separated by tabs, commas, or newlines (not spaces!), >+ * should be provided in this value buffer. A complete >+ * security descriptor will contain one or more entries >+ * selected from the following: >+ * >+ * REVISION:<revision number> >+ * OWNER:<sid or name> >+ * GROUP:<sid or name> >+ * ACL:<sid or name>:<type>/<flags>/<mask> >+ * >+ * The revision of the ACL specifies the internal Windows NT >+ * ACL revision for the security descriptor. If not specified >+ * it defaults to 1. Using values other than 1 may cause >+ * strange behaviour. >+ * >+ * The owner and group specify the owner and group sids for >+ * the object. If the attribute name (either '*+' with a >+ * complete security descriptor, or individual 'owner+' or >+ * 'group+' attribute names) ended with a plus sign, the >+ * specified name is resolved to a SID value, using the >+ * server on which the file or directory resides. Otherwise, >+ * the value should be provided in SID-printable format as >+ * S-1-x-y-z, and is used directly. The <sid or name> >+ * associated with the ACL: attribute should be provided >+ * similarly. >+ * >+ * @param size The number of the bytes of data in the value buffer >+ * >+ * @param flags A bit-wise OR of zero or more of the following: >+ * SMBC_XATTR_FLAG_CREATE - >+ * fail if the named attribute already exists >+ * SMBC_XATTR_FLAG_REPLACE - >+ * fail if the attribute does not already exist >+ * >+ * If neither flag is specified, the specified attributes >+ * will be added or replace existing attributes of the same >+ * name, as necessary. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EINVAL The client library is not properly initialized >+ * or one of the parameters is not of a correct >+ * form >+ * - ENOMEM No memory was available for internal needs >+ * - EEXIST If the attribute already exists and the flag >+ * SMBC_XATTR_FLAG_CREAT was specified >+ * - ENOATTR If the attribute does not exist and the flag >+ * SMBC_XATTR_FLAG_REPLACE was specified >+ * - EPERM Permission was denied. >+ * - ENOTSUP The referenced file system does not support >+ * extended attributes >+ * >+ * @note Attribute names are compared in a case-insensitive >+ * fashion. All of the following are equivalent, although >+ * the all-lower-case name is the preferred format: >+ * system.nt_sec_desc.owner >+ * SYSTEM.NT_SEC_DESC.OWNER >+ * sYsTeM.nt_sEc_desc.owNER >+ * >+ */ >+int smbc_lsetxattr(const char *url, >+ const char *name, >+ const void *value, >+ size_t size, >+ int flags); >+ >+ >+/**@ingroup attribute >+ * Set extended attributes for a file. This is used for modifying a file's >+ * security descriptor (i.e. owner, group, and access control list) >+ * >+ * @param fd A file descriptor associated with an open file (as >+ * previously returned by smbc_open(), to get extended >+ * attributes for. >+ * >+ * @param name The name of an attribute to be changed. Names are of >+ * one of the following forms: >+ * >+ * system.nt_sec_desc.<attribute name> >+ * system.nt_sec_desc.* >+ * system.nt_sec_desc.*+ >+ * >+ * where <attribute name> is one of: >+ * >+ * revision >+ * owner >+ * owner+ >+ * group >+ * group+ >+ * acl:<name or sid> >+ * acl+:<name or sid> >+ * >+ * In the forms "system.nt_sec_desc.*" and >+ * "system.nt_sec_desc.*+", the asterisk and plus signs are >+ * literal, i.e. the string is provided exactly as shown, and >+ * the value parameter should contain a complete security >+ * descriptor with name:value pairs separated by tabs, >+ * commas, or newlines (not spaces!). >+ * >+ * The plus sign ('+') indicates that SIDs should be mapped >+ * to names. Without the plus sign, SIDs are not mapped; >+ * rather they are simply converted to a string format. >+ * >+ * @param value The value to be assigned to the specified attribute name. >+ * This buffer should contain only the attribute value if the >+ * name was of the "system.nt_sec_desc.<attribute_name>" >+ * form. If the name was of the "system.nt_sec_desc.*" form >+ * then a complete security descriptor, with name:value pairs >+ * separated by tabs, commas, or newlines (not spaces!), >+ * should be provided in this value buffer. A complete >+ * security descriptor will contain one or more entries >+ * selected from the following: >+ * >+ * REVISION:<revision number> >+ * OWNER:<sid or name> >+ * GROUP:<sid or name> >+ * ACL:<sid or name>:<type>/<flags>/<mask> >+ * >+ * The revision of the ACL specifies the internal Windows NT >+ * ACL revision for the security descriptor. If not specified >+ * it defaults to 1. Using values other than 1 may cause >+ * strange behaviour. >+ * >+ * The owner and group specify the owner and group sids for >+ * the object. If the attribute name (either '*+' with a >+ * complete security descriptor, or individual 'owner+' or >+ * 'group+' attribute names) ended with a plus sign, the >+ * specified name is resolved to a SID value, using the >+ * server on which the file or directory resides. Otherwise, >+ * the value should be provided in SID-printable format as >+ * S-1-x-y-z, and is used directly. The <sid or name> >+ * associated with the ACL: attribute should be provided >+ * similarly. >+ * >+ * @param size The number of the bytes of data in the value buffer >+ * >+ * @param flags A bit-wise OR of zero or more of the following: >+ * SMBC_XATTR_FLAG_CREATE - >+ * fail if the named attribute already exists >+ * SMBC_XATTR_FLAG_REPLACE - >+ * fail if the attribute does not already exist >+ * >+ * If neither flag is specified, the specified attributes >+ * will be added or replace existing attributes of the same >+ * name, as necessary. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EINVAL The client library is not properly initialized >+ * or one of the parameters is not of a correct >+ * form >+ * - ENOMEM No memory was available for internal needs >+ * - EEXIST If the attribute already exists and the flag >+ * SMBC_XATTR_FLAG_CREAT was specified >+ * - ENOATTR If the attribute does not exist and the flag >+ * SMBC_XATTR_FLAG_REPLACE was specified >+ * - EPERM Permission was denied. >+ * - ENOTSUP The referenced file system does not support >+ * extended attributes >+ * >+ * @note Attribute names are compared in a case-insensitive >+ * fashion. All of the following are equivalent, although >+ * the all-lower-case name is the preferred format: >+ * system.nt_sec_desc.owner >+ * SYSTEM.NT_SEC_DESC.OWNER >+ * sYsTeM.nt_sEc_desc.owNER >+ * >+ */ >+int smbc_fsetxattr(int fd, >+ const char *name, >+ const void *value, >+ size_t size, >+ int flags); >+ >+ >+/**@ingroup attribute >+ * Get extended attributes for a file. >+ * >+ * @param url The smb url of the file or directory to get extended >+ * attributes for. >+ * >+ * @param name The name of an attribute to be retrieved. Names are of >+ * one of the following forms: >+ * >+ * system.nt_sec_desc.<attribute name> >+ * system.nt_sec_desc.* >+ * system.nt_sec_desc.*+ >+ * >+ * where <attribute name> is one of: >+ * >+ * revision >+ * owner >+ * owner+ >+ * group >+ * group+ >+ * acl:<name or sid> >+ * acl+:<name or sid> >+ * >+ * In the forms "system.nt_sec_desc.*" and >+ * "system.nt_sec_desc.*+", the asterisk and plus signs are >+ * literal, i.e. the string is provided exactly as shown, and >+ * the value parameter will return a complete security >+ * descriptor with name:value pairs separated by tabs, >+ * commas, or newlines (not spaces!). >+ * >+ * The plus sign ('+') indicates that SIDs should be mapped >+ * to names. Without the plus sign, SIDs are not mapped; >+ * rather they are simply converted to a string format. >+ * >+ * @param value A pointer to a buffer in which the value of the specified >+ * attribute will be placed (unless size is zero). >+ * >+ * @param size The size of the buffer pointed to by value. This parameter >+ * may also be zero, in which case the size of the buffer >+ * required to hold the attribute value will be returned, >+ * but nothing will be placed into the value buffer. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EINVAL The client library is not properly initialized >+ * or one of the parameters is not of a correct >+ * form >+ * - ENOMEM No memory was available for internal needs >+ * - EEXIST If the attribute already exists and the flag >+ * SMBC_XATTR_FLAG_CREAT was specified >+ * - ENOATTR If the attribute does not exist and the flag >+ * SMBC_XATTR_FLAG_REPLACE was specified >+ * - EPERM Permission was denied. >+ * - ENOTSUP The referenced file system does not support >+ * extended attributes >+ * >+ */ >+int smbc_getxattr(const char *url, >+ const char *name, >+ const void *value, >+ size_t size); >+ >+ >+/**@ingroup attribute >+ * Get extended attributes for a file. The POSIX function which this maps to >+ * would act on a symbolic link rather than acting on what the symbolic link >+ * points to, but with no symbolic links in SMB file systems, this function >+ * is functionally identical to smbc_getxattr(). >+ * >+ * @param url The smb url of the file or directory to get extended >+ * attributes for. >+ * >+ * @param name The name of an attribute to be retrieved. Names are of >+ * one of the following forms: >+ * >+ * system.nt_sec_desc.<attribute name> >+ * system.nt_sec_desc.* >+ * system.nt_sec_desc.*+ >+ * >+ * where <attribute name> is one of: >+ * >+ * revision >+ * owner >+ * owner+ >+ * group >+ * group+ >+ * acl:<name or sid> >+ * acl+:<name or sid> >+ * >+ * In the forms "system.nt_sec_desc.*" and >+ * "system.nt_sec_desc.*+", the asterisk and plus signs are >+ * literal, i.e. the string is provided exactly as shown, and >+ * the value parameter will return a complete security >+ * descriptor with name:value pairs separated by tabs, >+ * commas, or newlines (not spaces!). >+ * >+ * The plus sign ('+') indicates that SIDs should be mapped >+ * to names. Without the plus sign, SIDs are not mapped; >+ * rather they are simply converted to a string format. >+ * >+ * @param value A pointer to a buffer in which the value of the specified >+ * attribute will be placed (unless size is zero). >+ * >+ * @param size The size of the buffer pointed to by value. This parameter >+ * may also be zero, in which case the size of the buffer >+ * required to hold the attribute value will be returned, >+ * but nothing will be placed into the value buffer. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EINVAL The client library is not properly initialized >+ * or one of the parameters is not of a correct >+ * form >+ * - ENOMEM No memory was available for internal needs >+ * - EEXIST If the attribute already exists and the flag >+ * SMBC_XATTR_FLAG_CREAT was specified >+ * - ENOATTR If the attribute does not exist and the flag >+ * SMBC_XATTR_FLAG_REPLACE was specified >+ * - EPERM Permission was denied. >+ * - ENOTSUP The referenced file system does not support >+ * extended attributes >+ * >+ */ >+int smbc_lgetxattr(const char *url, >+ const char *name, >+ const void *value, >+ size_t size); >+ >+ >+/**@ingroup attribute >+ * Get extended attributes for a file. >+ * >+ * @param fd A file descriptor associated with an open file (as >+ * previously returned by smbc_open(), to get extended >+ * attributes for. >+ * >+ * @param name The name of an attribute to be retrieved. Names are of >+ * one of the following forms: >+ * >+ * system.nt_sec_desc.<attribute name> >+ * system.nt_sec_desc.* >+ * system.nt_sec_desc.*+ >+ * >+ * where <attribute name> is one of: >+ * >+ * revision >+ * owner >+ * owner+ >+ * group >+ * group+ >+ * acl:<name or sid> >+ * acl+:<name or sid> >+ * >+ * In the forms "system.nt_sec_desc.*" and >+ * "system.nt_sec_desc.*+", the asterisk and plus signs are >+ * literal, i.e. the string is provided exactly as shown, and >+ * the value parameter will return a complete security >+ * descriptor with name:value pairs separated by tabs, >+ * commas, or newlines (not spaces!). >+ * >+ * The plus sign ('+') indicates that SIDs should be mapped >+ * to names. Without the plus sign, SIDs are not mapped; >+ * rather they are simply converted to a string format. >+ * >+ * @param value A pointer to a buffer in which the value of the specified >+ * attribute will be placed (unless size is zero). >+ * >+ * @param size The size of the buffer pointed to by value. This parameter >+ * may also be zero, in which case the size of the buffer >+ * required to hold the attribute value will be returned, >+ * but nothing will be placed into the value buffer. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EINVAL The client library is not properly initialized >+ * or one of the parameters is not of a correct >+ * form >+ * - ENOMEM No memory was available for internal needs >+ * - EEXIST If the attribute already exists and the flag >+ * SMBC_XATTR_FLAG_CREAT was specified >+ * - ENOATTR If the attribute does not exist and the flag >+ * SMBC_XATTR_FLAG_REPLACE was specified >+ * - EPERM Permission was denied. >+ * - ENOTSUP The referenced file system does not support >+ * extended attributes >+ * >+ */ >+int smbc_fgetxattr(int fd, >+ const char *name, >+ const void *value, >+ size_t size); >+ >+ >+/**@ingroup attribute >+ * Remove extended attributes for a file. This is used for modifying a file's >+ * security descriptor (i.e. owner, group, and access control list) >+ * >+ * @param url The smb url of the file or directory to remove the extended >+ * attributes for. >+ * >+ * @param name The name of an attribute to be removed. Names are of >+ * one of the following forms: >+ * >+ * system.nt_sec_desc.<attribute name> >+ * system.nt_sec_desc.* >+ * system.nt_sec_desc.*+ >+ * >+ * where <attribute name> is one of: >+ * >+ * revision >+ * owner >+ * owner+ >+ * group >+ * group+ >+ * acl:<name or sid> >+ * acl+:<name or sid> >+ * >+ * In the forms "system.nt_sec_desc.*" and >+ * "system.nt_sec_desc.*+", the asterisk and plus signs are >+ * literal, i.e. the string is provided exactly as shown, and >+ * the value parameter will return a complete security >+ * descriptor with name:value pairs separated by tabs, >+ * commas, or newlines (not spaces!). >+ * >+ * The plus sign ('+') indicates that SIDs should be mapped >+ * to names. Without the plus sign, SIDs are not mapped; >+ * rather they are simply converted to a string format. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EINVAL The client library is not properly initialized >+ * - ENOMEM No memory was available for internal needs >+ * - EPERM Permission was denied. >+ * - ENOTSUP The referenced file system does not support >+ * extended attributes >+ * >+ */ >+int smbc_removexattr(const char *url, >+ const char *name); >+ >+ >+/**@ingroup attribute >+ * Remove extended attributes for a file. This is used for modifying a file's >+ * security descriptor (i.e. owner, group, and access control list) The POSIX >+ * function which this maps to would act on a symbolic link rather than acting >+ * on what the symbolic link points to, but with no symbolic links in SMB file >+ * systems, this function is functionally identical to smbc_removexattr(). >+ * >+ * @param url The smb url of the file or directory to remove the extended >+ * attributes for. >+ * >+ * @param name The name of an attribute to be removed. Names are of >+ * one of the following forms: >+ * >+ * system.nt_sec_desc.<attribute name> >+ * system.nt_sec_desc.* >+ * system.nt_sec_desc.*+ >+ * >+ * where <attribute name> is one of: >+ * >+ * revision >+ * owner >+ * owner+ >+ * group >+ * group+ >+ * acl:<name or sid> >+ * acl+:<name or sid> >+ * >+ * In the forms "system.nt_sec_desc.*" and >+ * "system.nt_sec_desc.*+", the asterisk and plus signs are >+ * literal, i.e. the string is provided exactly as shown, and >+ * the value parameter will return a complete security >+ * descriptor with name:value pairs separated by tabs, >+ * commas, or newlines (not spaces!). >+ * >+ * The plus sign ('+') indicates that SIDs should be mapped >+ * to names. Without the plus sign, SIDs are not mapped; >+ * rather they are simply converted to a string format. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EINVAL The client library is not properly initialized >+ * - ENOMEM No memory was available for internal needs >+ * - EPERM Permission was denied. >+ * - ENOTSUP The referenced file system does not support >+ * extended attributes >+ * >+ */ >+int smbc_lremovexattr(const char *url, >+ const char *name); >+ >+ >+/**@ingroup attribute >+ * Remove extended attributes for a file. This is used for modifying a file's >+ * security descriptor (i.e. owner, group, and access control list) >+ * >+ * @param fd A file descriptor associated with an open file (as >+ * previously returned by smbc_open(), to get extended >+ * attributes for. >+ * >+ * @param name The name of an attribute to be removed. Names are of >+ * one of the following forms: >+ * >+ * system.nt_sec_desc.<attribute name> >+ * system.nt_sec_desc.* >+ * system.nt_sec_desc.*+ >+ * >+ * where <attribute name> is one of: >+ * >+ * revision >+ * owner >+ * owner+ >+ * group >+ * group+ >+ * acl:<name or sid> >+ * acl+:<name or sid> >+ * >+ * In the forms "system.nt_sec_desc.*" and >+ * "system.nt_sec_desc.*+", the asterisk and plus signs are >+ * literal, i.e. the string is provided exactly as shown, and >+ * the value parameter will return a complete security >+ * descriptor with name:value pairs separated by tabs, >+ * commas, or newlines (not spaces!). >+ * >+ * The plus sign ('+') indicates that SIDs should be mapped >+ * to names. Without the plus sign, SIDs are not mapped; >+ * rather they are simply converted to a string format. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EINVAL The client library is not properly initialized >+ * - ENOMEM No memory was available for internal needs >+ * - EPERM Permission was denied. >+ * - ENOTSUP The referenced file system does not support >+ * extended attributes >+ * >+ */ >+int smbc_fremovexattr(int fd, >+ const char *name); >+ >+ >+/**@ingroup attribute >+ * List the supported extended attribute names associated with a file >+ * >+ * @param url The smb url of the file or directory to list the extended >+ * attributes for. >+ * >+ * @param list A pointer to a buffer in which the list of attributes for >+ * the specified file or directory will be placed (unless >+ * size is zero). >+ * >+ * @param size The size of the buffer pointed to by list. This parameter >+ * may also be zero, in which case the size of the buffer >+ * required to hold all of the attribute names will be >+ * returned, but nothing will be placed into the list buffer. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EINVAL The client library is not properly initialized >+ * - ENOMEM No memory was available for internal needs >+ * - EPERM Permission was denied. >+ * - ENOTSUP The referenced file system does not support >+ * extended attributes >+ * >+ * @note This function always returns all attribute names supported >+ * by NT file systems, regardless of wether the referenced >+ * file system supports extended attributes (e.g. a Windows >+ * 2000 machine supports extended attributes if NTFS is used, >+ * but not if FAT is used, and Windows 98 doesn't support >+ * extended attributes at all. Whether this is a feature or >+ * a bug is yet to be decided. >+ */ >+int smbc_listxattr(const char *url, >+ char *list, >+ size_t size); >+ >+/**@ingroup attribute >+ * List the supported extended attribute names associated with a file The >+ * POSIX function which this maps to would act on a symbolic link rather than >+ * acting on what the symbolic link points to, but with no symbolic links in >+ * SMB file systems, this function is functionally identical to >+ * smbc_listxattr(). >+ * >+ * @param url The smb url of the file or directory to list the extended >+ * attributes for. >+ * >+ * @param list A pointer to a buffer in which the list of attributes for >+ * the specified file or directory will be placed (unless >+ * size is zero). >+ * >+ * @param size The size of the buffer pointed to by list. This parameter >+ * may also be zero, in which case the size of the buffer >+ * required to hold all of the attribute names will be >+ * returned, but nothing will be placed into the list buffer. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EINVAL The client library is not properly initialized >+ * - ENOMEM No memory was available for internal needs >+ * - EPERM Permission was denied. >+ * - ENOTSUP The referenced file system does not support >+ * extended attributes >+ * >+ * @note This function always returns all attribute names supported >+ * by NT file systems, regardless of wether the referenced >+ * file system supports extended attributes (e.g. a Windows >+ * 2000 machine supports extended attributes if NTFS is used, >+ * but not if FAT is used, and Windows 98 doesn't support >+ * extended attributes at all. Whether this is a feature or >+ * a bug is yet to be decided. >+ */ >+int smbc_llistxattr(const char *url, >+ char *list, >+ size_t size); >+ >+/**@ingroup attribute >+ * List the supported extended attribute names associated with a file >+ * >+ * @param fd A file descriptor associated with an open file (as >+ * previously returned by smbc_open(), to get extended >+ * attributes for. >+ * >+ * @param list A pointer to a buffer in which the list of attributes for >+ * the specified file or directory will be placed (unless >+ * size is zero). >+ * >+ * @param size The size of the buffer pointed to by list. This parameter >+ * may also be zero, in which case the size of the buffer >+ * required to hold all of the attribute names will be >+ * returned, but nothing will be placed into the list buffer. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EINVAL The client library is not properly initialized >+ * - ENOMEM No memory was available for internal needs >+ * - EPERM Permission was denied. >+ * - ENOTSUP The referenced file system does not support >+ * extended attributes >+ * >+ * @note This function always returns all attribute names supported >+ * by NT file systems, regardless of wether the referenced >+ * file system supports extended attributes (e.g. a Windows >+ * 2000 machine supports extended attributes if NTFS is used, >+ * but not if FAT is used, and Windows 98 doesn't support >+ * extended attributes at all. Whether this is a feature or >+ * a bug is yet to be decided. >+ */ >+int smbc_flistxattr(int fd, >+ char *list, >+ size_t size); >+ >+/**@ingroup print >+ * Print a file given the name in fname. It would be a URL ... >+ * >+ * @param fname The URL of a file on a remote SMB server that the >+ * caller wants printed >+ * >+ * @param printq The URL of the print share to print the file to. >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * >+ * - EINVAL fname or printq was NULL or smbc_init not >+ * not called. >+ * and errors returned by smbc_open >+ * >+ */ >+int smbc_print_file(const char *fname, const char *printq); >+ >+/**@ingroup print >+ * Open a print file that can be written to by other calls. This simply >+ * does an smbc_open call after checking if there is a file name on the >+ * URI. If not, a temporary name is added ... >+ * >+ * @param fname The URL of the print share to print to? >+ * >+ * @returns A file handle for the print file if successful. >+ * Returns -1 if an error ocurred and errno has the values >+ * - EINVAL fname was NULL or smbc_init not called. >+ * - all errors returned by smbc_open >+ * >+ */ >+int smbc_open_print_job(const char *fname); >+ >+/**@ingroup print >+ * List the print jobs on a print share, for the moment, pass a callback >+ * >+ * @param purl The url of the print share to list the jobs of >+ * >+ * @param fn Callback function the receives printjob info >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EINVAL fname was NULL or smbc_init not called >+ * - EACCES ??? >+ */ >+int smbc_list_print_jobs(const char *purl, smbc_list_print_job_fn fn); >+ >+/**@ingroup print >+ * Delete a print job >+ * >+ * @param purl Url of the print share >+ * >+ * @param id The id of the job to delete >+ * >+ * @return 0 on success, < 0 on error with errno set: >+ * - EINVAL fname was NULL or smbc_init not called >+ * >+ * @todo what errno values are possible here? >+ */ >+int smbc_unlink_print_job(const char *purl, int id); >+ >+/**@ingroup callback >+ * Remove a server from the cached server list it's unused. >+ * >+ * @param context pointer to smb context >+ * >+ * @param srv pointer to server to remove >+ * >+ * @return On success, 0 is returned. 1 is returned if the server could not >+ * be removed. Also useable outside libsmbclient. >+ */ >+int smbc_remove_unused_server(SMBCCTX * context, SMBCSRV * srv); >+ >+#ifdef __cplusplus >+} >+#endif >+ >+/**@ingroup directory >+ * Convert strings of %xx to their single character equivalent. >+ * >+ * @param dest A pointer to a buffer in which the resulting decoded >+ * string should be placed. This may be a pointer to the >+ * same buffer as src_segment. >+ * >+ * @param src A pointer to the buffer containing the URL to be decoded. >+ * Any %xx sequences herein are converted to their single >+ * character equivalent. Each 'x' must be a valid hexadecimal >+ * digit, or that % sequence is left undecoded. >+ * >+ * @param max_dest_len >+ * The size of the buffer pointed to by dest_segment. >+ * >+ * @return The number of % sequences which could not be converted >+ * due to lack of two following hexadecimal digits. >+ */ >+#ifdef __cplusplus >+extern "C" { >+#endif >+int >+smbc_urldecode(char *dest, char * src, size_t max_dest_len); >+#ifdef __cplusplus >+} >+#endif >+ >+ >+/* >+ * Convert any characters not specifically allowed in a URL into their %xx >+ * equivalent. >+ * >+ * @param dest A pointer to a buffer in which the resulting encoded >+ * string should be placed. Unlike smbc_urldecode(), this >+ * must be a buffer unique from src. >+ * >+ * @param src A pointer to the buffer containing the string to be encoded. >+ * Any character not specifically allowed in a URL is converted >+ * into its hexadecimal value and encoded as %xx. >+ * >+ * @param max_dest_len >+ * The size of the buffer pointed to by dest_segment. >+ * >+ * @returns The remaining buffer length. >+ */ >+#ifdef __cplusplus >+extern "C" { >+#endif >+int >+smbc_urlencode(char * dest, char * src, int max_dest_len); >+#ifdef __cplusplus >+} >+#endif >+ >+ >+/**@ingroup directory >+ * Return the version of the linked Samba code, and thus the version of the >+ * libsmbclient code. >+ * >+ * @return The version string. >+ */ >+#ifdef __cplusplus >+extern "C" { >+#endif >+const char * >+smbc_version(void); >+#ifdef __cplusplus >+} >+#endif >+ >+ >+#endif /* SMBCLIENT_H_INCLUDED */ >Index: source/include/libsmbclient.h >=================================================================== >--- source/include/libsmbclient.h (révision 22956) >+++ source/include/libsmbclient.h (copie de travail) >@@ -1,2195 +0,0 @@ >-/*===================================================================== >- Unix SMB/Netbios implementation. >- SMB client library API definitions >- Copyright (C) Andrew Tridgell 1998 >- Copyright (C) Richard Sharpe 2000 >- Copyright (C) John Terpsra 2000 >- Copyright (C) Tom Jansen (Ninja ISD) 2002 >- Copyright (C) Derrell Lipman 2003 >- >- >- This program is free software; you can redistribute it and/or modify >- it under the terms of the GNU General Public License as published by >- the Free Software Foundation; either version 2 of the License, or >- (at your option) any later version. >- >- This program is distributed in the hope that it will be useful, >- but WITHOUT ANY WARRANTY; without even the implied warranty of >- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the >- GNU General Public License for more details. >- >- You should have received a copy of the GNU General Public License >- along with this program; if not, write to the Free Software >- Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. >- =====================================================================*/ >- >-#ifndef SMBCLIENT_H_INCLUDED >-#define SMBCLIENT_H_INCLUDED >- >-#ifdef __cplusplus >-extern "C" { >-#endif >- >-/*-------------------------------------------------------------------*/ >-/* The following are special comments to instruct DOXYGEN (automated >- * documentation tool: >-*/ >-/** \defgroup libsmbclient >-*/ >-/** \defgroup structure Data Structures Type and Constants >-* \ingroup libsmbclient >-* Data structures, types, and constants >-*/ >-/** \defgroup callback Callback function types >-* \ingroup libsmbclient >-* Callback functions >-*/ >-/** \defgroup file File Functions >-* \ingroup libsmbclient >-* Functions used to access individual file contents >-*/ >-/** \defgroup directory Directory Functions >-* \ingroup libsmbclient >-* Functions used to access directory entries >-*/ >-/** \defgroup attribute Attributes Functions >-* \ingroup libsmbclient >-* Functions used to view or change file and directory attributes >-*/ >-/** \defgroup print Print Functions >-* \ingroup libsmbclient >-* Functions used to access printing functionality >-*/ >-/** \defgroup misc Miscellaneous Functions >-* \ingroup libsmbclient >-* Functions that don't fit in to other categories >-*/ >-/*-------------------------------------------------------------------*/ >- >-/* Make sure we have the following includes for now ... */ >-#include <sys/types.h> >-#include <sys/stat.h> >-#include <fcntl.h> >-#include <utime.h> >- >-#define SMBC_BASE_FD 10000 /* smallest file descriptor returned */ >- >-#define SMBC_WORKGROUP 1 >-#define SMBC_SERVER 2 >-#define SMBC_FILE_SHARE 3 >-#define SMBC_PRINTER_SHARE 4 >-#define SMBC_COMMS_SHARE 5 >-#define SMBC_IPC_SHARE 6 >-#define SMBC_DIR 7 >-#define SMBC_FILE 8 >-#define SMBC_LINK 9 >- >-/**@ingroup structure >- * Structure that represents a directory entry. >- * >- */ >-struct smbc_dirent >-{ >- /** Type of entity. >- SMBC_WORKGROUP=1, >- SMBC_SERVER=2, >- SMBC_FILE_SHARE=3, >- SMBC_PRINTER_SHARE=4, >- SMBC_COMMS_SHARE=5, >- SMBC_IPC_SHARE=6, >- SMBC_DIR=7, >- SMBC_FILE=8, >- SMBC_LINK=9,*/ >- unsigned int smbc_type; >- >- /** Length of this smbc_dirent in bytes >- */ >- unsigned int dirlen; >- /** The length of the comment string in bytes (does not include >- * null terminator) >- */ >- unsigned int commentlen; >- /** Points to the null terminated comment string >- */ >- char *comment; >- /** The length of the name string in bytes (does not include >- * null terminator) >- */ >- unsigned int namelen; >- /** Points to the null terminated name string >- */ >- char name[1]; >-}; >- >-/* >- * Flags for smbc_setxattr() >- * Specify a bitwise OR of these, or 0 to add or replace as necessary >- */ >-#define SMBC_XATTR_FLAG_CREATE 0x1 /* fail if attr already exists */ >-#define SMBC_XATTR_FLAG_REPLACE 0x2 /* fail if attr does not exist */ >- >- >-/* >- * Mappings of the DOS mode bits, as returned by smbc_getxattr() when the >- * attribute name "system.dos_attr.mode" (or "system.dos_attr.*" or >- * "system.*") is specified. >- */ >-#define SMBC_DOS_MODE_READONLY 0x01 >-#define SMBC_DOS_MODE_HIDDEN 0x02 >-#define SMBC_DOS_MODE_SYSTEM 0x04 >-#define SMBC_DOS_MODE_VOLUME_ID 0x08 >-#define SMBC_DOS_MODE_DIRECTORY 0x10 >-#define SMBC_DOS_MODE_ARCHIVE 0x20 >- >-/* >- * Valid values for the option "open_share_mode", when calling >- * smbc_option_set() >- */ >-typedef enum smbc_share_mode >-{ >- SMBC_SHAREMODE_DENY_DOS = 0, >- SMBC_SHAREMODE_DENY_ALL = 1, >- SMBC_SHAREMODE_DENY_WRITE = 2, >- SMBC_SHAREMODE_DENY_READ = 3, >- SMBC_SHAREMODE_DENY_NONE = 4, >- SMBC_SHAREMODE_DENY_FCB = 7 >-} smbc_share_mode; >- >- >-#ifndef ENOATTR >-# define ENOATTR ENOENT /* No such attribute */ >-#endif >- >- >- >- >-/**@ingroup structure >- * Structure that represents a print job. >- * >- */ >-#ifndef _CLIENT_H >-struct print_job_info >-{ >- /** numeric ID of the print job >- */ >- unsigned short id; >- >- /** represents print job priority (lower numbers mean higher priority) >- */ >- unsigned short priority; >- >- /** Size of the print job >- */ >- size_t size; >- >- /** Name of the user that owns the print job >- */ >- char user[128]; >- >- /** Name of the print job. This will have no name if an anonymous print >- * file was opened. Ie smb://server/printer >- */ >- char name[128]; >- >- /** Time the print job was spooled >- */ >- time_t t; >-}; >-#endif /* _CLIENT_H */ >- >- >-/**@ingroup structure >- * Server handle >- */ >-typedef struct _SMBCSRV SMBCSRV; >- >-/**@ingroup structure >- * File or directory handle >- */ >-typedef struct _SMBCFILE SMBCFILE; >- >-/**@ingroup structure >- * File or directory handle >- */ >-typedef struct _SMBCCTX SMBCCTX; >- >- >- >- >- >-/**@ingroup callback >- * Authentication callback function type (traditional method) >- * >- * Type for the the authentication function called by the library to >- * obtain authentication credentals >- * >- * @param srv Server being authenticated to >- * >- * @param shr Share being authenticated to >- * >- * @param wg Pointer to buffer containing a "hint" for the >- * workgroup to be authenticated. Should be filled in >- * with the correct workgroup if the hint is wrong. >- * >- * @param wglen The size of the workgroup buffer in bytes >- * >- * @param un Pointer to buffer containing a "hint" for the >- * user name to be use for authentication. Should be >- * filled in with the correct workgroup if the hint is >- * wrong. >- * >- * @param unlen The size of the username buffer in bytes >- * >- * @param pw Pointer to buffer containing to which password >- * copied >- * >- * @param pwlen The size of the password buffer in bytes >- * >- */ >-typedef void (*smbc_get_auth_data_fn)(const char *srv, >- const char *shr, >- char *wg, int wglen, >- char *un, int unlen, >- char *pw, int pwlen); >-/**@ingroup callback >- * Authentication callback function type (method that includes context) >- * >- * Type for the the authentication function called by the library to >- * obtain authentication credentals >- * >- * @param c Pointer to the smb context >- * >- * @param srv Server being authenticated to >- * >- * @param shr Share being authenticated to >- * >- * @param wg Pointer to buffer containing a "hint" for the >- * workgroup to be authenticated. Should be filled in >- * with the correct workgroup if the hint is wrong. >- * >- * @param wglen The size of the workgroup buffer in bytes >- * >- * @param un Pointer to buffer containing a "hint" for the >- * user name to be use for authentication. Should be >- * filled in with the correct workgroup if the hint is >- * wrong. >- * >- * @param unlen The size of the username buffer in bytes >- * >- * @param pw Pointer to buffer containing to which password >- * copied >- * >- * @param pwlen The size of the password buffer in bytes >- * >- */ >-typedef void (*smbc_get_auth_data_with_context_fn)(SMBCCTX *c, >- const char *srv, >- const char *shr, >- char *wg, int wglen, >- char *un, int unlen, >- char *pw, int pwlen); >- >- >-/**@ingroup callback >- * Print job info callback function type. >- * >- * @param i pointer to print job information structure >- * >- */ >-typedef void (*smbc_list_print_job_fn)(struct print_job_info *i); >- >- >-/**@ingroup callback >- * Check if a server is still good >- * >- * @param c pointer to smb context >- * >- * @param srv pointer to server to check >- * >- * @return 0 when connection is good. 1 on error. >- * >- */ >-typedef int (*smbc_check_server_fn)(SMBCCTX * c, SMBCSRV *srv); >- >-/**@ingroup callback >- * Remove a server if unused >- * >- * @param c pointer to smb context >- * >- * @param srv pointer to server to remove >- * >- * @return 0 on success. 1 on failure. >- * >- */ >-typedef int (*smbc_remove_unused_server_fn)(SMBCCTX * c, SMBCSRV *srv); >- >- >-/**@ingroup callback >- * Add a server to the cache system >- * >- * @param c pointer to smb context >- * >- * @param srv pointer to server to add >- * >- * @param server server name >- * >- * @param share share name >- * >- * @param workgroup workgroup used to connect >- * >- * @param username username used to connect >- * >- * @return 0 on success. 1 on failure. >- * >- */ >-typedef int (*smbc_add_cached_srv_fn) (SMBCCTX * c, SMBCSRV *srv, >- const char * server, const char * share, >- const char * workgroup, const char * username); >- >-/**@ingroup callback >- * Look up a server in the cache system >- * >- * @param c pointer to smb context >- * >- * @param server server name to match >- * >- * @param share share name to match >- * >- * @param workgroup workgroup to match >- * >- * @param username username to match >- * >- * @return pointer to SMBCSRV on success. NULL on failure. >- * >- */ >-typedef SMBCSRV * (*smbc_get_cached_srv_fn) (SMBCCTX * c, const char * server, >- const char * share, const char * workgroup, >- const char * username); >- >-/**@ingroup callback >- * Check if a server is still good >- * >- * @param c pointer to smb context >- * >- * @param srv pointer to server to remove >- * >- * @return 0 when found and removed. 1 on failure. >- * >- */ >-typedef int (*smbc_remove_cached_srv_fn)(SMBCCTX * c, SMBCSRV *srv); >- >- >-/**@ingroup callback >- * Try to remove all servers from the cache system and disconnect >- * >- * @param c pointer to smb context >- * >- * @return 0 when found and removed. 1 on failure. >- * >- */ >-typedef int (*smbc_purge_cached_fn) (SMBCCTX * c); >- >- >-/**@ingroup structure >- * Structure that contains a client context information >- * This structure is know as SMBCCTX >- */ >-struct _SMBCCTX { >- /** debug level >- */ >- int debug; >- >- /** netbios name used for making connections >- */ >- char * netbios_name; >- >- /** workgroup name used for making connections >- */ >- char * workgroup; >- >- /** username used for making connections >- */ >- char * user; >- >- /** timeout used for waiting on connections / response data (in milliseconds) >- */ >- int timeout; >- >- /** callable functions for files: >- * For usage and return values see the smbc_* functions >- */ >- SMBCFILE * (*open) (SMBCCTX *c, const char *fname, int flags, mode_t mode); >- SMBCFILE * (*creat) (SMBCCTX *c, const char *path, mode_t mode); >- ssize_t (*read) (SMBCCTX *c, SMBCFILE *file, void *buf, size_t count); >- ssize_t (*write) (SMBCCTX *c, SMBCFILE *file, void *buf, size_t count); >- int (*unlink) (SMBCCTX *c, const char *fname); >- int (*rename) (SMBCCTX *ocontext, const char *oname, >- SMBCCTX *ncontext, const char *nname); >- off_t (*lseek) (SMBCCTX *c, SMBCFILE * file, off_t offset, int whence); >- int (*stat) (SMBCCTX *c, const char *fname, struct stat *st); >- int (*fstat) (SMBCCTX *c, SMBCFILE *file, struct stat *st); >- int (*close_fn) (SMBCCTX *c, SMBCFILE *file); >- >- /** callable functions for dirs >- */ >- SMBCFILE * (*opendir) (SMBCCTX *c, const char *fname); >- int (*closedir)(SMBCCTX *c, SMBCFILE *dir); >- struct smbc_dirent * (*readdir)(SMBCCTX *c, SMBCFILE *dir); >- int (*getdents)(SMBCCTX *c, SMBCFILE *dir, >- struct smbc_dirent *dirp, int count); >- int (*mkdir) (SMBCCTX *c, const char *fname, mode_t mode); >- int (*rmdir) (SMBCCTX *c, const char *fname); >- off_t (*telldir) (SMBCCTX *c, SMBCFILE *dir); >- int (*lseekdir)(SMBCCTX *c, SMBCFILE *dir, off_t offset); >- int (*fstatdir)(SMBCCTX *c, SMBCFILE *dir, struct stat *st); >- int (*chmod)(SMBCCTX *c, const char *fname, mode_t mode); >- int (*utimes)(SMBCCTX *c, >- const char *fname, struct timeval *tbuf); >- int (*setxattr)(SMBCCTX *context, >- const char *fname, >- const char *name, >- const void *value, >- size_t size, >- int flags); >- int (*getxattr)(SMBCCTX *context, >- const char *fname, >- const char *name, >- const void *value, >- size_t size); >- int (*removexattr)(SMBCCTX *context, >- const char *fname, >- const char *name); >- int (*listxattr)(SMBCCTX *context, >- const char *fname, >- char *list, >- size_t size); >- >- /** callable functions for printing >- */ >- int (*print_file)(SMBCCTX *c_file, const char *fname, >- SMBCCTX *c_print, const char *printq); >- SMBCFILE * (*open_print_job)(SMBCCTX *c, const char *fname); >- int (*list_print_jobs)(SMBCCTX *c, const char *fname, smbc_list_print_job_fn fn); >- int (*unlink_print_job)(SMBCCTX *c, const char *fname, int id); >- >- >- /* >- ** Callbacks >- * These callbacks _always_ have to be initialized because they will >- * not be checked at dereference for increased speed. >- */ >- struct _smbc_callbacks { >- /** authentication function callback: called upon auth requests >- */ >- smbc_get_auth_data_fn auth_fn; >- >- /** check if a server is still good >- */ >- smbc_check_server_fn check_server_fn; >- >- /** remove a server if unused >- */ >- smbc_remove_unused_server_fn remove_unused_server_fn; >- >- /** Cache subsystem >- * For an example cache system see samba/source/libsmb/libsmb_cache.c >- * Cache subsystem functions follow. >- */ >- >- /** server cache addition >- */ >- smbc_add_cached_srv_fn add_cached_srv_fn; >- >- /** server cache lookup >- */ >- smbc_get_cached_srv_fn get_cached_srv_fn; >- >- /** server cache removal >- */ >- smbc_remove_cached_srv_fn remove_cached_srv_fn; >- >- /** server cache purging, try to remove all cached servers (disconnect) >- */ >- smbc_purge_cached_fn purge_cached_fn; >- } callbacks; >- >- >- /** Space to store private data of the server cache. >- */ >- struct smbc_server_cache * server_cache; >- >- int flags; >- >- /** user options selections that apply to this session >- */ >- struct _smbc_options { >- >- /* >- * From how many local master browsers should the list of >- * workgroups be retrieved? It can take up to 12 minutes or >- * longer after a server becomes a local master browser, for >- * it to have the entire browse list (the list of >- * workgroups/domains) from an entire network. Since a client >- * never knows which local master browser will be found first, >- * the one which is found first and used to retrieve a browse >- * list may have an incomplete or empty browse list. By >- * requesting the browse list from multiple local master >- * browsers, a more complete list can be generated. For small >- * networks (few workgroups), it is recommended that this >- * value be set to 0, causing the browse lists from all found >- * local master browsers to be retrieved and merged. For >- * networks with many workgroups, a suitable value for this >- * variable is probably somewhere around 3. (Default: 3). >- */ >- int browse_max_lmb_count; >- >- /* >- * There is a difference in the desired return strings from >- * smbc_readdir() depending upon whether the filenames are to >- * be displayed to the user, or whether they are to be >- * appended to the path name passed to smbc_opendir() to call >- * a further smbc_ function (e.g. open the file with >- * smbc_open()). In the former case, the filename should be >- * in "human readable" form. In the latter case, the smbc_ >- * functions expect a URL which must be url-encoded. Those >- * functions decode the URL. If, for example, smbc_readdir() >- * returned a file name of "abc%20def.txt", passing a path >- * with this file name attached to smbc_open() would cause >- * smbc_open to attempt to open the file "abc def.txt" since >- * the %20 is decoded into a space. >- * >- * Set this option to True if the names returned by >- * smbc_readdir() should be url-encoded such that they can be >- * passed back to another smbc_ call. Set it to False if the >- * names returned by smbc_readdir() are to be presented to the >- * user. >- * >- * For backwards compatibility, this option defaults to False. >- */ >- int urlencode_readdir_entries; >- >- /* >- * Some Windows versions appear to have a limit to the number >- * of concurrent SESSIONs and/or TREE CONNECTions. In >- * one-shot programs (i.e. the program runs and then quickly >- * ends, thereby shutting down all connections), it is >- * probably reasonable to establish a new connection for each >- * share. In long-running applications, the limitation can be >- * avoided by using only a single connection to each server, >- * and issuing a new TREE CONNECT when the share is accessed. >- */ >- int one_share_per_server; >- } options; >- >- /** INTERNAL DATA >- * do _NOT_ touch this from your program ! >- */ >- struct smbc_internal_data * internal; >-}; >- >-/* Flags for SMBCCTX->flags */ >-#define SMB_CTX_FLAG_USE_KERBEROS (1 << 0) >-#define SMB_CTX_FLAG_FALLBACK_AFTER_KERBEROS (1 << 1) >-#define SMBCCTX_FLAG_NO_AUTO_ANONYMOUS_LOGON (1 << 2) /* don't try to do automatic anon login */ >- >-/**@ingroup misc >- * Create a new SBMCCTX (a context). >- * >- * Must be called before the context is passed to smbc_context_init() >- * >- * @return The given SMBCCTX pointer on success, NULL on error with errno set: >- * - ENOMEM Out of memory >- * >- * @see smbc_free_context(), smbc_init_context() >- * >- * @note Do not forget to smbc_init_context() the returned SMBCCTX pointer ! >- */ >-SMBCCTX * smbc_new_context(void); >- >-/**@ingroup misc >- * Delete a SBMCCTX (a context) acquired from smbc_new_context(). >- * >- * The context will be deleted if possible. >- * >- * @param context A pointer to a SMBCCTX obtained from smbc_new_context() >- * >- * @param shutdown_ctx If 1, all connections and files will be closed even if they are busy. >- * >- * >- * @return Returns 0 on succes. Returns 1 on failure with errno set: >- * - EBUSY Server connections are still used, Files are open or cache >- * could not be purged >- * - EBADF context == NULL >- * >- * @see smbc_new_context() >- * >- * @note It is advised to clean up all the contexts with shutdown_ctx set to 1 >- * just before exit()'ing. When shutdown_ctx is 0, this function can be >- * use in periodical cleanup functions for example. >- */ >-int smbc_free_context(SMBCCTX * context, int shutdown_ctx); >- >- >-/**@ingroup misc >- * Each time the context structure is changed, we have binary backward >- * compatibility issues. Instead of modifying the public portions of the >- * context structure to add new options, instead, we put them in the internal >- * portion of the context structure and provide a set function for these new >- * options. >- * >- * @param context A pointer to a SMBCCTX obtained from smbc_new_context() >- * >- * @param option_name >- * The name of the option for which the value is to be set >- * >- * @param option_value >- * The new value of the option being set >- * >- */ >-void >-smbc_option_set(SMBCCTX *context, >- char *option_name, >- ... /* option_value */); >-/* >- * Retrieve the current value of an option >- * >- * @param context A pointer to a SMBCCTX obtained from smbc_new_context() >- * >- * @param option_name >- * The name of the option for which the value is to be >- * retrieved >- * >- * @return The value of the specified option. >- */ >-void * >-smbc_option_get(SMBCCTX *context, >- char *option_name); >- >-/**@ingroup misc >- * Initialize a SBMCCTX (a context). >- * >- * Must be called before using any SMBCCTX API function >- * >- * @param context A pointer to a SMBCCTX obtained from smbc_new_context() >- * >- * @return A pointer to the given SMBCCTX on success, >- * NULL on error with errno set: >- * - EBADF NULL context given >- * - ENOMEM Out of memory >- * - ENOENT The smb.conf file would not load >- * >- * @see smbc_new_context() >- * >- * @note my_context = smbc_init_context(smbc_new_context()) >- * is perfectly safe, but it might leak memory on >- * smbc_context_init() failure. Avoid this. >- * You'll have to call smbc_free_context() yourself >- * on failure. >- */ >- >-SMBCCTX * smbc_init_context(SMBCCTX * context); >- >-/**@ingroup misc >- * Initialize the samba client library. >- * >- * Must be called before using any of the smbclient API function >- * >- * @param fn The function that will be called to obtaion >- * authentication credentials. >- * >- * @param debug Allows caller to set the debug level. Can be >- * changed in smb.conf file. Allows caller to set >- * debugging if no smb.conf. >- * >- * @return 0 on success, < 0 on error with errno set: >- * - ENOMEM Out of memory >- * - ENOENT The smb.conf file would not load >- * >- */ >- >-int smbc_init(smbc_get_auth_data_fn fn, int debug); >- >-/**@ingroup misc >- * Set or retrieve the compatibility library's context pointer >- * >- * @param context New context to use, or NULL. If a new context is provided, >- * it must have allocated with smbc_new_context() and >- * initialized with smbc_init_context(), followed, optionally, >- * by some manual changes to some of the non-internal fields. >- * >- * @return The old context. >- * >- * @see smbc_new_context(), smbc_init_context(), smbc_init() >- * >- * @note This function may be called prior to smbc_init() to force >- * use of the next context without any internal calls to >- * smbc_new_context() or smbc_init_context(). It may also >- * be called after smbc_init() has already called those two >- * functions, to replace the existing context with a new one. >- * Care should be taken, in this latter case, to ensure that >- * the server cache and any data allocated by the >- * authentication functions have been freed, if necessary. >- */ >- >-SMBCCTX * smbc_set_context(SMBCCTX * new_context); >- >-/**@ingroup file >- * Open a file on an SMB server. >- * >- * @param furl The smb url of the file to be opened. >- * >- * @param flags Is one of O_RDONLY, O_WRONLY or O_RDWR which >- * request opening the file read-only,write-only >- * or read/write. flags may also be bitwise-or'd with >- * one or more of the following: >- * O_CREAT - If the file does not exist it will be >- * created. >- * O_EXCL - When used with O_CREAT, if the file >- * already exists it is an error and the open will >- * fail. >- * O_TRUNC - If the file already exists it will be >- * truncated. >- * O_APPEND The file is opened in append mode >- * >- * @param mode mode specifies the permissions to use if a new >- * file is created. It is modified by the >- * process's umask in the usual way: the permissions >- * of the created file are (mode & ~umask) >- * >- * Not currently use, but there for future use. >- * We will map this to SYSTEM, HIDDEN, etc bits >- * that reverses the mapping that smbc_fstat does. >- * >- * @return Valid file handle, < 0 on error with errno set: >- * - ENOMEM Out of memory >- * - EINVAL if an invalid parameter passed, like no >- * file, or smbc_init not called. >- * - EEXIST pathname already exists and O_CREAT and >- * O_EXCL were used. >- * - EISDIR pathname refers to a directory and >- * the access requested involved writing. >- * - EACCES The requested access to the file is not >- * allowed >- * - ENODEV The requested share does not exist >- * - ENOTDIR A file on the path is not a directory >- * - ENOENT A directory component in pathname does >- * not exist. >- * >- * @see smbc_creat() >- * >- * @note This call uses an underlying routine that may create >- * a new connection to the server specified in the URL. >- * If the credentials supplied in the URL, or via the >- * auth_fn in the smbc_init call, fail, this call will >- * try again with an empty username and password. This >- * often gets mapped to the guest account on some machines. >- */ >- >-int smbc_open(const char *furl, int flags, mode_t mode); >- >-/**@ingroup file >- * Create a file on an SMB server. >- * >- * Same as calling smbc_open() with flags = O_CREAT|O_WRONLY|O_TRUNC >- * >- * @param furl The smb url of the file to be created >- * >- * @param mode mode specifies the permissions to use if a new >- * file is created. It is modified by the >- * process's umask in the usual way: the permissions >- * of the created file are (mode & ~umask) >- * >- * NOTE, the above is not true. We are dealing with >- * an SMB server, which has no concept of a umask! >- * >- * @return Valid file handle, < 0 on error with errno set: >- * - ENOMEM Out of memory >- * - EINVAL if an invalid parameter passed, like no >- * file, or smbc_init not called. >- * - EEXIST pathname already exists and O_CREAT and >- * O_EXCL were used. >- * - EISDIR pathname refers to a directory and >- * the access requested involved writing. >- * - EACCES The requested access to the file is not >- * allowed >- * - ENOENT A directory component in pathname does >- * not exist. >- * - ENODEV The requested share does not exist. >- * @see smbc_open() >- * >- */ >- >-int smbc_creat(const char *furl, mode_t mode); >- >-/**@ingroup file >- * Read from a file using an opened file handle. >- * >- * @param fd Open file handle from smbc_open() or smbc_creat() >- * >- * @param buf Pointer to buffer to recieve read data >- * >- * @param bufsize Size of buf in bytes >- * >- * @return Number of bytes read, < 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. >- * - EINVAL fd is attached to an object which is >- * unsuitable for reading, or no buffer passed or >- * smbc_init not called. >- * >- * @see smbc_open(), smbc_write() >- * >- */ >-ssize_t smbc_read(int fd, void *buf, size_t bufsize); >- >- >-/**@ingroup file >- * Write to a file using an opened file handle. >- * >- * @param fd Open file handle from smbc_open() or smbc_creat() >- * >- * @param buf Pointer to buffer to recieve read data >- * >- * @param bufsize Size of buf in bytes >- * >- * @return Number of bytes written, < 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. >- * - EINVAL fd is attached to an object which is >- * unsuitable for reading, or no buffer passed or >- * smbc_init not called. >- * >- * @see smbc_open(), smbc_read() >- * >- */ >-ssize_t smbc_write(int fd, void *buf, size_t bufsize); >- >- >-/**@ingroup file >- * Seek to a specific location in a file. >- * >- * @param fd Open file handle from smbc_open() or smbc_creat() >- * >- * @param offset Offset in bytes from whence >- * >- * @param whence A location in the file: >- * - SEEK_SET The offset is set to offset bytes from >- * the beginning of the file >- * - SEEK_CUR The offset is set to current location >- * plus offset bytes. >- * - SEEK_END The offset is set to the size of the >- * file plus offset bytes. >- * >- * @return Upon successful completion, lseek returns the >- * resulting offset location as measured in bytes >- * from the beginning of the file. Otherwise, a value >- * of (off_t)-1 is returned and errno is set to >- * indicate the error: >- * - EBADF Fildes is not an open file descriptor. >- * - EINVAL Whence is not a proper value or smbc_init >- * not called. >- * >- * @todo Are all the whence values really supported? >- * >- * @todo Are errno values complete and correct? >- */ >-off_t smbc_lseek(int fd, off_t offset, int whence); >- >- >-/**@ingroup file >- * Close an open file handle. >- * >- * @param fd The file handle to close >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EBADF fd isn't a valid open file descriptor >- * - EINVAL smbc_init() failed or has not been called >- * >- * @see smbc_open(), smbc_creat() >- */ >-int smbc_close(int fd); >- >- >-/**@ingroup directory >- * Unlink (delete) a file or directory. >- * >- * @param furl The smb url of the file to delete >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EACCES or EPERM Write access to the directory >- * containing pathname is not allowed or one >- * of the directories in pathname did not allow >- * search (execute) permission >- * - ENOENT A directory component in pathname does >- * not exist >- * - EINVAL NULL was passed in the file param or >- * smbc_init not called. >- * - EACCES You do not have access to the file >- * - ENOMEM Insufficient kernel memory was available >- * >- * @see smbc_rmdir()s >- * >- * @todo Are errno values complete and correct? >- */ >-int smbc_unlink(const char *furl); >- >- >-/**@ingroup directory >- * Rename or move a file or directory. >- * >- * @param ourl The original smb url (source url) of file or >- * directory to be moved >- * >- * @param nurl The new smb url (destination url) of the file >- * or directory after the move. Currently nurl must >- * be on the same share as ourl. >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EISDIR nurl is an existing directory, but ourl is >- * not a directory. >- * - EEXIST nurl is a non-empty directory, >- * i.e., contains entries other than "." and ".." >- * - EINVAL The new url contained a path prefix >- * of the old, or, more generally, an attempt was >- * made to make a directory a subdirectory of itself >- * or smbc_init not called. >- * - ENOTDIR A component used as a directory in ourl >- * or nurl path is not, in fact, a directory. Or, >- * ourl is a directory, and newpath exists but is not >- * a directory. >- * - EACCES or EPERM Write access to the directory >- * containing ourl or nurl is not allowed for the >- * process's effective uid, or one of the >- * directories in ourl or nurl did not allow search >- * (execute) permission, or ourl was a directory >- * and did not allow write permission. >- * - ENOENT A directory component in ourl or nurl >- * does not exist. >- * - EXDEV Rename across shares not supported. >- * - ENOMEM Insufficient kernel memory was available. >- * - EEXIST The target file, nurl, already exists. >- * >- * >- * @todo Are we going to support copying when urls are not on the same >- * share? I say no... NOTE. I agree for the moment. >- * >- */ >-int smbc_rename(const char *ourl, const char *nurl); >- >- >-/**@ingroup directory >- * Open a directory used to obtain directory entries. >- * >- * @param durl The smb url of the directory to open >- * >- * @return Valid directory handle. < 0 on error with errno set: >- * - EACCES Permission denied. >- * - EINVAL A NULL file/URL was passed, or the URL would >- * not parse, or was of incorrect form or smbc_init not >- * called. >- * - ENOENT durl does not exist, or name is an >- * - ENOMEM Insufficient memory to complete the >- * operation. >- * - ENOTDIR name is not a directory. >- * - EPERM the workgroup could not be found. >- * - ENODEV the workgroup or server could not be found. >- * >- * @see smbc_getdents(), smbc_readdir(), smbc_closedir() >- * >- */ >-int smbc_opendir(const char *durl); >- >- >-/**@ingroup directory >- * Close a directory handle opened by smbc_opendir(). >- * >- * @param dh Directory handle to close >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EBADF dh is an invalid directory handle >- * >- * @see smbc_opendir() >- */ >-int smbc_closedir(int dh); >- >- >-/**@ingroup directory >- * Get multiple directory entries. >- * >- * smbc_getdents() reads as many dirent structures from the an open >- * directory handle into a specified memory area as will fit. >- * >- * @param dh Valid directory as returned by smbc_opendir() >- * >- * @param dirp pointer to buffer that will receive the directory >- * entries. >- * >- * @param count The size of the dirp buffer in bytes >- * >- * @returns If any dirents returned, return will indicate the >- * total size. If there were no more dirents available, >- * 0 is returned. < 0 indicates an error. >- * - EBADF Invalid directory handle >- * - EINVAL Result buffer is too small or smbc_init >- * not called. >- * - ENOENT No such directory. >- * @see , smbc_dirent, smbc_readdir(), smbc_open() >- * >- * @todo Are errno values complete and correct? >- * >- * @todo Add example code so people know how to parse buffers. >- */ >-int smbc_getdents(unsigned int dh, struct smbc_dirent *dirp, int count); >- >- >-/**@ingroup directory >- * Get a single directory entry. >- * >- * @param dh Valid directory as returned by smbc_opendir() >- * >- * @return A pointer to a smbc_dirent structure, or NULL if an >- * error occurs or end-of-directory is reached: >- * - EBADF Invalid directory handle >- * - EINVAL smbc_init() failed or has not been called >- * >- * @see smbc_dirent, smbc_getdents(), smbc_open() >- */ >-struct smbc_dirent* smbc_readdir(unsigned int dh); >- >- >-/**@ingroup directory >- * Get the current directory offset. >- * >- * smbc_telldir() may be used in conjunction with smbc_readdir() and >- * smbc_lseekdir(). >- * >- * @param dh Valid directory as returned by smbc_opendir() >- * >- * @return The current location in the directory stream or -1 >- * if an error occur. The current location is not >- * an offset. Becuase of the implementation, it is a >- * handle that allows the library to find the entry >- * later. >- * - EBADF dh is not a valid directory handle >- * - EINVAL smbc_init() failed or has not been called >- * - ENOTDIR if dh is not a directory >- * >- * @see smbc_readdir() >- * >- */ >-off_t smbc_telldir(int dh); >- >- >-/**@ingroup directory >- * lseek on directories. >- * >- * smbc_lseekdir() may be used in conjunction with smbc_readdir() and >- * smbc_telldir(). (rewind by smbc_lseekdir(fd, NULL)) >- * >- * @param fd Valid directory as returned by smbc_opendir() >- * >- * @param offset The offset (as returned by smbc_telldir). Can be >- * NULL, in which case we will rewind >- * >- * @return 0 on success, -1 on failure >- * - EBADF dh is not a valid directory handle >- * - ENOTDIR if dh is not a directory >- * - EINVAL offset did not refer to a valid dirent or >- * smbc_init not called. >- * >- * @see smbc_telldir() >- * >- * >- * @todo In what does the reture and errno values mean? >- */ >-int smbc_lseekdir(int fd, off_t offset); >- >-/**@ingroup directory >- * Create a directory. >- * >- * @param durl The url of the directory to create >- * >- * @param mode Specifies the permissions to use. It is modified >- * by the process's umask in the usual way: the >- * permissions of the created file are (mode & ~umask). >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EEXIST directory url already exists >- * - EACCES The parent directory does not allow write >- * permission to the process, or one of the directories >- * - ENOENT A directory component in pathname does not >- * exist. >- * - EINVAL NULL durl passed or smbc_init not called. >- * - ENOMEM Insufficient memory was available. >- * >- * @see smbc_rmdir() >- * >- */ >-int smbc_mkdir(const char *durl, mode_t mode); >- >- >-/**@ingroup directory >- * Remove a directory. >- * >- * @param durl The smb url of the directory to remove >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EACCES or EPERM Write access to the directory >- * containing pathname was not allowed. >- * - EINVAL durl is NULL or smbc_init not called. >- * - ENOENT A directory component in pathname does not >- * exist. >- * - ENOTEMPTY directory contains entries. >- * - ENOMEM Insufficient kernel memory was available. >- * >- * @see smbc_mkdir(), smbc_unlink() >- * >- * @todo Are errno values complete and correct? >- */ >-int smbc_rmdir(const char *durl); >- >- >-/**@ingroup attribute >- * Get information about a file or directory. >- * >- * @param url The smb url to get information for >- * >- * @param st pointer to a buffer that will be filled with >- * standard Unix struct stat information. >- * >- * @return 0 on success, < 0 on error with errno set: >- * - ENOENT A component of the path file_name does not >- * exist. >- * - EINVAL a NULL url was passed or smbc_init not called. >- * - EACCES Permission denied. >- * - ENOMEM Out of memory >- * - ENOTDIR The target dir, url, is not a directory. >- * >- * @see Unix stat() >- * >- */ >-int smbc_stat(const char *url, struct stat *st); >- >- >-/**@ingroup attribute >- * Get file information via an file descriptor. >- * >- * @param fd Open file handle from smbc_open() or smbc_creat() >- * >- * @param st pointer to a buffer that will be filled with >- * standard Unix struct stat information. >- * >- * @return EBADF filedes is bad. >- * - EACCES Permission denied. >- * - EBADF fd is not a valid file descriptor >- * - EINVAL Problems occurred in the underlying routines >- * or smbc_init not called. >- * - ENOMEM Out of memory >- * >- * @see smbc_stat(), Unix stat() >- * >- */ >-int smbc_fstat(int fd, struct stat *st); >- >- >-/**@ingroup attribue >- * Change the ownership of a file or directory. >- * >- * @param url The smb url of the file or directory to change >- * ownership of. >- * >- * @param owner I have no idea? >- * >- * @param group I have not idea? >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EPERM The effective UID does not match the owner >- * of the file, and is not zero; or the owner or group >- * were specified incorrectly. >- * - ENOENT The file does not exist. >- * - ENOMEM Insufficient was available. >- * - ENOENT file or directory does not exist >- * >- * @todo Are we actually going to be able to implement this function >- * >- * @todo How do we abstract owner and group uid and gid? >- * >- */ >-int smbc_chown(const char *url, uid_t owner, gid_t group); >- >- >-/**@ingroup attribute >- * Change the permissions of a file. >- * >- * @param url The smb url of the file or directory to change >- * permissions of >- * >- * @param mode The permissions to set: >- * - Put good explaination of permissions here! >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EPERM The effective UID does not match the owner >- * of the file, and is not zero >- * - ENOENT The file does not exist. >- * - ENOMEM Insufficient was available. >- * - ENOENT file or directory does not exist >- * >- * @todo Actually implement this fuction? >- * >- * @todo Are errno values complete and correct? >- */ >-int smbc_chmod(const char *url, mode_t mode); >- >-/** >- * @ingroup attribute >- * Change the last modification time on a file >- * >- * @param url The smb url of the file or directory to change >- * the modification time of >- * >- * @param tbuf An array of two timeval structures which contains, >- * respectively, the desired access and modification times. >- * NOTE: Only the tv_sec field off each timeval structure is >- * used. The tv_usec (microseconds) portion is ignored. >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EINVAL The client library is not properly initialized >- * - EPERM Permission was denied. >- * >- */ >-int smbc_utimes(const char *url, struct timeval *tbuf); >- >-#ifdef HAVE_UTIME_H >-/** >- * @ingroup attribute >- * Change the last modification time on a file >- * >- * @param url The smb url of the file or directory to change >- * the modification time of >- * >- * @param utbuf A pointer to a utimebuf structure which contains the >- * desired access and modification times. >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EINVAL The client library is not properly initialized >- * - ENOMEM No memory was available for internal needs >- * - EPERM Permission was denied. >- * >- */ >-int smbc_utime(const char *fname, struct utimbuf *utbuf); >-#endif >- >-/**@ingroup attribute >- * Set extended attributes for a file. This is used for modifying a file's >- * security descriptor (i.e. owner, group, and access control list) >- * >- * @param url The smb url of the file or directory to set extended >- * attributes for. >- * >- * @param name The name of an attribute to be changed. Names are of >- * one of the following forms: >- * >- * system.nt_sec_desc.<attribute name> >- * system.nt_sec_desc.* >- * system.nt_sec_desc.*+ >- * >- * where <attribute name> is one of: >- * >- * revision >- * owner >- * owner+ >- * group >- * group+ >- * acl:<name or sid> >- * acl+:<name or sid> >- * >- * In the forms "system.nt_sec_desc.*" and >- * "system.nt_sec_desc.*+", the asterisk and plus signs are >- * literal, i.e. the string is provided exactly as shown, and >- * the value parameter should contain a complete security >- * descriptor with name:value pairs separated by tabs, >- * commas, or newlines (not spaces!). >- * >- * The plus sign ('+') indicates that SIDs should be mapped >- * to names. Without the plus sign, SIDs are not mapped; >- * rather they are simply converted to a string format. >- * >- * @param value The value to be assigned to the specified attribute name. >- * This buffer should contain only the attribute value if the >- * name was of the "system.nt_sec_desc.<attribute_name>" >- * form. If the name was of the "system.nt_sec_desc.*" form >- * then a complete security descriptor, with name:value pairs >- * separated by tabs, commas, or newlines (not spaces!), >- * should be provided in this value buffer. A complete >- * security descriptor will contain one or more entries >- * selected from the following: >- * >- * REVISION:<revision number> >- * OWNER:<sid or name> >- * GROUP:<sid or name> >- * ACL:<sid or name>:<type>/<flags>/<mask> >- * >- * The revision of the ACL specifies the internal Windows NT >- * ACL revision for the security descriptor. If not specified >- * it defaults to 1. Using values other than 1 may cause >- * strange behaviour. >- * >- * The owner and group specify the owner and group sids for >- * the object. If the attribute name (either '*+' with a >- * complete security descriptor, or individual 'owner+' or >- * 'group+' attribute names) ended with a plus sign, the >- * specified name is resolved to a SID value, using the >- * server on which the file or directory resides. Otherwise, >- * the value should be provided in SID-printable format as >- * S-1-x-y-z, and is used directly. The <sid or name> >- * associated with the ACL: attribute should be provided >- * similarly. >- * >- * @param size The number of the bytes of data in the value buffer >- * >- * @param flags A bit-wise OR of zero or more of the following: >- * SMBC_XATTR_FLAG_CREATE - >- * fail if the named attribute already exists >- * SMBC_XATTR_FLAG_REPLACE - >- * fail if the attribute does not already exist >- * >- * If neither flag is specified, the specified attributes >- * will be added or replace existing attributes of the same >- * name, as necessary. >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EINVAL The client library is not properly initialized >- * or one of the parameters is not of a correct >- * form >- * - ENOMEM No memory was available for internal needs >- * - EEXIST If the attribute already exists and the flag >- * SMBC_XATTR_FLAG_CREAT was specified >- * - ENOATTR If the attribute does not exist and the flag >- * SMBC_XATTR_FLAG_REPLACE was specified >- * - EPERM Permission was denied. >- * - ENOTSUP The referenced file system does not support >- * extended attributes >- * >- * @note Attribute names are compared in a case-insensitive >- * fashion. All of the following are equivalent, although >- * the all-lower-case name is the preferred format: >- * system.nt_sec_desc.owner >- * SYSTEM.NT_SEC_DESC.OWNER >- * sYsTeM.nt_sEc_desc.owNER >- * >- */ >-int smbc_setxattr(const char *url, >- const char *name, >- const void *value, >- size_t size, >- int flags); >- >- >-/**@ingroup attribute >- * Set extended attributes for a file. This is used for modifying a file's >- * security descriptor (i.e. owner, group, and access control list). The >- * POSIX function which this maps to would act on a symbolic link rather than >- * acting on what the symbolic link points to, but with no symbolic links in >- * SMB file systems, this function is functionally identical to >- * smbc_setxattr(). >- * >- * @param url The smb url of the file or directory to set extended >- * attributes for. >- * >- * @param name The name of an attribute to be changed. Names are of >- * one of the following forms: >- * >- * system.nt_sec_desc.<attribute name> >- * system.nt_sec_desc.* >- * system.nt_sec_desc.*+ >- * >- * where <attribute name> is one of: >- * >- * revision >- * owner >- * owner+ >- * group >- * group+ >- * acl:<name or sid> >- * acl+:<name or sid> >- * >- * In the forms "system.nt_sec_desc.*" and >- * "system.nt_sec_desc.*+", the asterisk and plus signs are >- * literal, i.e. the string is provided exactly as shown, and >- * the value parameter should contain a complete security >- * descriptor with name:value pairs separated by tabs, >- * commas, or newlines (not spaces!). >- * >- * The plus sign ('+') indicates that SIDs should be mapped >- * to names. Without the plus sign, SIDs are not mapped; >- * rather they are simply converted to a string format. >- * >- * @param value The value to be assigned to the specified attribute name. >- * This buffer should contain only the attribute value if the >- * name was of the "system.nt_sec_desc.<attribute_name>" >- * form. If the name was of the "system.nt_sec_desc.*" form >- * then a complete security descriptor, with name:value pairs >- * separated by tabs, commas, or newlines (not spaces!), >- * should be provided in this value buffer. A complete >- * security descriptor will contain one or more entries >- * selected from the following: >- * >- * REVISION:<revision number> >- * OWNER:<sid or name> >- * GROUP:<sid or name> >- * ACL:<sid or name>:<type>/<flags>/<mask> >- * >- * The revision of the ACL specifies the internal Windows NT >- * ACL revision for the security descriptor. If not specified >- * it defaults to 1. Using values other than 1 may cause >- * strange behaviour. >- * >- * The owner and group specify the owner and group sids for >- * the object. If the attribute name (either '*+' with a >- * complete security descriptor, or individual 'owner+' or >- * 'group+' attribute names) ended with a plus sign, the >- * specified name is resolved to a SID value, using the >- * server on which the file or directory resides. Otherwise, >- * the value should be provided in SID-printable format as >- * S-1-x-y-z, and is used directly. The <sid or name> >- * associated with the ACL: attribute should be provided >- * similarly. >- * >- * @param size The number of the bytes of data in the value buffer >- * >- * @param flags A bit-wise OR of zero or more of the following: >- * SMBC_XATTR_FLAG_CREATE - >- * fail if the named attribute already exists >- * SMBC_XATTR_FLAG_REPLACE - >- * fail if the attribute does not already exist >- * >- * If neither flag is specified, the specified attributes >- * will be added or replace existing attributes of the same >- * name, as necessary. >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EINVAL The client library is not properly initialized >- * or one of the parameters is not of a correct >- * form >- * - ENOMEM No memory was available for internal needs >- * - EEXIST If the attribute already exists and the flag >- * SMBC_XATTR_FLAG_CREAT was specified >- * - ENOATTR If the attribute does not exist and the flag >- * SMBC_XATTR_FLAG_REPLACE was specified >- * - EPERM Permission was denied. >- * - ENOTSUP The referenced file system does not support >- * extended attributes >- * >- * @note Attribute names are compared in a case-insensitive >- * fashion. All of the following are equivalent, although >- * the all-lower-case name is the preferred format: >- * system.nt_sec_desc.owner >- * SYSTEM.NT_SEC_DESC.OWNER >- * sYsTeM.nt_sEc_desc.owNER >- * >- */ >-int smbc_lsetxattr(const char *url, >- const char *name, >- const void *value, >- size_t size, >- int flags); >- >- >-/**@ingroup attribute >- * Set extended attributes for a file. This is used for modifying a file's >- * security descriptor (i.e. owner, group, and access control list) >- * >- * @param fd A file descriptor associated with an open file (as >- * previously returned by smbc_open(), to get extended >- * attributes for. >- * >- * @param name The name of an attribute to be changed. Names are of >- * one of the following forms: >- * >- * system.nt_sec_desc.<attribute name> >- * system.nt_sec_desc.* >- * system.nt_sec_desc.*+ >- * >- * where <attribute name> is one of: >- * >- * revision >- * owner >- * owner+ >- * group >- * group+ >- * acl:<name or sid> >- * acl+:<name or sid> >- * >- * In the forms "system.nt_sec_desc.*" and >- * "system.nt_sec_desc.*+", the asterisk and plus signs are >- * literal, i.e. the string is provided exactly as shown, and >- * the value parameter should contain a complete security >- * descriptor with name:value pairs separated by tabs, >- * commas, or newlines (not spaces!). >- * >- * The plus sign ('+') indicates that SIDs should be mapped >- * to names. Without the plus sign, SIDs are not mapped; >- * rather they are simply converted to a string format. >- * >- * @param value The value to be assigned to the specified attribute name. >- * This buffer should contain only the attribute value if the >- * name was of the "system.nt_sec_desc.<attribute_name>" >- * form. If the name was of the "system.nt_sec_desc.*" form >- * then a complete security descriptor, with name:value pairs >- * separated by tabs, commas, or newlines (not spaces!), >- * should be provided in this value buffer. A complete >- * security descriptor will contain one or more entries >- * selected from the following: >- * >- * REVISION:<revision number> >- * OWNER:<sid or name> >- * GROUP:<sid or name> >- * ACL:<sid or name>:<type>/<flags>/<mask> >- * >- * The revision of the ACL specifies the internal Windows NT >- * ACL revision for the security descriptor. If not specified >- * it defaults to 1. Using values other than 1 may cause >- * strange behaviour. >- * >- * The owner and group specify the owner and group sids for >- * the object. If the attribute name (either '*+' with a >- * complete security descriptor, or individual 'owner+' or >- * 'group+' attribute names) ended with a plus sign, the >- * specified name is resolved to a SID value, using the >- * server on which the file or directory resides. Otherwise, >- * the value should be provided in SID-printable format as >- * S-1-x-y-z, and is used directly. The <sid or name> >- * associated with the ACL: attribute should be provided >- * similarly. >- * >- * @param size The number of the bytes of data in the value buffer >- * >- * @param flags A bit-wise OR of zero or more of the following: >- * SMBC_XATTR_FLAG_CREATE - >- * fail if the named attribute already exists >- * SMBC_XATTR_FLAG_REPLACE - >- * fail if the attribute does not already exist >- * >- * If neither flag is specified, the specified attributes >- * will be added or replace existing attributes of the same >- * name, as necessary. >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EINVAL The client library is not properly initialized >- * or one of the parameters is not of a correct >- * form >- * - ENOMEM No memory was available for internal needs >- * - EEXIST If the attribute already exists and the flag >- * SMBC_XATTR_FLAG_CREAT was specified >- * - ENOATTR If the attribute does not exist and the flag >- * SMBC_XATTR_FLAG_REPLACE was specified >- * - EPERM Permission was denied. >- * - ENOTSUP The referenced file system does not support >- * extended attributes >- * >- * @note Attribute names are compared in a case-insensitive >- * fashion. All of the following are equivalent, although >- * the all-lower-case name is the preferred format: >- * system.nt_sec_desc.owner >- * SYSTEM.NT_SEC_DESC.OWNER >- * sYsTeM.nt_sEc_desc.owNER >- * >- */ >-int smbc_fsetxattr(int fd, >- const char *name, >- const void *value, >- size_t size, >- int flags); >- >- >-/**@ingroup attribute >- * Get extended attributes for a file. >- * >- * @param url The smb url of the file or directory to get extended >- * attributes for. >- * >- * @param name The name of an attribute to be retrieved. Names are of >- * one of the following forms: >- * >- * system.nt_sec_desc.<attribute name> >- * system.nt_sec_desc.* >- * system.nt_sec_desc.*+ >- * >- * where <attribute name> is one of: >- * >- * revision >- * owner >- * owner+ >- * group >- * group+ >- * acl:<name or sid> >- * acl+:<name or sid> >- * >- * In the forms "system.nt_sec_desc.*" and >- * "system.nt_sec_desc.*+", the asterisk and plus signs are >- * literal, i.e. the string is provided exactly as shown, and >- * the value parameter will return a complete security >- * descriptor with name:value pairs separated by tabs, >- * commas, or newlines (not spaces!). >- * >- * The plus sign ('+') indicates that SIDs should be mapped >- * to names. Without the plus sign, SIDs are not mapped; >- * rather they are simply converted to a string format. >- * >- * @param value A pointer to a buffer in which the value of the specified >- * attribute will be placed (unless size is zero). >- * >- * @param size The size of the buffer pointed to by value. This parameter >- * may also be zero, in which case the size of the buffer >- * required to hold the attribute value will be returned, >- * but nothing will be placed into the value buffer. >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EINVAL The client library is not properly initialized >- * or one of the parameters is not of a correct >- * form >- * - ENOMEM No memory was available for internal needs >- * - EEXIST If the attribute already exists and the flag >- * SMBC_XATTR_FLAG_CREAT was specified >- * - ENOATTR If the attribute does not exist and the flag >- * SMBC_XATTR_FLAG_REPLACE was specified >- * - EPERM Permission was denied. >- * - ENOTSUP The referenced file system does not support >- * extended attributes >- * >- */ >-int smbc_getxattr(const char *url, >- const char *name, >- const void *value, >- size_t size); >- >- >-/**@ingroup attribute >- * Get extended attributes for a file. The POSIX function which this maps to >- * would act on a symbolic link rather than acting on what the symbolic link >- * points to, but with no symbolic links in SMB file systems, this function >- * is functionally identical to smbc_getxattr(). >- * >- * @param url The smb url of the file or directory to get extended >- * attributes for. >- * >- * @param name The name of an attribute to be retrieved. Names are of >- * one of the following forms: >- * >- * system.nt_sec_desc.<attribute name> >- * system.nt_sec_desc.* >- * system.nt_sec_desc.*+ >- * >- * where <attribute name> is one of: >- * >- * revision >- * owner >- * owner+ >- * group >- * group+ >- * acl:<name or sid> >- * acl+:<name or sid> >- * >- * In the forms "system.nt_sec_desc.*" and >- * "system.nt_sec_desc.*+", the asterisk and plus signs are >- * literal, i.e. the string is provided exactly as shown, and >- * the value parameter will return a complete security >- * descriptor with name:value pairs separated by tabs, >- * commas, or newlines (not spaces!). >- * >- * The plus sign ('+') indicates that SIDs should be mapped >- * to names. Without the plus sign, SIDs are not mapped; >- * rather they are simply converted to a string format. >- * >- * @param value A pointer to a buffer in which the value of the specified >- * attribute will be placed (unless size is zero). >- * >- * @param size The size of the buffer pointed to by value. This parameter >- * may also be zero, in which case the size of the buffer >- * required to hold the attribute value will be returned, >- * but nothing will be placed into the value buffer. >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EINVAL The client library is not properly initialized >- * or one of the parameters is not of a correct >- * form >- * - ENOMEM No memory was available for internal needs >- * - EEXIST If the attribute already exists and the flag >- * SMBC_XATTR_FLAG_CREAT was specified >- * - ENOATTR If the attribute does not exist and the flag >- * SMBC_XATTR_FLAG_REPLACE was specified >- * - EPERM Permission was denied. >- * - ENOTSUP The referenced file system does not support >- * extended attributes >- * >- */ >-int smbc_lgetxattr(const char *url, >- const char *name, >- const void *value, >- size_t size); >- >- >-/**@ingroup attribute >- * Get extended attributes for a file. >- * >- * @param fd A file descriptor associated with an open file (as >- * previously returned by smbc_open(), to get extended >- * attributes for. >- * >- * @param name The name of an attribute to be retrieved. Names are of >- * one of the following forms: >- * >- * system.nt_sec_desc.<attribute name> >- * system.nt_sec_desc.* >- * system.nt_sec_desc.*+ >- * >- * where <attribute name> is one of: >- * >- * revision >- * owner >- * owner+ >- * group >- * group+ >- * acl:<name or sid> >- * acl+:<name or sid> >- * >- * In the forms "system.nt_sec_desc.*" and >- * "system.nt_sec_desc.*+", the asterisk and plus signs are >- * literal, i.e. the string is provided exactly as shown, and >- * the value parameter will return a complete security >- * descriptor with name:value pairs separated by tabs, >- * commas, or newlines (not spaces!). >- * >- * The plus sign ('+') indicates that SIDs should be mapped >- * to names. Without the plus sign, SIDs are not mapped; >- * rather they are simply converted to a string format. >- * >- * @param value A pointer to a buffer in which the value of the specified >- * attribute will be placed (unless size is zero). >- * >- * @param size The size of the buffer pointed to by value. This parameter >- * may also be zero, in which case the size of the buffer >- * required to hold the attribute value will be returned, >- * but nothing will be placed into the value buffer. >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EINVAL The client library is not properly initialized >- * or one of the parameters is not of a correct >- * form >- * - ENOMEM No memory was available for internal needs >- * - EEXIST If the attribute already exists and the flag >- * SMBC_XATTR_FLAG_CREAT was specified >- * - ENOATTR If the attribute does not exist and the flag >- * SMBC_XATTR_FLAG_REPLACE was specified >- * - EPERM Permission was denied. >- * - ENOTSUP The referenced file system does not support >- * extended attributes >- * >- */ >-int smbc_fgetxattr(int fd, >- const char *name, >- const void *value, >- size_t size); >- >- >-/**@ingroup attribute >- * Remove extended attributes for a file. This is used for modifying a file's >- * security descriptor (i.e. owner, group, and access control list) >- * >- * @param url The smb url of the file or directory to remove the extended >- * attributes for. >- * >- * @param name The name of an attribute to be removed. Names are of >- * one of the following forms: >- * >- * system.nt_sec_desc.<attribute name> >- * system.nt_sec_desc.* >- * system.nt_sec_desc.*+ >- * >- * where <attribute name> is one of: >- * >- * revision >- * owner >- * owner+ >- * group >- * group+ >- * acl:<name or sid> >- * acl+:<name or sid> >- * >- * In the forms "system.nt_sec_desc.*" and >- * "system.nt_sec_desc.*+", the asterisk and plus signs are >- * literal, i.e. the string is provided exactly as shown, and >- * the value parameter will return a complete security >- * descriptor with name:value pairs separated by tabs, >- * commas, or newlines (not spaces!). >- * >- * The plus sign ('+') indicates that SIDs should be mapped >- * to names. Without the plus sign, SIDs are not mapped; >- * rather they are simply converted to a string format. >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EINVAL The client library is not properly initialized >- * - ENOMEM No memory was available for internal needs >- * - EPERM Permission was denied. >- * - ENOTSUP The referenced file system does not support >- * extended attributes >- * >- */ >-int smbc_removexattr(const char *url, >- const char *name); >- >- >-/**@ingroup attribute >- * Remove extended attributes for a file. This is used for modifying a file's >- * security descriptor (i.e. owner, group, and access control list) The POSIX >- * function which this maps to would act on a symbolic link rather than acting >- * on what the symbolic link points to, but with no symbolic links in SMB file >- * systems, this function is functionally identical to smbc_removexattr(). >- * >- * @param url The smb url of the file or directory to remove the extended >- * attributes for. >- * >- * @param name The name of an attribute to be removed. Names are of >- * one of the following forms: >- * >- * system.nt_sec_desc.<attribute name> >- * system.nt_sec_desc.* >- * system.nt_sec_desc.*+ >- * >- * where <attribute name> is one of: >- * >- * revision >- * owner >- * owner+ >- * group >- * group+ >- * acl:<name or sid> >- * acl+:<name or sid> >- * >- * In the forms "system.nt_sec_desc.*" and >- * "system.nt_sec_desc.*+", the asterisk and plus signs are >- * literal, i.e. the string is provided exactly as shown, and >- * the value parameter will return a complete security >- * descriptor with name:value pairs separated by tabs, >- * commas, or newlines (not spaces!). >- * >- * The plus sign ('+') indicates that SIDs should be mapped >- * to names. Without the plus sign, SIDs are not mapped; >- * rather they are simply converted to a string format. >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EINVAL The client library is not properly initialized >- * - ENOMEM No memory was available for internal needs >- * - EPERM Permission was denied. >- * - ENOTSUP The referenced file system does not support >- * extended attributes >- * >- */ >-int smbc_lremovexattr(const char *url, >- const char *name); >- >- >-/**@ingroup attribute >- * Remove extended attributes for a file. This is used for modifying a file's >- * security descriptor (i.e. owner, group, and access control list) >- * >- * @param fd A file descriptor associated with an open file (as >- * previously returned by smbc_open(), to get extended >- * attributes for. >- * >- * @param name The name of an attribute to be removed. Names are of >- * one of the following forms: >- * >- * system.nt_sec_desc.<attribute name> >- * system.nt_sec_desc.* >- * system.nt_sec_desc.*+ >- * >- * where <attribute name> is one of: >- * >- * revision >- * owner >- * owner+ >- * group >- * group+ >- * acl:<name or sid> >- * acl+:<name or sid> >- * >- * In the forms "system.nt_sec_desc.*" and >- * "system.nt_sec_desc.*+", the asterisk and plus signs are >- * literal, i.e. the string is provided exactly as shown, and >- * the value parameter will return a complete security >- * descriptor with name:value pairs separated by tabs, >- * commas, or newlines (not spaces!). >- * >- * The plus sign ('+') indicates that SIDs should be mapped >- * to names. Without the plus sign, SIDs are not mapped; >- * rather they are simply converted to a string format. >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EINVAL The client library is not properly initialized >- * - ENOMEM No memory was available for internal needs >- * - EPERM Permission was denied. >- * - ENOTSUP The referenced file system does not support >- * extended attributes >- * >- */ >-int smbc_fremovexattr(int fd, >- const char *name); >- >- >-/**@ingroup attribute >- * List the supported extended attribute names associated with a file >- * >- * @param url The smb url of the file or directory to list the extended >- * attributes for. >- * >- * @param list A pointer to a buffer in which the list of attributes for >- * the specified file or directory will be placed (unless >- * size is zero). >- * >- * @param size The size of the buffer pointed to by list. This parameter >- * may also be zero, in which case the size of the buffer >- * required to hold all of the attribute names will be >- * returned, but nothing will be placed into the list buffer. >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EINVAL The client library is not properly initialized >- * - ENOMEM No memory was available for internal needs >- * - EPERM Permission was denied. >- * - ENOTSUP The referenced file system does not support >- * extended attributes >- * >- * @note This function always returns all attribute names supported >- * by NT file systems, regardless of wether the referenced >- * file system supports extended attributes (e.g. a Windows >- * 2000 machine supports extended attributes if NTFS is used, >- * but not if FAT is used, and Windows 98 doesn't support >- * extended attributes at all. Whether this is a feature or >- * a bug is yet to be decided. >- */ >-int smbc_listxattr(const char *url, >- char *list, >- size_t size); >- >-/**@ingroup attribute >- * List the supported extended attribute names associated with a file The >- * POSIX function which this maps to would act on a symbolic link rather than >- * acting on what the symbolic link points to, but with no symbolic links in >- * SMB file systems, this function is functionally identical to >- * smbc_listxattr(). >- * >- * @param url The smb url of the file or directory to list the extended >- * attributes for. >- * >- * @param list A pointer to a buffer in which the list of attributes for >- * the specified file or directory will be placed (unless >- * size is zero). >- * >- * @param size The size of the buffer pointed to by list. This parameter >- * may also be zero, in which case the size of the buffer >- * required to hold all of the attribute names will be >- * returned, but nothing will be placed into the list buffer. >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EINVAL The client library is not properly initialized >- * - ENOMEM No memory was available for internal needs >- * - EPERM Permission was denied. >- * - ENOTSUP The referenced file system does not support >- * extended attributes >- * >- * @note This function always returns all attribute names supported >- * by NT file systems, regardless of wether the referenced >- * file system supports extended attributes (e.g. a Windows >- * 2000 machine supports extended attributes if NTFS is used, >- * but not if FAT is used, and Windows 98 doesn't support >- * extended attributes at all. Whether this is a feature or >- * a bug is yet to be decided. >- */ >-int smbc_llistxattr(const char *url, >- char *list, >- size_t size); >- >-/**@ingroup attribute >- * List the supported extended attribute names associated with a file >- * >- * @param fd A file descriptor associated with an open file (as >- * previously returned by smbc_open(), to get extended >- * attributes for. >- * >- * @param list A pointer to a buffer in which the list of attributes for >- * the specified file or directory will be placed (unless >- * size is zero). >- * >- * @param size The size of the buffer pointed to by list. This parameter >- * may also be zero, in which case the size of the buffer >- * required to hold all of the attribute names will be >- * returned, but nothing will be placed into the list buffer. >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EINVAL The client library is not properly initialized >- * - ENOMEM No memory was available for internal needs >- * - EPERM Permission was denied. >- * - ENOTSUP The referenced file system does not support >- * extended attributes >- * >- * @note This function always returns all attribute names supported >- * by NT file systems, regardless of wether the referenced >- * file system supports extended attributes (e.g. a Windows >- * 2000 machine supports extended attributes if NTFS is used, >- * but not if FAT is used, and Windows 98 doesn't support >- * extended attributes at all. Whether this is a feature or >- * a bug is yet to be decided. >- */ >-int smbc_flistxattr(int fd, >- char *list, >- size_t size); >- >-/**@ingroup print >- * Print a file given the name in fname. It would be a URL ... >- * >- * @param fname The URL of a file on a remote SMB server that the >- * caller wants printed >- * >- * @param printq The URL of the print share to print the file to. >- * >- * @return 0 on success, < 0 on error with errno set: >- * >- * - EINVAL fname or printq was NULL or smbc_init not >- * not called. >- * and errors returned by smbc_open >- * >- */ >-int smbc_print_file(const char *fname, const char *printq); >- >-/**@ingroup print >- * Open a print file that can be written to by other calls. This simply >- * does an smbc_open call after checking if there is a file name on the >- * URI. If not, a temporary name is added ... >- * >- * @param fname The URL of the print share to print to? >- * >- * @returns A file handle for the print file if successful. >- * Returns -1 if an error ocurred and errno has the values >- * - EINVAL fname was NULL or smbc_init not called. >- * - all errors returned by smbc_open >- * >- */ >-int smbc_open_print_job(const char *fname); >- >-/**@ingroup print >- * List the print jobs on a print share, for the moment, pass a callback >- * >- * @param purl The url of the print share to list the jobs of >- * >- * @param fn Callback function the receives printjob info >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EINVAL fname was NULL or smbc_init not called >- * - EACCES ??? >- */ >-int smbc_list_print_jobs(const char *purl, smbc_list_print_job_fn fn); >- >-/**@ingroup print >- * Delete a print job >- * >- * @param purl Url of the print share >- * >- * @param id The id of the job to delete >- * >- * @return 0 on success, < 0 on error with errno set: >- * - EINVAL fname was NULL or smbc_init not called >- * >- * @todo what errno values are possible here? >- */ >-int smbc_unlink_print_job(const char *purl, int id); >- >-/**@ingroup callback >- * Remove a server from the cached server list it's unused. >- * >- * @param context pointer to smb context >- * >- * @param srv pointer to server to remove >- * >- * @return On success, 0 is returned. 1 is returned if the server could not >- * be removed. Also useable outside libsmbclient. >- */ >-int smbc_remove_unused_server(SMBCCTX * context, SMBCSRV * srv); >- >-#ifdef __cplusplus >-} >-#endif >- >-/**@ingroup directory >- * Convert strings of %xx to their single character equivalent. >- * >- * @param dest A pointer to a buffer in which the resulting decoded >- * string should be placed. This may be a pointer to the >- * same buffer as src_segment. >- * >- * @param src A pointer to the buffer containing the URL to be decoded. >- * Any %xx sequences herein are converted to their single >- * character equivalent. Each 'x' must be a valid hexadecimal >- * digit, or that % sequence is left undecoded. >- * >- * @param max_dest_len >- * The size of the buffer pointed to by dest_segment. >- * >- * @return The number of % sequences which could not be converted >- * due to lack of two following hexadecimal digits. >- */ >-#ifdef __cplusplus >-extern "C" { >-#endif >-int >-smbc_urldecode(char *dest, char * src, size_t max_dest_len); >-#ifdef __cplusplus >-} >-#endif >- >- >-/* >- * Convert any characters not specifically allowed in a URL into their %xx >- * equivalent. >- * >- * @param dest A pointer to a buffer in which the resulting encoded >- * string should be placed. Unlike smbc_urldecode(), this >- * must be a buffer unique from src. >- * >- * @param src A pointer to the buffer containing the string to be encoded. >- * Any character not specifically allowed in a URL is converted >- * into its hexadecimal value and encoded as %xx. >- * >- * @param max_dest_len >- * The size of the buffer pointed to by dest_segment. >- * >- * @returns The remaining buffer length. >- */ >-#ifdef __cplusplus >-extern "C" { >-#endif >-int >-smbc_urlencode(char * dest, char * src, int max_dest_len); >-#ifdef __cplusplus >-} >-#endif >- >- >-/**@ingroup directory >- * Return the version of the linked Samba code, and thus the version of the >- * libsmbclient code. >- * >- * @return The version string. >- */ >-#ifdef __cplusplus >-extern "C" { >-#endif >-const char * >-smbc_version(void); >-#ifdef __cplusplus >-} >-#endif >- >- >-#endif /* SMBCLIENT_H_INCLUDED */ >Index: source/configure.in >=================================================================== >--- source/configure.in (révision 22956) >+++ source/configure.in (copie de travail) >@@ -4,6 +4,7 @@ > AC_PREREQ(2.53) > AC_INIT(include/includes.h) > AC_CONFIG_HEADER(include/config.h) >+AC_CONFIG_HEADER(include/libsmbclient.h) > AC_DEFINE(CONFIG_H_IS_FROM_SAMBA,1,[Marker for samba's config.h]) > > case "$PATH" in >@@ -770,6 +771,7 @@ > LDFLAGS="$LDFLAGS -lthread" > AC_DEFINE(_LARGEFILE64_SOURCE, 1, [Whether to enable large file support]) > AC_DEFINE(_FILE_OFFSET_BITS, 64, [File offset bits]) >+ AC_DEFINE(SMBC_FILE_OFFSET_BITS, 64, [Libsmbclient file offset bits]) > ;; > esac > else >@@ -777,6 +779,7 @@ > LDFLAGS="$LDFLAGS -lthread" > AC_DEFINE(_LARGEFILE64_SOURCE, 1, [Whether to enable large file support]) > AC_DEFINE(_FILE_OFFSET_BITS, 64, [File offset bits]) >+ AC_DEFINE(SMBC_FILE_OFFSET_BITS, 64, [Libsmbclient file offset bits]) > fi > ;; > esac >@@ -896,6 +899,7 @@ > CPPFLAGS="-D_LARGEFILE64_SOURCE -D_FILE_OFFSET_BITS=64 -D_GNU_SOURCE $CPPFLAGS" > AC_DEFINE(_LARGEFILE64_SOURCE, 1, [Whether to enable large file support]) > AC_DEFINE(_FILE_OFFSET_BITS, 64, [File offset bits]) >+ AC_DEFINE(SMBC_FILE_OFFSET_BITS, 64, [Libsmbclient file offset bits]) > AC_DEFINE(_GNU_SOURCE, 1, [Whether to use GNU libc extensions]) > fi > AC_MSG_RESULT([$LINUX_LFS_SUPPORT])
<b>You cannot view the attachment while viewing its details because your browser does not support IFRAMEs. <a href="attachment.cgi?id=2699">View the attachment on a separate page</a>.</b>
View Attachment As Raw
Actions:
View
Attachments on
bug 4053
:
2255
|
2256
|
2698
| 2699