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