source3/include/proto.h

   1 /*
   2  * Unix SMB/CIFS implementation.
   3  * collected prototypes header
   4  *
   5  * frozen from "make proto" in May 2008
   6  *
   7  * Copyright (C) Michael Adam 2008
   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 3 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, see <http://www.gnu.org/licenses/>.
  21  */
  22
  23 #ifndef _PROTO_H_
  24 #define _PROTO_H_
  25
  26 #include <sys/types.h>
  27 #include <regex.h>
  28
  29 #include "lib/util/access.h"
  30 #include "nsswitch/libwbclient/wbclient.h"
  31
  32 /* The following definitions come from lib/adt_tree.c  */
  33
  34 /* The following definitions come from lib/audit.c  */
  35
  36 const char *audit_category_str(uint32_t category);
  37 const char *audit_param_str(uint32_t category);
  38 const char *audit_description_str(uint32_t category);
  39 bool get_audit_category_from_param(const char *param, uint32_t *audit_category);
  40 const char *audit_policy_str(TALLOC_CTX *mem_ctx, uint32_t policy);
  41
  42 /* The following definitions come from lib/charcnv.c  */
  43
  44 void gfree_charcnv(void);
  45 size_t push_ascii(void *dest, const char *src, size_t dest_len, int flags);
  46 size_t push_ascii_fstring(void *dest, const char *src);
  47 size_t push_ascii_nstring(void *dest, const char *src);
  48 size_t pull_ascii(char *dest, const void *src, size_t dest_len, size_t src_len, int flags);
  49 size_t pull_ascii_fstring(char *dest, const void *src);
  50 size_t pull_ascii_nstring(char *dest, size_t dest_len, const void *src);
  51 size_t push_string_check_fn(void *dest, const char *src,
  52                             size_t dest_len, int flags);
  53 size_t push_string_base(const char *base, uint16_t flags2,
  54                         void *dest, const char *src,
  55                         size_t dest_len, int flags);
  56 size_t pull_string_talloc(TALLOC_CTX *ctx,
  57                         const void *base_ptr,
  58                         uint16_t smb_flags2,
  59                         char **ppdest,
  60                         const void *src,
  61                         size_t src_len,
  62                         int flags);
  63 size_t dos_PutUniCode(char *dst,const char *src, size_t len, bool null_terminate);
  64 int rpcstr_push_talloc(TALLOC_CTX *ctx, smb_ucs2_t **dest, const char *src);
  65
  66 /* The following definitions come from lib/dmallocmsg.c  */
  67
  68 void register_dmalloc_msgs(struct messaging_context *msg_ctx);
  69
  70 /* The following definitions come from lib/dprintf.c  */
  71
  72 void display_set_stderr(void);
  73
  74 /* The following definitions come from lib/errmap_unix.c  */
  75
  76 NTSTATUS map_nt_error_from_unix(int unix_error);
  77
  78 /* The following definitions come from lib/file_id.c  */
  79
  80 struct file_id vfs_file_id_from_sbuf(connection_struct *conn, const SMB_STRUCT_STAT *sbuf);
  81
  82 NTSTATUS vfs_at_fspcwd(TALLOC_CTX *mem_ctx,
  83                        struct connection_struct *conn,
  84                        struct files_struct **_fsp);
  85
  86 #include "source3/lib/interface.h"
  87
  88 /* The following definitions come from lib/ldap_debug_handler.c  */
  89
  90 void init_ldap_debugging(void);
  91
  92 /* The following definitions come from lib/ldap_escape.c  */
  93
  94 char *escape_ldap_string(TALLOC_CTX *mem_ctx, const char *s);
  95 char *escape_rdn_val_string_alloc(const char *s);
  96
  97 /* The following definitions come from lib/ms_fnmatch.c  */
  98
  99 int ms_fnmatch(const char *pattern, const char *string, bool translate_pattern,
 100                bool is_case_sensitive);
 101
 102 /* The following definitions come from lib/recvfile.c  */
 103
 104 ssize_t sys_recvfile(int fromfd,
 105                         int tofd,
 106                         off_t offset,
 107                         size_t count);
 108 ssize_t sys_recvfile(int fromfd,
 109                         int tofd,
 110                         off_t offset,
 111                         size_t count);
 112 ssize_t drain_socket(int sockfd, size_t count);
 113
 114 /* The following definitions come from lib/sendfile.c  */
 115
 116 ssize_t sys_sendfile(int tofd, int fromfd, const DATA_BLOB *header, off_t offset, size_t count);
 117
 118 /* The following definitions come from lib/server_mutex.c  */
 119
 120 struct named_mutex *grab_named_mutex(TALLOC_CTX *mem_ctx, const char *name,
 121                                      int timeout);
 122
 123 /* The following definitions come from lib/sharesec.c  */
 124
 125 NTSTATUS share_info_db_init(void);
 126 struct security_descriptor *get_share_security( TALLOC_CTX *ctx, const char *servicename,
 127                               size_t *psize);
 128 NTSTATUS set_share_security(const char *share_name,
 129                             struct security_descriptor *psd);
 130 NTSTATUS delete_share_security(const char *servicename);
 131 bool share_access_check(const struct security_token *token,
 132                         const char *sharename,
 133                         uint32_t desired_access,
 134                         uint32_t *pgranted);
 135 bool parse_usershare_acl(TALLOC_CTX *ctx, const char *acl_str, struct security_descriptor **ppsd);
 136
 137 /* The following definitions come from lib/smbrun.c  */
 138
 139 int smbrun_no_sanitize(const char *cmd, int *outfd, char * const *env);
 140 int smbrun(const char *cmd, int *outfd, char * const *env);
 141 int smbrunsecret(const char *cmd, const char *secret);
 142
 143 /* The following definitions come from lib/sysquotas.c  */
 144
 145 int sys_get_quota(const char *path, enum SMB_QUOTA_TYPE qtype, unid_t id, SMB_DISK_QUOTA *dp);
 146 int sys_set_quota(const char *path, enum SMB_QUOTA_TYPE qtype, unid_t id, SMB_DISK_QUOTA *dp);
 147
 148 /* The following definitions come from lib/sysquotas_*.c  */
 149
 150 int sys_get_vfs_quota(const char *path, const char *bdev, enum SMB_QUOTA_TYPE qtype, unid_t id, SMB_DISK_QUOTA *dp);
 151 int sys_set_vfs_quota(const char *path, const char *bdev, enum SMB_QUOTA_TYPE qtype, unid_t id, SMB_DISK_QUOTA *dp);
 152
 153 int sys_get_xfs_quota(const char *path, const char *bdev, enum SMB_QUOTA_TYPE qtype, unid_t id, SMB_DISK_QUOTA *dp);
 154 int sys_set_xfs_quota(const char *path, const char *bdev, enum SMB_QUOTA_TYPE qtype, unid_t id, SMB_DISK_QUOTA *dp);
 155
 156 int sys_get_jfs2_quota(const char *path, const char *bdev, enum SMB_QUOTA_TYPE qtype, unid_t id, SMB_DISK_QUOTA *dp);
 157 int sys_set_jfs2_quota(const char *path, const char *bdev, enum SMB_QUOTA_TYPE qtype, unid_t id, SMB_DISK_QUOTA *dp);
 158
 159 int sys_get_nfs_quota(const char *path, const char *bdev,
 160                       enum SMB_QUOTA_TYPE qtype,
 161                       unid_t id, SMB_DISK_QUOTA *dp);
 162 int sys_set_nfs_quota(const char *path, const char *bdev,
 163                       enum SMB_QUOTA_TYPE qtype,
 164                       unid_t id, SMB_DISK_QUOTA *dp);
 165
 166 /* The following definitions come from lib/system.c  */
 167
 168 ssize_t sys_send(int s, const void *msg, size_t len, int flags);
 169 ssize_t sys_recvfrom(int s, void *buf, size_t len, int flags, struct sockaddr *from, socklen_t *fromlen);
 170 int sys_fcntl_ptr(int fd, int cmd, void *arg);
 171 int sys_fcntl_long(int fd, int cmd, long arg);
 172 int sys_fcntl_int(int fd, int cmd, int arg);
 173 void update_stat_ex_mtime(struct stat_ex *dst, struct timespec write_ts);
 174 void update_stat_ex_create_time(struct stat_ex *dst, struct timespec create_time);
 175 void update_stat_ex_from_saved_stat(struct stat_ex *dst,
 176                                     const struct stat_ex *src);
 177 void copy_stat_ex_timestamps(struct stat_ex *st,
 178                              const struct smb_file_time *ft);
 179 int sys_stat(const char *fname, SMB_STRUCT_STAT *sbuf,
 180              bool fake_dir_create_times);
 181 int sys_fstat(int fd, SMB_STRUCT_STAT *sbuf,
 182               bool fake_dir_create_times);
 183 int sys_lstat(const char *fname,SMB_STRUCT_STAT *sbuf,
 184               bool fake_dir_create_times);
 185 int sys_fstatat(int fd,
 186                 const char *pathname,
 187                 SMB_STRUCT_STAT *sbuf,
 188                 int flags,
 189                 bool fake_dir_create_times);
 190 int sys_posix_fallocate(int fd, off_t offset, off_t len);
 191 int sys_fallocate(int fd, uint32_t mode, off_t offset, off_t len);
 192 DIR *sys_fdopendir(int fd);
 193 int sys_mknod(const char *path, mode_t mode, SMB_DEV_T dev);
 194 int sys_mknodat(int dirfd, const char *path, mode_t mode, SMB_DEV_T dev);
 195 char *sys_getwd(void);
 196 void set_effective_capability(enum smbd_capability capability);
 197 void drop_effective_capability(enum smbd_capability capability);
 198 long sys_random(void);
 199 void sys_srandom(unsigned int seed);
 200 int getgroups_max(void);
 201 int setgroups_max(void);
 202 int sys_getgroups(int setlen, gid_t *gidset);
 203 int sys_setgroups(gid_t UNUSED(primary_gid), int setlen, gid_t *gidset);
 204 uint32_t unix_dev_major(SMB_DEV_T dev);
 205 uint32_t unix_dev_minor(SMB_DEV_T dev);
 206 char *sys_realpath(const char *path);
 207 #if 0
 208 int sys_get_number_of_cores(void);
 209 #endif
 210
 211 struct sys_proc_fd_path_buf {
 212         char buf[35]; /* "/proc/self/fd/" + strlen(2^64) + 0-terminator */
 213 };
 214 bool sys_have_proc_fds(void);
 215 char *sys_proc_fd_path(int fd, struct sys_proc_fd_path_buf *buf);
 216
 217 struct stat;
 218 void init_stat_ex_from_stat (struct stat_ex *dst,
 219                             const struct stat *src,
 220                             bool fake_dir_create_times);
 221
 222 /* The following definitions come from lib/system_smbd.c  */
 223
 224 bool getgroups_unix_user(TALLOC_CTX *mem_ctx, const char *user,
 225                          gid_t primary_gid,
 226                          gid_t **ret_groups, uint32_t *p_ngroups);
 227
 228 /* The following definitions come from lib/time.c  */
 229
 230 uint32_t convert_time_t_to_uint32_t(time_t t);
 231 time_t convert_uint32_t_to_time_t(uint32_t u);
 232 bool nt_time_is_zero(const NTTIME *nt);
 233 time_t generalized_to_unix_time(const char *str);
 234 int get_server_zone_offset(void);
 235 int set_server_zone_offset(time_t t);
 236 char *timeval_string(TALLOC_CTX *ctx, const struct timeval *tp, bool hires);
 237 char *current_timestring(TALLOC_CTX *ctx, bool hires);
 238 void srv_put_dos_date(char *buf,int offset,time_t unixdate);
 239 void srv_put_dos_date2_ts(char *buf, int offset, struct timespec unix_ts);
 240 void srv_put_dos_date3(char *buf,int offset,time_t unixdate);
 241 void round_timespec(enum timestamp_set_resolution res, struct timespec *ts);
 242 void put_long_date_timespec(enum timestamp_set_resolution res, char *p, struct timespec ts);
 243 void put_long_date_full_timespec(enum timestamp_set_resolution res,
 244                                  char *p,
 245                                  const struct timespec *ts);
 246 struct timespec pull_long_date_full_timespec(const char *p);
 247 void put_long_date(char *p, time_t t);
 248 void dos_filetime_timespec(struct timespec *tsp);
 249 time_t make_unix_date(const void *date_ptr, int zone_offset);
 250 time_t make_unix_date2(const void *date_ptr, int zone_offset);
 251 time_t make_unix_date3(const void *date_ptr, int zone_offset);
 252 time_t srv_make_unix_date(const void *date_ptr);
 253 time_t srv_make_unix_date2(const void *date_ptr);
 254 time_t srv_make_unix_date3(const void *date_ptr);
 255 struct timespec interpret_long_date(NTTIME nt);
 256 void TimeInit(void);
 257 void get_process_uptime(struct timeval *ret_time);
 258 void get_startup_time(struct timeval *ret_time);
 259 time_t nt_time_to_unix_abs(const NTTIME *nt);
 260 void unix_to_nt_time_abs(NTTIME *nt, time_t t);
 261 const char *time_to_asc(const time_t t);
 262 const char *display_time(NTTIME nttime);
 263 bool nt_time_is_set(const NTTIME *nt);
 264
 265 /* The following definitions come from lib/username.c  */
 266
 267 void flush_pwnam_cache(void);
 268 char *get_user_home_dir(TALLOC_CTX *mem_ctx, const char *user);
 269 struct passwd *Get_Pwnam_alloc(TALLOC_CTX *mem_ctx, const char *user);
 270
 271 /* The following definitions come from lib/util_names.c  */
 272 const char *get_global_sam_name(void);
 273 const char *my_sam_name(void);
 274 bool is_allowed_domain(const char *domain_name);
 275
 276 /* The following definitions come from lib/util.c  */
 277
 278 void set_Protocol(enum protocol_types  p);
 279 void gfree_all( void );
 280 bool file_exist_stat(const char *fname,SMB_STRUCT_STAT *sbuf,
 281                      bool fake_dir_create_times);
 282 bool socket_exist(const char *fname);
 283 uint64_t get_file_size_stat(const SMB_STRUCT_STAT *sbuf);
 284 bool check_same_dev_ino(const SMB_STRUCT_STAT *sbuf1,
 285                         const SMB_STRUCT_STAT *sbuf2);
 286 bool check_same_stat(const SMB_STRUCT_STAT *sbuf1,
 287                         const SMB_STRUCT_STAT *sbuf2);
 288 void show_msg(const char *buf);
 289 int set_message_bcc(char *buf,int num_bytes);
 290 ssize_t message_push_blob(uint8_t **outbuf, DATA_BLOB blob);
 291 char *unix_clean_name(TALLOC_CTX *ctx, const char *s);
 292 char *clean_name(TALLOC_CTX *ctx, const char *s);
 293 ssize_t write_data_at_offset(int fd, const char *buffer, size_t N, off_t pos);
 294 NTSTATUS init_before_fork(void);
 295 int parent_watch_fd(void);
 296 NTSTATUS reinit_after_fork(struct messaging_context *msg_ctx,
 297                            struct tevent_context *ev_ctx,
 298                            bool parent_longlived);
 299 NTSTATUS smbd_reinit_after_fork(struct messaging_context *msg_ctx,
 300                                 struct tevent_context *ev_ctx,
 301                                 bool parent_longlived);
 302 void *malloc_(size_t size);
 303 void *Realloc(void *p, size_t size, bool free_old_on_error);
 304 void add_to_large_array(TALLOC_CTX *mem_ctx, size_t element_size,
 305                         void *element, void *_array, uint32_t *num_elements,
 306                         ssize_t *array_size);
 307 char *get_myname(TALLOC_CTX *ctx);
 308 char *get_mydnsdomname(TALLOC_CTX *ctx);
 309 char *automount_lookup(TALLOC_CTX *ctx, const char *user_name);
 310 char *automount_lookup(TALLOC_CTX *ctx, const char *user_name);
 311 bool process_exists(const struct server_id pid);
 312 const char *uidtoname(uid_t uid);
 313 char *gidtoname(gid_t gid);
 314 uid_t nametouid(const char *name);
 315 gid_t nametogid(const char *name);
 316 void smb_panic_s3(const char *why);
 317 void log_panic_action(const char *msg);
 318 const char *readdirname(DIR *p);
 319 bool is_in_path(const char *name,
 320                 struct name_compare_entry *namelist,
 321                 bool case_sensitive);
 322 bool token_contains_name(TALLOC_CTX *mem_ctx,
 323                          const char *username,
 324                          const char *domain,
 325                          const char *sharename,
 326                          const struct security_token *token,
 327                          const char *name,
 328                          bool *match);
 329 bool append_to_namearray(TALLOC_CTX *mem_ctx,
 330                          const char *namelist_in,
 331                          struct name_compare_entry **_name_array);
 332 bool set_namearray(TALLOC_CTX *mem_ctx,
 333                    const char *namelist,
 334                    struct name_compare_entry **_name_array);
 335 bool fcntl_lock(int fd, int op, off_t offset, off_t count, int type);
 336 bool fcntl_getlock(int fd, int op, off_t *poffset, off_t *pcount, int *ptype, pid_t *ppid);
 337 int map_process_lock_to_ofd_lock(int op);
 338 bool is_myname(const char *s);
 339 void ra_lanman_string( const char *native_lanman );
 340 const char *get_remote_arch_str(void);
 341 enum remote_arch_types get_remote_arch_from_str(const char *remote_arch_string);
 342 void set_remote_arch(enum remote_arch_types type);
 343 enum remote_arch_types get_remote_arch(void);
 344 bool remote_arch_cache_update(const struct GUID *client_guid);
 345 bool remote_arch_cache_delete(const struct GUID *client_guid);
 346 int str_checksum(const char *s);
 347 void zero_free(void *p, size_t size);
 348 int set_maxfiles(int requested_max);
 349 void *smb_xmalloc_array(size_t size, unsigned int count);
 350 char *myhostname(void);
 351 char *myhostname_upper(void);
 352 #include "lib/util_path.h"
 353 bool parent_dirname(TALLOC_CTX *mem_ctx, const char *dir, char **parent,
 354                     const char **name);
 355 bool ms_has_wild(const char *s);
 356 bool ms_has_wild_w(const smb_ucs2_t *s);
 357 bool mask_match(const char *string, const char *pattern, bool is_case_sensitive);
 358 bool mask_match_list(const char *string, char **list, int listLen, bool is_case_sensitive);
 359 #include "lib/util/unix_match.h"
 360
 361 #include "lib/util_procid.h"
 362
 363 struct server_id interpret_pid(const char *pid_string);
 364 bool is_offset_safe(const char *buf_base, size_t buf_len, char *ptr, size_t off);
 365 char *get_safe_str_ptr(const char *buf_base, size_t buf_len, char *ptr, size_t off);
 366 bool split_domain_user(TALLOC_CTX *mem_ctx,
 367                        const char *full_name,
 368                        char **domain,
 369                        char **user);
 370 const char *strip_hostname(const char *s);
 371 bool any_nt_status_not_ok(NTSTATUS err1, NTSTATUS err2, NTSTATUS *result);
 372 int timeval_to_msec(struct timeval t);
 373 char *valid_share_pathname(TALLOC_CTX *ctx, const char *dos_pathname);
 374 bool is_executable(const char *fname);
 375 bool map_open_params_to_ntcreate(const char *smb_base_fname,
 376                                  int deny_mode, int open_func,
 377                                  uint32_t *paccess_mask,
 378                                  uint32_t *pshare_mode,
 379                                  uint32_t *pcreate_disposition,
 380                                  uint32_t *pcreate_options,
 381                                  uint32_t *pprivate_flags);
 382 struct security_unix_token *copy_unix_token(TALLOC_CTX *ctx, const struct security_unix_token *tok);
 383 struct security_unix_token *root_unix_token(TALLOC_CTX *mem_ctx);
 384 char *utok_string(TALLOC_CTX *mem_ctx, const struct security_unix_token *tok);
 385 bool dir_check_ftype(uint32_t mode, uint32_t dirtype);
 386
 387 /* The following definitions come from lib/util_builtin.c  */
 388
 389 bool lookup_builtin_rid(TALLOC_CTX *mem_ctx, uint32_t rid, const char **name);
 390 bool lookup_builtin_name(const char *name, uint32_t *rid);
 391 const char *builtin_domain_name(void);
 392 bool sid_check_is_builtin(const struct dom_sid *sid);
 393 bool sid_check_is_in_builtin(const struct dom_sid *sid);
 394 bool sid_check_is_wellknown_builtin(const struct dom_sid *sid);
 395
 396 /* The following definitions come from lib/util_nscd.c  */
 397
 398 void smb_nscd_flush_user_cache(void);
 399 void smb_nscd_flush_group_cache(void);
 400
 401 /* The following definitions come from lib/util_nttoken.c  */
 402
 403 NTSTATUS merge_with_system_token(TALLOC_CTX *mem_ctx,
 404                                  const struct security_token *token_1,
 405                                  struct security_token **token_out);
 406 bool token_sid_in_ace(const struct security_token *token, const struct security_ace *ace);
 407
 408 /* The following definitions come from lib/util_sec.c  */
 409
 410 void sec_init(void);
 411 uid_t sec_initial_uid(void);
 412 gid_t sec_initial_gid(void);
 413 bool root_mode(void);
 414 bool non_root_mode(void);
 415 void gain_root_privilege(void);
 416 void gain_root_group_privilege(void);
 417 void set_effective_uid(uid_t uid);
 418 void set_effective_gid(gid_t gid);
 419 void save_re_uid(void);
 420 void restore_re_uid_fromroot(void);
 421 void restore_re_uid(void);
 422 void save_re_gid(void);
 423 void restore_re_gid(void);
 424 int set_re_uid(void);
 425 void become_user_permanently(uid_t uid, gid_t gid);
 426 int set_thread_credentials(uid_t uid,
 427                         gid_t gid,
 428                         size_t setlen,
 429                         const gid_t *gidset);
 430 bool is_setuid_root(void) ;
 431
 432 /* The following definitions come from lib/util_sid.c  */
 433
 434 char *sid_to_fstring(fstring sidstr_out, const struct dom_sid *sid);
 435 bool sid_linearize(uint8_t *outbuf, size_t len, const struct dom_sid *sid);
 436 bool non_mappable_sid(struct dom_sid *sid);
 437 char *sid_binstring_hex_talloc(TALLOC_CTX *mem_ctx, const struct dom_sid *sid);
 438 struct netr_SamInfo3;
 439 NTSTATUS sid_array_from_info3(TALLOC_CTX *mem_ctx,
 440                               const struct netr_SamInfo3 *info3,
 441                               struct dom_sid **user_sids,
 442                               uint32_t *num_user_sids,
 443                               bool include_user_group_rid);
 444 bool security_token_find_npa_flags(const struct security_token *token,
 445                                    uint32_t *_flags);
 446 void security_token_del_npa_flags(struct security_token *token);
 447
 448 /* The following definitions come from lib/util_sock.c  */
 449
 450 bool is_broadcast_addr(const struct sockaddr *pss);
 451 bool is_loopback_ip_v4(struct in_addr ip);
 452 bool is_loopback_addr(const struct sockaddr *pss);
 453 bool is_zero_addr(const struct sockaddr_storage *pss);
 454 void zero_ip_v4(struct in_addr *ip);
 455 void in_addr_to_sockaddr_storage(struct sockaddr_storage *ss,
 456                 struct in_addr ip);
 457 bool same_net(const struct sockaddr *ip1,
 458                 const struct sockaddr *ip2,
 459                 const struct sockaddr *mask);
 460 bool sockaddr_equal(const struct sockaddr *ip1,
 461                 const struct sockaddr *ip2);
 462 bool is_address_any(const struct sockaddr *psa);
 463 uint16_t get_sockaddr_port(const struct sockaddr_storage *pss);
 464 char *print_sockaddr(char *dest,
 465                         size_t destlen,
 466                         const struct sockaddr_storage *psa);
 467 char *print_canonical_sockaddr(TALLOC_CTX *ctx,
 468                         const struct sockaddr_storage *pss);
 469 bool is_a_socket(int fd);
 470 void set_socket_options(int fd, const char *options);
 471 NTSTATUS read_fd_with_timeout(int fd, char *buf,
 472                                   size_t mincnt, size_t maxcnt,
 473                                   unsigned int time_out,
 474                                   size_t *size_ret);
 475 NTSTATUS read_data_ntstatus(int fd, char *buffer, size_t N);
 476
 477 NTSTATUS read_smb_length_return_keepalive(int fd, char *inbuf,
 478                                           unsigned int timeout,
 479                                           size_t *len);
 480 NTSTATUS receive_smb_raw(int fd,
 481                         char *buffer,
 482                         size_t buflen,
 483                         unsigned int timeout,
 484                         size_t maxlen,
 485                         size_t *p_len);
 486 int open_socket_in(
 487         int type,
 488         const struct sockaddr_storage *paddr,
 489         uint16_t port,
 490         bool rebind);
 491 NTSTATUS open_socket_out(const struct sockaddr_storage *pss, uint16_t port,
 492                          int timeout, int *pfd);
 493 struct tevent_req *open_socket_out_send(TALLOC_CTX *mem_ctx,
 494                                         struct tevent_context *ev,
 495                                         const struct sockaddr_storage *pss,
 496                                         uint16_t port,
 497                                         int timeout);
 498 NTSTATUS open_socket_out_recv(struct tevent_req *req, int *pfd);
 499 struct tevent_req *open_socket_out_defer_send(TALLOC_CTX *mem_ctx,
 500                                               struct tevent_context *ev,
 501                                               struct timeval wait_time,
 502                                               const struct sockaddr_storage *pss,
 503                                               uint16_t port,
 504                                               int timeout);
 505 NTSTATUS open_socket_out_defer_recv(struct tevent_req *req, int *pfd);
 506 const char *get_peer_addr(int fd, char *addr, size_t addr_len);
 507
 508 struct tsocket_address;
 509
 510 int get_remote_hostname(const struct tsocket_address *remote_address,
 511                         char **name,
 512                         TALLOC_CTX *mem_ctx);
 513
 514 int create_pipe_sock(const char *socket_dir,
 515                      const char *socket_name,
 516                      mode_t dir_perms);
 517 const char *get_mydnsfullname(void);
 518 bool is_myname_or_ipaddr(const char *s);
 519 int poll_one_fd(int fd, int events, int timeout, int *revents);
 520 int poll_intr_one_fd(int fd, int events, int timeout, int *revents);
 521
 522 /* The following definitions come from lib/util_str.c  */
 523
 524 bool next_token(const char **ptr, char *buff, const char *sep, size_t bufsize);
 525 bool strnequal(const char *s1,const char *s2,size_t n);
 526 bool strcsequal(const char *s1,const char *s2);
 527 char *skip_string(const char *base, size_t len, char *buf);
 528 size_t str_charnum(const char *s);
 529 bool trim_char(char *s,char cfront,char cback);
 530 bool strhasupper(const char *s);
 531 bool strhaslower(const char *s);
 532 bool in_list(const char *s, const char *list, bool casesensitive);
 533 char *realloc_string_sub2(char *string,
 534                         const char *pattern,
 535                         const char *insert,
 536                         bool remove_unsafe_characters,
 537                         bool allow_trailing_dollar);
 538 char *realloc_string_sub(char *string,
 539                         const char *pattern,
 540                         const char *insert);
 541 void all_string_sub(char *s,const char *pattern,const char *insert, size_t len);
 542 char *string_truncate(char *s, unsigned int length);
 543 bool strlower_m(char *s);
 544 bool strupper_m(char *s);
 545 int fstr_sprintf(fstring s, const char *fmt, ...);
 546
 547 uint64_t STR_TO_SMB_BIG_UINT(const char *nptr, const char **entptr);
 548 uint64_t conv_str_size(const char * str);
 549 char *talloc_asprintf_strupper_m(TALLOC_CTX *t, const char *fmt, ...)
 550                                  PRINTF_ATTRIBUTE(2,3);
 551 char *talloc_asprintf_strlower_m(TALLOC_CTX *t, const char *fmt, ...)
 552                                  PRINTF_ATTRIBUTE(2,3);
 553 bool validate_net_name( const char *name,
 554                 const char *invalid_chars,
 555                 int max_len);
 556 char *escape_shell_string(const char *src);
 557 ssize_t full_path_tos(const char *dir, const char *name,
 558                       char *tmpbuf, size_t tmpbuf_len,
 559                       char **pdst, char **to_free);
 560
 561 /* The following definitions come from lib/version.c  */
 562
 563 const char *samba_version_string(void);
 564 const char *samba_copyright_string(void);
 565
 566 /* The following definitions come from lib/wins_srv.c  */
 567
 568 bool wins_srv_is_dead(struct in_addr wins_ip, struct in_addr src_ip);
 569 void wins_srv_alive(struct in_addr wins_ip, struct in_addr src_ip);
 570 void wins_srv_died(struct in_addr wins_ip, struct in_addr src_ip);
 571 unsigned wins_srv_count(void);
 572 char **wins_srv_tags(void);
 573 void wins_srv_tags_free(char **list);
 574 struct in_addr wins_srv_ip_tag(const char *tag, struct in_addr src_ip);
 575 bool wins_server_tag_ips(const char *tag, TALLOC_CTX *mem_ctx,
 576                          struct in_addr **pservers, size_t *pnum_servers);
 577 unsigned wins_srv_count_tag(const char *tag);
 578
 579 /* The following definitions come from libsmb/conncache.c  */
 580
 581 NTSTATUS check_negative_conn_cache( const char *domain, const char *server);
 582 void add_failed_connection_entry(const char *domain, const char *server, NTSTATUS result) ;
 583 void flush_negative_conn_cache_for_domain(const char *domain);
 584
 585 /* The following definitions come from libsmb/errormap.c  */
 586
 587 NTSTATUS dos_to_ntstatus(uint8_t eclass, uint32_t ecode);
 588 NTSTATUS map_nt_error_from_wbcErr(wbcErr wbc_err);
 589
 590 /* The following definitions come from libsmb/namecache.c  */
 591
 592 bool namecache_store(const char *name,
 593                         int name_type,
 594                         size_t num_names,
 595                         struct samba_sockaddr *sa_list);
 596 bool namecache_fetch(TALLOC_CTX *ctx,
 597                         const char *name,
 598                         int name_type,
 599                         struct samba_sockaddr **sa_list,
 600                         size_t *num_names);
 601 bool namecache_delete(const char *name, int name_type);
 602 void namecache_flush(void);
 603 bool namecache_status_store(const char *keyname, int keyname_type,
 604                 int name_type, const struct sockaddr_storage *keyip,
 605                 const char *srvname);
 606 bool namecache_status_fetch(const char *keyname,
 607                                 int keyname_type,
 608                                 int name_type,
 609                                 const struct sockaddr_storage *keyip,
 610                                 char *srvname_out);
 611
 612 /* The following definitions come from libsmb/namequery_dc.c  */
 613
 614 bool get_dc_name(const char *domain,
 615                 const char *realm,
 616                 fstring srv_name,
 617                 struct sockaddr_storage *ss_out);
 618
 619 /* The following definitions come from libsmb/smberr.c  */
 620
 621 const char *smb_dos_err_name(uint8_t e_class, uint16_t num);
 622 const char *get_dos_error_msg(WERROR result);
 623 const char *smb_dos_err_class(uint8_t e_class);
 624 WERROR map_werror_from_unix(int error);
 625
 626 /* The following definitions come from libsmb/trusts_util.c  */
 627
 628 struct netlogon_creds_cli_context;
 629 struct messaging_context;
 630 struct dcerpc_binding_handle;
 631 char *trust_pw_new_value(TALLOC_CTX *mem_ctx,
 632                          enum netr_SchannelType sec_channel_type,
 633                          int security);
 634 NTSTATUS trust_pw_change(struct netlogon_creds_cli_context *context,
 635                          struct messaging_context *msg_ctx,
 636                          struct dcerpc_binding_handle *b,
 637                          const char *domain,
 638                          const char *dcname,
 639                          bool force);
 640
 641 /* The following definitions come from lib/sessionid_tdb.c  */
 642 struct sessionid;
 643 NTSTATUS sessionid_traverse_read(int (*fn)(const char *key,
 644                                            struct sessionid *session,
 645                                            void *private_data),
 646                                  void *private_data);
 647
 648 /* The following definitions come from lib/avahi.c */
 649
 650 struct AvahiPoll *tevent_avahi_poll(TALLOC_CTX *mem_ctx,
 651                                     struct tevent_context *ev);
 652
 653 /* The following definitions come from libsmb/smbsock_connect.c */
 654
 655 struct tevent_req *smbsock_connect_send(TALLOC_CTX *mem_ctx,
 656                                         struct tevent_context *ev,
 657                                         const struct sockaddr_storage *addr,
 658                                         uint16_t port,
 659                                         const char *called_name,
 660                                         int called_type,
 661                                         const char *calling_name,
 662                                         int calling_type);
 663 NTSTATUS smbsock_connect_recv(struct tevent_req *req, int *sock,
 664                               uint16_t *ret_port);
 665 NTSTATUS smbsock_connect(const struct sockaddr_storage *addr, uint16_t port,
 666                          const char *called_name, int called_type,
 667                          const char *calling_name, int calling_type,
 668                          int *pfd, uint16_t *ret_port, int sec_timeout);
 669
 670 struct tevent_req *smbsock_any_connect_send(TALLOC_CTX *mem_ctx,
 671                                             struct tevent_context *ev,
 672                                             const struct sockaddr_storage *addrs,
 673                                             const char **called_names,
 674                                             int *called_types,
 675                                             const char **calling_names,
 676                                             int *calling_types,
 677                                             size_t num_addrs, uint16_t port);
 678 NTSTATUS smbsock_any_connect_recv(struct tevent_req *req, int *pfd,
 679                                   size_t *chosen_index, uint16_t *chosen_port);
 680 NTSTATUS smbsock_any_connect(const struct sockaddr_storage *addrs,
 681                              const char **called_names,
 682                              int *called_types,
 683                              const char **calling_names,
 684                              int *calling_types,
 685                              size_t num_addrs,
 686                              uint16_t port,
 687                              int sec_timeout,
 688                              int *pfd, size_t *chosen_index,
 689                              uint16_t *chosen_port);
 690
 691 /* The following definitions come from lib/util_wellknown.c  */
 692
 693 bool sid_check_is_wellknown_domain(const struct dom_sid *sid, const char **name);
 694 bool sid_check_is_in_wellknown_domain(const struct dom_sid *sid);
 695 bool lookup_wellknown_sid(TALLOC_CTX *mem_ctx, const struct dom_sid *sid,
 696                           const char **domain, const char **name);
 697 bool lookup_wellknown_name(TALLOC_CTX *mem_ctx, const char *name,
 698                            struct dom_sid *sid, const char **domain);
 699
 700 /* The following definitions come from lib/filename_util.c */
 701
 702 NTSTATUS get_full_smb_filename(TALLOC_CTX *ctx, const struct smb_filename *smb_fname,
 703                               char **full_name);
 704 struct smb_filename *synthetic_smb_fname(TALLOC_CTX *mem_ctx,
 705                                          const char *base_name,
 706                                          const char *stream_name,
 707                                          const SMB_STRUCT_STAT *psbuf,
 708                                          NTTIME twrp,
 709                                          uint32_t flags);
 710 NTSTATUS safe_symlink_target_path(TALLOC_CTX *mem_ctx,
 711                                   const char *connectpath,
 712                                   const char *dir,
 713                                   const char *target,
 714                                   size_t unparsed,
 715                                   char **_relative);
 716 NTSTATUS filename_convert_dirfsp_rel(TALLOC_CTX *mem_ctx,
 717                                      connection_struct *conn,
 718                                      struct files_struct *basedir,
 719                                      const char *name_in,
 720                                      uint32_t ucf_flags,
 721                                      NTTIME twrp,
 722                                      struct files_struct **_dirfsp,
 723                                      struct smb_filename **_smb_fname,
 724                                      struct smb_filename **_smb_fname_rel);
 725 NTSTATUS filename_convert_dirfsp(
 726         TALLOC_CTX *ctx,
 727         connection_struct *conn,
 728         const char *name_in,
 729         uint32_t ucf_flags,
 730         NTTIME twrp,
 731         struct files_struct **pdirfsp,
 732         struct smb_filename **psmb_name_rel);
 733 char *full_path_from_dirfsp_at_basename(TALLOC_CTX *mem_ctx,
 734                                         const struct files_struct *dirfsp,
 735                                         const char *at_base_name);
 736 struct smb_filename *full_path_from_dirfsp_atname(
 737         TALLOC_CTX *mem_ctx,
 738         const struct files_struct *dirfsp,
 739         const struct smb_filename *atname);
 740 struct smb_filename *synthetic_smb_fname_split(TALLOC_CTX *ctx,
 741                                                 const char *fname,
 742                                                 bool posix_path);
 743 const char *smb_fname_str_dbg(const struct smb_filename *smb_fname);
 744 const char *fsp_str_dbg(const struct files_struct *fsp);
 745 const char *fsp_fnum_dbg(const struct files_struct *fsp);
 746 struct smb_filename *cp_smb_filename(TALLOC_CTX *mem_ctx,
 747                                      const struct smb_filename *in);
 748 struct smb_filename *cp_smb_filename_nostream(TALLOC_CTX *mem_ctx,
 749                                      const struct smb_filename *in);
 750 bool is_ntfs_stream_smb_fname(const struct smb_filename *smb_fname);
 751 bool is_ntfs_default_stream_smb_fname(const struct smb_filename *smb_fname);
 752 bool is_named_stream(const struct smb_filename *smb_fname);
 753 bool is_invalid_windows_ea_name(const char *name);
 754 bool ea_list_has_invalid_name(struct ea_list *ea_list);
 755 bool split_stream_filename(TALLOC_CTX *ctx,
 756                         const char *filename_in,
 757                         char **filename_out,
 758                         char **streamname_out);
 759
 760 /* The following definitions come from lib/dummyroot.c */
 761
 762 void become_root(void);
 763 void unbecome_root(void);
 764
 765 /* The following definitions come from lib/smbd_shim.c */
 766
 767 int find_service(TALLOC_CTX *ctx, const char *service_in, char **p_service_out);
 768 bool lp_allow_local_address(
 769         int snum, const struct tsocket_address *local_address);
 770 bool change_to_root_user(void);
 771 bool become_authenticated_pipe_user(struct auth_session_info *session_info);
 772 bool unbecome_authenticated_pipe_user(void);
 773
 774 void contend_level2_oplocks_begin(files_struct *fsp,
 775                                   enum level2_contention_type type);
 776 void contend_level2_oplocks_end(files_struct *fsp,
 777                                 enum level2_contention_type type);
 778
 779 /* The following definitions come from lib/per_thread_cwd.c */
 780
 781 void per_thread_cwd_check(void);
 782 bool per_thread_cwd_supported(void);
 783 void per_thread_cwd_disable(void);
 784 void per_thread_cwd_activate(void);
 785
 786 #endif /*  _PROTO_H_  */