source/include/libsmbclient.h

   1 /*
   2    Unix SMB/Netbios implementation.
   3    Version 2.0
   4    SMB client library API definitions
   5    Copyright (C) Andrew Tridgell 1998
   6    Copyright (C) Richard Sharpe 2000
   7    Copyright (C) John Terpsra 2000
   8
   9    This program is free software; you can redistribute it and/or modify
  10    it under the terms of the GNU General Public License as published by
  11    the Free Software Foundation; either version 2 of the License, or
  12    (at your option) any later version.
  13
  14    This program is distributed in the hope that it will be useful,
  15    but WITHOUT ANY WARRANTY; without even the implied warranty of
  16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17    GNU General Public License for more details.
  18
  19    You should have received a copy of the GNU General Public License
  20    along with this program; if not, write to the Free Software
  21    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  22 */
  23
  24 #ifndef _SMBCLIENT_H
  25 #define _SMBCLIENT_H
  26
  27 /* Make sure we have the following includes for now ... */
  28
  29 #include <sys/types.h>
  30 #include <sys/stat.h>
  31 #include <fcntl.h>
  32
  33 #define SMBC_MAX_NAME 1023
  34
  35 struct smbc_dirent {
  36
  37   uint smbc_type;  /* Type of entity, see below */
  38   uint dirlen;     /* Convenience               */
  39   uint namelen;
  40   uint commentlen;
  41   char *comment;   /* Points to the comment futher down */
  42   char name[1];
  43
  44 };
  45
  46 /*
  47  * Entity types
  48  */
  49 #define SMBC_WORKGROUP     1
  50 #define SMBC_SERVER        2
  51 #define SMBC_FILE_SHARE    3
  52 #define SMBC_PRINTER_SHARE 4
  53 #define SMBC_COMMS_SHARE   5
  54 #define SMBC_IPC_SHARE     6
  55 #define SMBC_DIR           7
  56 #define SMBC_FILE          8
  57 #define SMBC_LINK          9
  58
  59 #define SMBC_FILE_MODE (S_IFREG | 0444)
  60 #define SMBC_DIR_MODE  (S_IFDIR | 0555)
  61
  62 typedef void (*smbc_get_auth_data_fn)(char *server, char *share,
  63                                       char *workgroup, int wgmaxlen,
  64                                       char *username, int unmaxlen,
  65                                       char *password, int pwmaxlen);
  66
  67 /*
  68  * Init the smbc package
  69  */
  70 int smbc_init(smbc_get_auth_data_fn fn, const char *workgroup, int debug);
  71
  72 /*
  73  * Open a file on an SMB server, this has the same form as normal open
  74  * but the fname is a URL of the form smb://server/share/path
  75  */
  76
  77 int smbc_open(const char *fname, int flags, mode_t mode);
  78
  79 /*
  80  * Create a file on an SMB server, similar to smbc_open
  81  */
  82
  83 int smbc_creat(const char *fname, mode_t mode);
  84
  85 /*
  86  * Read from a file, what about pread?
  87  */
  88
  89 ssize_t smbc_read(int fd, void *buf, size_t count);
  90
  91 /*
  92  * Write to a file, what about pwrite?
  93  */
  94
  95 ssize_t smbc_write(int fd, void *buf, size_t count);
  96
  97 /*
  98  * Close a file by fd
  99  */
 100
 101 int smbc_close(int fd);
 102
 103 /*
 104  * Unlink a file on server, share, dir, file ...
 105  */
 106
 107 int smbc_unlink(const char *fname);
 108
 109 /*
 110  * rename oname to nname ... probably need to be on the same
 111  * server initially. Later can copy between servers ...
 112  */
 113
 114 int smbc_rename(const char *oname, const char *nname);
 115
 116 /*
 117  * Seek to a specific location in a file on an SMB server
 118  */
 119
 120 off_t smbc_lseek(int fd, off_t offset, int whence);
 121
 122 /*
 123  * Stat a file to get info via file name
 124  */
 125
 126 int smbc_stat(const char *fname, struct stat *st);
 127
 128 /*
 129  * Stat a file to get info via an fd
 130  */
 131
 132 int smbc_fstat(int fd, struct stat *st);
 133
 134 /*
 135  * Chown a file
 136  */
 137
 138 int smbc_chown(const char *fname, uid_t owner, gid_t group);
 139
 140 /*
 141  * Chmod a file
 142  */
 143
 144 int smbc_chmod(const char *fname, mode_t newmode);
 145
 146 /*
 147  * Open a directory on a URL (server and share and dir)
 148  */
 149
 150 int smbc_opendir(const char *fname);
 151
 152 /*
 153  * Close a directory
 154  */
 155
 156 int smbc_closedir(int fd);
 157
 158 /*
 159  * Get a directory entry
 160  */
 161
 162 int smbc_getdents(unsigned int fd, struct smbc_dirent *dirp, int count);
 163
 164 /*
 165  * Read a dirent in the old way
 166  */
 167
 168 struct smbc_dirent *smbc_readdir(unsigned int fd);
 169
 170 /*
 171  * Create a directory on a server, share, dir in fname URL
 172  */
 173
 174 int smbc_mkdir(const char *fname, mode_t mode);
 175
 176 /*
 177  * Remove a directory on a server
 178  */
 179
 180 int smbc_rmdir(const char *fname);
 181
 182 /*
 183  * Get the current directory offset
 184  */
 185
 186 off_t smbc_telldir(int fd);
 187
 188 /*
 189  * lseek on directories, rewind by smbc_lseekdir(fd, 0, SEEK_SET)
 190  */
 191
 192 int smbc_lseekdir(int fd, off_t offset, int whence);
 193
 194 /*
 195  * Print a file given the name in fname. It would be a URL ...
 196  */
 197
 198 int smbc_print_file(const char *fname, const char *printq);
 199
 200 /*
 201  * Open a print file that can be written to by other calls. This simply
 202  * does an smbc_open call after checking if there is a file name on the
 203  * URI. If not, a temporary name is added ...
 204  */
 205
 206 int smbc_open_print_job(const char *fname);
 207
 208 /*
 209  * List the print jobs on a print share, for the moment, pass a callback
 210  */
 211
 212 int smbc_list_print_jobs(const char *fname, void (*fn)(struct print_job_info *));
 213
 214 /*
 215  * Delete a print job
 216  */
 217
 218 int smbc_unlink_print_job(const char *fname, int id);
 219
 220 #endif