2 * Unix SMB/CIFS implementation.
3 * collected prototypes header
5 * frozen from "make proto" in May 2008
7 * Copyright (C) Michael Adam 2008
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.
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.
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/>.
26 #include <sys/types.h>
29 #include "lib/util/access.h"
31 /* The following definitions come from lib/adt_tree.c */
33 /* The following definitions come from lib/audit.c */
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);
41 /* The following definitions come from lib/charcnv.c */
43 void gfree_charcnv(void);
44 size_t ucs2_align(const void *base_ptr, const void *p, int flags);
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,
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);
66 /* The following definitions come from lib/dmallocmsg.c */
68 void register_dmalloc_msgs(struct messaging_context *msg_ctx);
70 /* The following definitions come from lib/dprintf.c */
72 void display_set_stderr(void);
74 /* The following definitions come from lib/errmap_unix.c */
76 NTSTATUS map_nt_error_from_unix(int unix_error);
77 int map_errno_from_nt_status(NTSTATUS status);
79 /* The following definitions come from lib/file_id.c */
81 struct file_id vfs_file_id_from_sbuf(connection_struct *conn, const SMB_STRUCT_STAT *sbuf);
83 #include "lib/gencache.h"
85 /* The following definitions come from lib/interface.c */
87 bool ismyaddr(const struct sockaddr *ip);
88 bool ismyip_v4(struct in_addr ip);
89 bool is_local_net(const struct sockaddr *from);
90 void setup_linklocal_scope_id(struct sockaddr *pss);
91 bool is_local_net_v4(struct in_addr from);
92 int iface_count(void);
93 int iface_count_v4_nl(void);
94 const struct in_addr *first_ipv4_iface(void);
95 struct interface *get_interface(int n);
96 const struct sockaddr_storage *iface_n_sockaddr_storage(int n);
97 const struct in_addr *iface_n_ip_v4(int n);
98 const struct in_addr *iface_n_bcast_v4(int n);
99 const struct sockaddr_storage *iface_n_bcast(int n);
100 const struct sockaddr_storage *iface_ip(const struct sockaddr *ip);
101 bool iface_local(const struct sockaddr *ip);
102 void load_interfaces(void);
103 void gfree_interfaces(void);
104 bool interfaces_changed(void);
106 /* The following definitions come from lib/ldap_debug_handler.c */
108 void init_ldap_debugging(void);
110 /* The following definitions come from lib/ldap_escape.c */
112 char *escape_ldap_string(TALLOC_CTX *mem_ctx, const char *s);
113 char *escape_rdn_val_string_alloc(const char *s);
115 /* The following definitions come from lib/ms_fnmatch.c */
117 int ms_fnmatch(const char *pattern, const char *string, bool translate_pattern,
118 bool is_case_sensitive);
120 /* The following definitions come from lib/recvfile.c */
122 ssize_t sys_recvfile(int fromfd,
126 ssize_t sys_recvfile(int fromfd,
130 ssize_t drain_socket(int sockfd, size_t count);
132 /* The following definitions come from lib/sendfile.c */
134 ssize_t sys_sendfile(int tofd, int fromfd, const DATA_BLOB *header, off_t offset, size_t count);
136 /* The following definitions come from lib/server_mutex.c */
138 struct named_mutex *grab_named_mutex(TALLOC_CTX *mem_ctx, const char *name,
141 /* The following definitions come from lib/sharesec.c */
143 bool share_info_db_init(void);
144 struct security_descriptor *get_share_security_default( TALLOC_CTX *ctx, size_t *psize, uint32_t def_access);
145 struct security_descriptor *get_share_security( TALLOC_CTX *ctx, const char *servicename,
147 bool set_share_security(const char *share_name, struct security_descriptor *psd);
148 bool delete_share_security(const char *servicename);
149 bool share_access_check(const struct security_token *token,
150 const char *sharename,
151 uint32_t desired_access,
153 bool parse_usershare_acl(TALLOC_CTX *ctx, const char *acl_str, struct security_descriptor **ppsd);
155 /* The following definitions come from lib/smbrun.c */
157 int smbrun_no_sanitize(const char *cmd, int *outfd, char * const *env);
158 int smbrun(const char *cmd, int *outfd, char * const *env);
159 int smbrunsecret(const char *cmd, const char *secret);
161 /* The following definitions come from lib/sock_exec.c */
163 int sock_exec(const char *prog);
165 /* The following definitions come from lib/substitute.c */
167 void free_local_machine_name(void);
168 bool set_local_machine_name(const char *local_name, bool perm);
169 const char *get_local_machine_name(void);
170 bool set_remote_machine_name(const char *remote_name, bool perm);
171 const char *get_remote_machine_name(void);
172 void sub_set_smb_name(const char *name);
173 void set_current_user_info(const char *smb_name, const char *unix_name,
175 void sub_set_socket_ids(const char *peeraddr, const char *peername,
176 const char *sockaddr);
177 const char *get_current_username(void);
178 void standard_sub_basic(const char *smb_name, const char *domain_name,
179 char *str, size_t len);
180 char *talloc_sub_basic(TALLOC_CTX *mem_ctx, const char *smb_name,
181 const char *domain_name, const char *str);
182 char *talloc_sub_specified(TALLOC_CTX *mem_ctx,
183 const char *input_string,
184 const char *username,
189 char *talloc_sub_advanced(TALLOC_CTX *mem_ctx,
190 const char *servicename, const char *user,
191 const char *connectpath, gid_t gid,
192 const char *smb_name, const char *domain_name,
194 void standard_sub_advanced(const char *servicename, const char *user,
195 const char *connectpath, gid_t gid,
196 const char *smb_name, const char *domain_name,
197 char *str, size_t len);
199 /* The following definitions come from lib/sysquotas.c */
201 int sys_get_quota(const char *path, enum SMB_QUOTA_TYPE qtype, unid_t id, SMB_DISK_QUOTA *dp);
202 int sys_set_quota(const char *path, enum SMB_QUOTA_TYPE qtype, unid_t id, SMB_DISK_QUOTA *dp);
204 /* The following definitions come from lib/sysquotas_*.c */
206 int sys_get_vfs_quota(const char *path, const char *bdev, enum SMB_QUOTA_TYPE qtype, unid_t id, SMB_DISK_QUOTA *dp);
207 int sys_set_vfs_quota(const char *path, const char *bdev, enum SMB_QUOTA_TYPE qtype, unid_t id, SMB_DISK_QUOTA *dp);
209 int sys_get_xfs_quota(const char *path, const char *bdev, enum SMB_QUOTA_TYPE qtype, unid_t id, SMB_DISK_QUOTA *dp);
210 int sys_set_xfs_quota(const char *path, const char *bdev, enum SMB_QUOTA_TYPE qtype, unid_t id, SMB_DISK_QUOTA *dp);
212 int sys_get_nfs_quota(const char *path, const char *bdev,
213 enum SMB_QUOTA_TYPE qtype,
214 unid_t id, SMB_DISK_QUOTA *dp);
215 int sys_set_nfs_quota(const char *path, const char *bdev,
216 enum SMB_QUOTA_TYPE qtype,
217 unid_t id, SMB_DISK_QUOTA *dp);
219 /* The following definitions come from lib/system.c */
221 ssize_t sys_send(int s, const void *msg, size_t len, int flags);
222 ssize_t sys_recvfrom(int s, void *buf, size_t len, int flags, struct sockaddr *from, socklen_t *fromlen);
223 int sys_fcntl_ptr(int fd, int cmd, void *arg);
224 int sys_fcntl_long(int fd, int cmd, long arg);
225 void update_stat_ex_mtime(struct stat_ex *dst, struct timespec write_ts);
226 void update_stat_ex_create_time(struct stat_ex *dst, struct timespec create_time);
227 int sys_stat(const char *fname, SMB_STRUCT_STAT *sbuf,
228 bool fake_dir_create_times);
229 int sys_fstat(int fd, SMB_STRUCT_STAT *sbuf,
230 bool fake_dir_create_times);
231 int sys_lstat(const char *fname,SMB_STRUCT_STAT *sbuf,
232 bool fake_dir_create_times);
233 int sys_posix_fallocate(int fd, off_t offset, off_t len);
234 int sys_fallocate(int fd, uint32_t mode, off_t offset, off_t len);
235 void kernel_flock(int fd, uint32_t share_mode, uint32_t access_mask);
236 DIR *sys_fdopendir(int fd);
237 int sys_mknod(const char *path, mode_t mode, SMB_DEV_T dev);
238 char *sys_getwd(void);
239 void set_effective_capability(enum smbd_capability capability);
240 void drop_effective_capability(enum smbd_capability capability);
241 long sys_random(void);
242 void sys_srandom(unsigned int seed);
243 int groups_max(void);
244 int sys_getgroups(int setlen, gid_t *gidset);
245 int sys_setgroups(gid_t UNUSED(primary_gid), int setlen, gid_t *gidset);
246 uint32_t unix_dev_major(SMB_DEV_T dev);
247 uint32_t unix_dev_minor(SMB_DEV_T dev);
248 char *sys_realpath(const char *path);
250 int sys_get_number_of_cores(void);
254 void init_stat_ex_from_stat (struct stat_ex *dst,
255 const struct stat *src,
256 bool fake_dir_create_times);
258 /* The following definitions come from lib/system_smbd.c */
260 bool getgroups_unix_user(TALLOC_CTX *mem_ctx, const char *user,
262 gid_t **ret_groups, uint32_t *p_ngroups);
264 /* The following definitions come from lib/tallocmsg.c */
266 void register_msg_pool_usage(struct messaging_context *msg_ctx);
268 /* The following definitions come from lib/time.c */
270 void push_dos_date(uint8_t *buf, int offset, time_t unixdate, int zone_offset);
271 void push_dos_date2(uint8_t *buf,int offset,time_t unixdate, int zone_offset);
272 void push_dos_date3(uint8_t *buf,int offset,time_t unixdate, int zone_offset);
273 uint32_t convert_time_t_to_uint32_t(time_t t);
274 time_t convert_uint32_t_to_time_t(uint32_t u);
275 bool nt_time_is_zero(const NTTIME *nt);
276 time_t generalized_to_unix_time(const char *str);
277 int get_server_zone_offset(void);
278 int set_server_zone_offset(time_t t);
279 char *timeval_string(TALLOC_CTX *ctx, const struct timeval *tp, bool hires);
280 char *current_timestring(TALLOC_CTX *ctx, bool hires);
281 void srv_put_dos_date(char *buf,int offset,time_t unixdate);
282 void srv_put_dos_date2(char *buf,int offset, time_t unixdate);
283 void srv_put_dos_date3(char *buf,int offset,time_t unixdate);
284 void round_timespec(enum timestamp_set_resolution res, struct timespec *ts);
285 void put_long_date_timespec(enum timestamp_set_resolution res, char *p, struct timespec ts);
286 void put_long_date(char *p, time_t t);
287 void dos_filetime_timespec(struct timespec *tsp);
288 time_t make_unix_date(const void *date_ptr, int zone_offset);
289 time_t make_unix_date2(const void *date_ptr, int zone_offset);
290 time_t make_unix_date3(const void *date_ptr, int zone_offset);
291 time_t srv_make_unix_date(const void *date_ptr);
292 time_t srv_make_unix_date2(const void *date_ptr);
293 time_t srv_make_unix_date3(const void *date_ptr);
294 struct timespec interpret_long_date(const char *p);
296 void get_process_uptime(struct timeval *ret_time);
297 void get_startup_time(struct timeval *ret_time);
298 time_t nt_time_to_unix_abs(const NTTIME *nt);
299 time_t uint64s_nt_time_to_unix_abs(const uint64_t *src);
300 void unix_to_nt_time_abs(NTTIME *nt, time_t t);
301 const char *time_to_asc(const time_t t);
302 const char *display_time(NTTIME nttime);
303 bool nt_time_is_set(const NTTIME *nt);
305 /* The following definitions come from lib/username.c */
307 void flush_pwnam_cache(void);
308 char *get_user_home_dir(TALLOC_CTX *mem_ctx, const char *user);
309 struct passwd *Get_Pwnam_alloc(TALLOC_CTX *mem_ctx, const char *user);
311 /* The following definitions come from lib/util_names.c */
312 const char *get_global_sam_name(void);
313 const char *my_sam_name(void);
315 /* The following definitions come from lib/util.c */
317 enum protocol_types get_Protocol(void);
318 void set_Protocol(enum protocol_types p);
319 void gfree_names(void);
320 void gfree_all( void );
321 const char *my_netbios_names(int i);
322 bool set_netbios_aliases(const char **str_array);
323 bool init_names(void);
324 bool file_exist_stat(const char *fname,SMB_STRUCT_STAT *sbuf,
325 bool fake_dir_create_times);
326 bool socket_exist(const char *fname);
327 uint64_t get_file_size_stat(const SMB_STRUCT_STAT *sbuf);
328 bool check_same_dev_ino(const SMB_STRUCT_STAT *sbuf1,
329 const SMB_STRUCT_STAT *sbuf2);
330 bool check_same_stat(const SMB_STRUCT_STAT *sbuf1,
331 const SMB_STRUCT_STAT *sbuf2);
332 void show_msg(const char *buf);
333 int set_message_bcc(char *buf,int num_bytes);
334 ssize_t message_push_blob(uint8_t **outbuf, DATA_BLOB blob);
335 char *unix_clean_name(TALLOC_CTX *ctx, const char *s);
336 char *clean_name(TALLOC_CTX *ctx, const char *s);
337 ssize_t write_data_at_offset(int fd, const char *buffer, size_t N, off_t pos);
338 int set_blocking(int fd, bool set);
339 NTSTATUS init_before_fork(void);
340 NTSTATUS reinit_after_fork(struct messaging_context *msg_ctx,
341 struct tevent_context *ev_ctx,
342 bool parent_longlived,
343 const char *comment);
344 NTSTATUS smbd_reinit_after_fork(struct messaging_context *msg_ctx,
345 struct tevent_context *ev_ctx,
346 bool parent_longlived,
347 const char *comment);
348 void *malloc_(size_t size);
349 void *Realloc(void *p, size_t size, bool free_old_on_error);
350 void add_to_large_array(TALLOC_CTX *mem_ctx, size_t element_size,
351 void *element, void *_array, uint32_t *num_elements,
352 ssize_t *array_size);
353 char *get_myname(TALLOC_CTX *ctx);
354 char *get_mydnsdomname(TALLOC_CTX *ctx);
355 char *automount_lookup(TALLOC_CTX *ctx, const char *user_name);
356 char *automount_lookup(TALLOC_CTX *ctx, const char *user_name);
357 bool process_exists(const struct server_id pid);
358 const char *uidtoname(uid_t uid);
359 char *gidtoname(gid_t gid);
360 uid_t nametouid(const char *name);
361 gid_t nametogid(const char *name);
362 void smb_panic_s3(const char *why);
363 void log_stack_trace(void);
364 const char *readdirname(DIR *p);
365 bool is_in_path(const char *name, name_compare_entry *namelist, bool case_sensitive);
366 void set_namearray(name_compare_entry **ppname_array, const char *namelist);
367 void free_namearray(name_compare_entry *name_array);
368 bool fcntl_lock(int fd, int op, off_t offset, off_t count, int type);
369 bool fcntl_getlock(int fd, int op, off_t *poffset, off_t *pcount, int *ptype, pid_t *ppid);
370 int map_process_lock_to_ofd_lock(int op, bool *use_ofd_locks);
371 bool is_myname(const char *s);
372 void ra_lanman_string( const char *native_lanman );
373 const char *get_remote_arch_str(void);
374 enum remote_arch_types get_remote_arch_from_str(const char *remote_arch_string);
375 void set_remote_arch(enum remote_arch_types type);
376 enum remote_arch_types get_remote_arch(void);
377 bool remote_arch_cache_update(const struct GUID *client_guid);
378 bool remote_arch_cache_delete(const struct GUID *client_guid);
379 const char *tab_depth(int level, int depth);
380 int str_checksum(const char *s);
381 void zero_free(void *p, size_t size);
382 int set_maxfiles(int requested_max);
383 int smb_mkstemp(char *name_template);
384 void *smb_xmalloc_array(size_t size, unsigned int count);
385 char *myhostname(void);
386 char *myhostname_upper(void);
387 #include "lib/util_path.h"
388 bool parent_dirname(TALLOC_CTX *mem_ctx, const char *dir, char **parent,
390 bool ms_has_wild(const char *s);
391 bool ms_has_wild_w(const smb_ucs2_t *s);
392 bool mask_match(const char *string, const char *pattern, bool is_case_sensitive);
393 bool mask_match_search(const char *string, const char *pattern, bool is_case_sensitive);
394 bool mask_match_list(const char *string, char **list, int listLen, bool is_case_sensitive);
395 #include "lib/util/unix_match.h"
396 bool name_to_fqdn(fstring fqdn, const char *name);
397 uint32_t map_share_mode_to_deny_mode(uint32_t share_access, uint32_t private_options);
399 #include "lib/util_procid.h"
401 #define serverid_equal(p1, p2) server_id_equal(p1,p2)
402 struct server_id interpret_pid(const char *pid_string);
403 bool is_offset_safe(const char *buf_base, size_t buf_len, char *ptr, size_t off);
404 char *get_safe_ptr(const char *buf_base, size_t buf_len, char *ptr, size_t off);
405 char *get_safe_str_ptr(const char *buf_base, size_t buf_len, char *ptr, size_t off);
406 int get_safe_SVAL(const char *buf_base, size_t buf_len, char *ptr, size_t off, int failval);
407 int get_safe_IVAL(const char *buf_base, size_t buf_len, char *ptr, size_t off, int failval);
408 bool split_domain_user(TALLOC_CTX *mem_ctx,
409 const char *full_name,
412 const char *strip_hostname(const char *s);
413 bool any_nt_status_not_ok(NTSTATUS err1, NTSTATUS err2, NTSTATUS *result);
414 int timeval_to_msec(struct timeval t);
415 char *valid_share_pathname(TALLOC_CTX *ctx, const char *dos_pathname);
416 bool is_executable(const char *fname);
417 bool map_open_params_to_ntcreate(const char *smb_base_fname,
418 int deny_mode, int open_func,
419 uint32_t *paccess_mask,
420 uint32_t *pshare_mode,
421 uint32_t *pcreate_disposition,
422 uint32_t *pcreate_options,
423 uint32_t *pprivate_flags);
424 struct security_unix_token *copy_unix_token(TALLOC_CTX *ctx, const struct security_unix_token *tok);
425 bool dir_check_ftype(uint32_t mode, uint32_t dirtype);
427 /* The following definitions come from lib/util_builtin.c */
429 bool lookup_builtin_rid(TALLOC_CTX *mem_ctx, uint32_t rid, const char **name);
430 bool lookup_builtin_name(const char *name, uint32_t *rid);
431 const char *builtin_domain_name(void);
432 bool sid_check_is_builtin(const struct dom_sid *sid);
433 bool sid_check_is_in_builtin(const struct dom_sid *sid);
434 bool sid_check_is_wellknown_builtin(const struct dom_sid *sid);
436 /* The following definitions come from lib/util_nscd.c */
438 void smb_nscd_flush_user_cache(void);
439 void smb_nscd_flush_group_cache(void);
441 /* The following definitions come from lib/util_nttoken.c */
443 struct security_token *dup_nt_token(TALLOC_CTX *mem_ctx, const struct security_token *ptoken);
444 NTSTATUS merge_nt_token(TALLOC_CTX *mem_ctx,
445 const struct security_token *token_1,
446 const struct security_token *token_2,
447 struct security_token **token_out);
448 bool token_sid_in_ace(const struct security_token *token, const struct security_ace *ace);
450 /* The following definitions come from lib/util_sec.c */
453 uid_t sec_initial_uid(void);
454 gid_t sec_initial_gid(void);
455 bool root_mode(void);
456 bool non_root_mode(void);
457 void gain_root_privilege(void);
458 void gain_root_group_privilege(void);
459 void set_effective_uid(uid_t uid);
460 void set_effective_gid(gid_t gid);
461 void save_re_uid(void);
462 void restore_re_uid_fromroot(void);
463 void restore_re_uid(void);
464 void save_re_gid(void);
465 void restore_re_gid(void);
466 int set_re_uid(void);
467 void become_user_permanently(uid_t uid, gid_t gid);
468 int set_thread_credentials(uid_t uid,
471 const gid_t *gidset);
472 bool is_setuid_root(void) ;
474 /* The following definitions come from lib/util_sid.c */
476 char *sid_to_fstring(fstring sidstr_out, const struct dom_sid *sid);
477 char *sid_string_talloc(TALLOC_CTX *mem_ctx, const struct dom_sid *sid);
478 char *sid_string_dbg(const struct dom_sid *sid);
479 char *sid_string_tos(const struct dom_sid *sid);
480 bool sid_linearize(uint8_t *outbuf, size_t len, const struct dom_sid *sid);
481 bool non_mappable_sid(struct dom_sid *sid);
482 char *sid_binstring_hex_talloc(TALLOC_CTX *mem_ctx, const struct dom_sid *sid);
483 struct netr_SamInfo3;
484 NTSTATUS sid_array_from_info3(TALLOC_CTX *mem_ctx,
485 const struct netr_SamInfo3 *info3,
486 struct dom_sid **user_sids,
487 uint32_t *num_user_sids,
488 bool include_user_group_rid);
490 /* The following definitions come from lib/util_sock.c */
492 bool is_broadcast_addr(const struct sockaddr *pss);
493 bool is_loopback_ip_v4(struct in_addr ip);
494 bool is_loopback_addr(const struct sockaddr *pss);
495 bool is_zero_addr(const struct sockaddr_storage *pss);
496 void zero_ip_v4(struct in_addr *ip);
497 void in_addr_to_sockaddr_storage(struct sockaddr_storage *ss,
499 bool same_net(const struct sockaddr *ip1,
500 const struct sockaddr *ip2,
501 const struct sockaddr *mask);
502 bool sockaddr_equal(const struct sockaddr *ip1,
503 const struct sockaddr *ip2);
504 bool is_address_any(const struct sockaddr *psa);
505 uint16_t get_sockaddr_port(const struct sockaddr_storage *pss);
506 char *print_sockaddr(char *dest,
508 const struct sockaddr_storage *psa);
509 char *print_canonical_sockaddr(TALLOC_CTX *ctx,
510 const struct sockaddr_storage *pss);
511 int get_socket_port(int fd);
512 const char *client_addr(int fd, char *addr, size_t addrlen);
513 const char *client_socket_addr(int fd, char *addr, size_t addr_len);
514 int client_socket_port(int fd);
515 bool is_a_socket(int fd);
516 void set_socket_options(int fd, const char *options);
517 ssize_t read_udp_v4_socket(int fd,
520 struct sockaddr_storage *psa);
521 NTSTATUS read_fd_with_timeout(int fd, char *buf,
522 size_t mincnt, size_t maxcnt,
523 unsigned int time_out,
525 NTSTATUS read_data_ntstatus(int fd, char *buffer, size_t N);
527 bool send_keepalive(int client);
528 NTSTATUS read_smb_length_return_keepalive(int fd, char *inbuf,
529 unsigned int timeout,
531 NTSTATUS receive_smb_raw(int fd,
534 unsigned int timeout,
537 int open_socket_in(int type,
540 const struct sockaddr_storage *psock,
542 NTSTATUS open_socket_out(const struct sockaddr_storage *pss, uint16_t port,
543 int timeout, int *pfd);
544 struct tevent_req *open_socket_out_send(TALLOC_CTX *mem_ctx,
545 struct tevent_context *ev,
546 const struct sockaddr_storage *pss,
549 NTSTATUS open_socket_out_recv(struct tevent_req *req, int *pfd);
550 struct tevent_req *open_socket_out_defer_send(TALLOC_CTX *mem_ctx,
551 struct tevent_context *ev,
552 struct timeval wait_time,
553 const struct sockaddr_storage *pss,
556 NTSTATUS open_socket_out_defer_recv(struct tevent_req *req, int *pfd);
557 int open_udp_socket(const char *host, int port);
558 const char *get_peer_addr(int fd, char *addr, size_t addr_len);
560 struct tsocket_address;
562 int get_remote_hostname(const struct tsocket_address *remote_address,
564 TALLOC_CTX *mem_ctx);
566 int create_pipe_sock(const char *socket_dir,
567 const char *socket_name,
569 int create_tcpip_socket(const struct sockaddr_storage *ifss, uint16_t *port);
570 const char *get_mydnsfullname(void);
571 bool is_myname_or_ipaddr(const char *s);
572 int poll_one_fd(int fd, int events, int timeout, int *revents);
573 int poll_intr_one_fd(int fd, int events, int timeout, int *revents);
575 /* The following definitions come from lib/util_str.c */
577 bool next_token(const char **ptr, char *buff, const char *sep, size_t bufsize);
578 bool strnequal(const char *s1,const char *s2,size_t n);
579 bool strcsequal(const char *s1,const char *s2);
580 bool strnorm(char *s, int case_default);
581 char *push_skip_string(char *buf);
582 char *skip_string(const char *base, size_t len, char *buf);
583 size_t str_charnum(const char *s);
584 bool trim_char(char *s,char cfront,char cback);
585 bool strhasupper(const char *s);
586 bool strhaslower(const char *s);
587 char *StrnCpy(char *dest,const char *src,size_t n);
588 bool in_list(const char *s, const char *list, bool casesensitive);
589 void fstring_sub(char *s,const char *pattern,const char *insert);
590 char *realloc_string_sub2(char *string,
593 bool remove_unsafe_characters,
594 bool allow_trailing_dollar);
595 char *realloc_string_sub(char *string,
598 char *talloc_string_sub2(TALLOC_CTX *mem_ctx, const char *src,
601 bool remove_unsafe_characters,
603 bool allow_trailing_dollar);
604 char *talloc_string_sub(TALLOC_CTX *mem_ctx,
608 void all_string_sub(char *s,const char *pattern,const char *insert, size_t len);
609 char *talloc_all_string_sub(TALLOC_CTX *ctx,
613 char *octal_string(int i);
614 char *string_truncate(char *s, unsigned int length);
615 char *strchr_m(const char *src, char c);
616 char *strrchr_m(const char *s, char c);
617 char *strnrchr_m(const char *s, char c, unsigned int n);
618 char *strstr_m(const char *src, const char *findstr);
619 bool strlower_m(char *s);
620 bool strupper_m(char *s);
621 size_t strlen_m(const char *s);
622 size_t strlen_m_term(const char *s);
623 size_t strlen_m_term_null(const char *s);
624 int fstr_sprintf(fstring s, const char *fmt, ...);
625 bool str_list_sub_basic( char **list, const char *smb_name,
626 const char *domain_name );
627 bool str_list_substitute(char **list, const char *pattern, const char *insert);
629 char *ipstr_list_make(char **ipstr_list,
630 const struct ip_service *ip_list,
632 int ipstr_list_parse(const char *ipstr_list, struct ip_service **ip_list);
633 void ipstr_list_free(char* ipstr_list);
634 uint64_t STR_TO_SMB_BIG_UINT(const char *nptr, const char **entptr);
635 uint64_t conv_str_size(const char * str);
636 int asprintf_strupper_m(char **strp, const char *fmt, ...)
637 PRINTF_ATTRIBUTE(2,3);
638 char *talloc_asprintf_strupper_m(TALLOC_CTX *t, const char *fmt, ...)
639 PRINTF_ATTRIBUTE(2,3);
640 char *talloc_asprintf_strlower_m(TALLOC_CTX *t, const char *fmt, ...)
641 PRINTF_ATTRIBUTE(2,3);
642 bool validate_net_name( const char *name,
643 const char *invalid_chars,
645 char *escape_shell_string(const char *src);
646 ssize_t full_path_tos(const char *dir, const char *name,
647 char *tmpbuf, size_t tmpbuf_len,
648 char **pdst, char **to_free);
650 /* The following definitions come from lib/version.c */
652 const char *samba_version_string(void);
654 /* The following definitions come from lib/wins_srv.c */
656 bool wins_srv_is_dead(struct in_addr wins_ip, struct in_addr src_ip);
657 void wins_srv_alive(struct in_addr wins_ip, struct in_addr src_ip);
658 void wins_srv_died(struct in_addr wins_ip, struct in_addr src_ip);
659 unsigned wins_srv_count(void);
660 char **wins_srv_tags(void);
661 void wins_srv_tags_free(char **list);
662 struct in_addr wins_srv_ip_tag(const char *tag, struct in_addr src_ip);
663 bool wins_server_tag_ips(const char *tag, TALLOC_CTX *mem_ctx,
664 struct in_addr **pservers, int *pnum_servers);
665 unsigned wins_srv_count_tag(const char *tag);
667 #ifndef ASN1_MAX_OIDS
668 #define ASN1_MAX_OIDS 20
670 bool spnego_parse_negTokenInit(TALLOC_CTX *ctx,
672 char *OIDs[ASN1_MAX_OIDS],
675 DATA_BLOB spnego_gen_krb5_wrap(TALLOC_CTX *ctx, const DATA_BLOB ticket, const uint8_t tok_id[2]);
677 /* The following definitions come from libsmb/conncache.c */
679 NTSTATUS check_negative_conn_cache( const char *domain, const char *server);
680 void add_failed_connection_entry(const char *domain, const char *server, NTSTATUS result) ;
681 void flush_negative_conn_cache_for_domain(const char *domain);
683 /* The following definitions come from libsmb/dsgetdcname.c */
685 struct netr_DsRGetDCNameInfo;
687 NTSTATUS dsgetdcname(TALLOC_CTX *mem_ctx,
688 struct messaging_context *msg_ctx,
689 const char *domain_name,
690 const struct GUID *domain_guid,
691 const char *site_name,
693 struct netr_DsRGetDCNameInfo **info);
695 /* The following definitions come from libsmb/errormap.c */
697 NTSTATUS dos_to_ntstatus(uint8_t eclass, uint32_t ecode);
699 /* The following definitions come from libsmb/namecache.c */
701 bool namecache_store(const char *name,
704 struct ip_service *ip_list);
705 bool namecache_fetch(const char *name,
707 struct ip_service **ip_list,
709 bool namecache_delete(const char *name, int name_type);
710 void namecache_flush(void);
711 bool namecache_status_store(const char *keyname, int keyname_type,
712 int name_type, const struct sockaddr_storage *keyip,
713 const char *srvname);
714 bool namecache_status_fetch(const char *keyname,
717 const struct sockaddr_storage *keyip,
720 /* The following definitions come from libsmb/namequery.c */
722 bool saf_store( const char *domain, const char *servername );
723 bool saf_join_store( const char *domain, const char *servername );
724 bool saf_delete( const char *domain );
725 char *saf_fetch(TALLOC_CTX *mem_ctx, const char *domain );
726 struct tevent_req *node_status_query_send(TALLOC_CTX *mem_ctx,
727 struct tevent_context *ev,
728 struct nmb_name *name,
729 const struct sockaddr_storage *addr);
730 NTSTATUS node_status_query_recv(struct tevent_req *req, TALLOC_CTX *mem_ctx,
731 struct node_status **pnode_status,
733 struct node_status_extra *extra);
734 NTSTATUS node_status_query(TALLOC_CTX *mem_ctx, struct nmb_name *name,
735 const struct sockaddr_storage *addr,
736 struct node_status **pnode_status,
738 struct node_status_extra *extra);
739 bool name_status_find(const char *q_name,
742 const struct sockaddr_storage *to_ss,
744 int remove_duplicate_addrs2(struct ip_service *iplist, int count );
745 struct tevent_req *name_query_send(TALLOC_CTX *mem_ctx,
746 struct tevent_context *ev,
747 const char *name, int name_type,
748 bool bcast, bool recurse,
749 const struct sockaddr_storage *addr);
750 NTSTATUS name_query_recv(struct tevent_req *req, TALLOC_CTX *mem_ctx,
751 struct sockaddr_storage **addrs, int *num_addrs,
753 NTSTATUS name_query(const char *name, int name_type,
754 bool bcast, bool recurse,
755 const struct sockaddr_storage *to_ss,
757 struct sockaddr_storage **addrs,
758 int *num_addrs, uint8_t *flags);
759 struct tevent_req *name_resolve_bcast_send(TALLOC_CTX *mem_ctx,
760 struct tevent_context *ev,
763 NTSTATUS name_resolve_bcast_recv(struct tevent_req *req, TALLOC_CTX *mem_ctx,
764 struct sockaddr_storage **addrs,
766 NTSTATUS name_resolve_bcast(const char *name,
769 struct sockaddr_storage **return_iplist,
771 struct tevent_req *resolve_wins_send(TALLOC_CTX *mem_ctx,
772 struct tevent_context *ev,
775 NTSTATUS resolve_wins_recv(struct tevent_req *req, TALLOC_CTX *mem_ctx,
776 struct sockaddr_storage **addrs,
777 int *num_addrs, uint8_t *flags);
778 NTSTATUS resolve_wins(const char *name,
781 struct sockaddr_storage **return_iplist,
783 NTSTATUS internal_resolve_name(const char *name,
785 const char *sitename,
786 struct ip_service **return_iplist,
788 const char **resolve_order);
789 bool resolve_name(const char *name,
790 struct sockaddr_storage *return_ss,
793 NTSTATUS resolve_name_list(TALLOC_CTX *ctx,
796 struct sockaddr_storage **return_ss_arr,
797 unsigned int *p_num_entries);
798 bool find_master_ip(const char *group, struct sockaddr_storage *master_ss);
799 bool get_pdc_ip(const char *domain, struct sockaddr_storage *pss);
800 NTSTATUS get_sorted_dc_list( const char *domain,
801 const char *sitename,
802 struct ip_service **ip_list,
805 NTSTATUS get_kdc_list( const char *realm,
806 const char *sitename,
807 struct ip_service **ip_list,
810 /* The following definitions come from libsmb/namequery_dc.c */
812 bool get_dc_name(const char *domain,
815 struct sockaddr_storage *ss_out);
817 /* The following definitions come from libsmb/smberr.c */
819 const char *smb_dos_err_name(uint8_t e_class, uint16_t num);
820 const char *get_dos_error_msg(WERROR result);
821 const char *smb_dos_err_class(uint8_t e_class);
822 WERROR map_werror_from_unix(int error);
824 /* The following definitions come from libsmb/trustdom_cache.c */
826 bool trustdom_cache_store(const char *name, const struct dom_sid *sid);
827 bool trustdom_cache_fetch(const char* name, struct dom_sid* sid);
828 void trustdom_cache_flush(void);
829 void update_trustdom_cache( void );
831 /* The following definitions come from libsmb/trusts_util.c */
833 struct netlogon_creds_cli_context;
834 struct messaging_context;
835 struct dcerpc_binding_handle;
836 char *trust_pw_new_value(TALLOC_CTX *mem_ctx,
837 enum netr_SchannelType sec_channel_type,
839 NTSTATUS trust_pw_change(struct netlogon_creds_cli_context *context,
840 struct messaging_context *msg_ctx,
841 struct dcerpc_binding_handle *b,
846 /* The following definitions come from param/loadparm.c */
848 #include "source3/param/param_proto.h"
850 char *lp_servicename(TALLOC_CTX *ctx, int);
851 const char *lp_const_servicename(int);
852 bool lp_autoloaded(int);
853 const char *lp_dnsdomain(void);
854 int lp_winbind_max_domain_connections(void);
855 bool lp_idmap_range(const char *domain_name, uint32_t *low, uint32_t *high);
856 bool lp_idmap_default_range(uint32_t *low, uint32_t *high);
857 const char *lp_idmap_backend(const char *domain_name);
858 const char *lp_idmap_default_backend (void);
859 int lp_security(void);
860 int lp_client_max_protocol(void);
861 int lp_client_ipc_min_protocol(void);
862 int lp_client_ipc_max_protocol(void);
863 int lp_client_ipc_signing(void);
864 int lp_smb2_max_credits(void);
865 int lp_cups_encrypt(void);
866 bool lp_widelinks(int );
867 int lp_rpc_low_port(void);
868 int lp_rpc_high_port(void);
869 bool lp_lanman_auth(void);
871 int lp_wi_scan_global_parametrics(
872 const char *regex, size_t max_matches,
873 bool (*cb)(const char *string, regmatch_t matches[],
877 char *lp_parm_talloc_string(TALLOC_CTX *ctx, int snum, const char *type, const char *option, const char *def);
878 const char *lp_parm_const_string(int snum, const char *type, const char *option, const char *def);
879 struct loadparm_service;
880 const char *lp_parm_const_string_service(struct loadparm_service *service, const char *type,
881 const char *option, const char *def);
882 const char **lp_parm_string_list(int snum, const char *type, const char *option, const char **def);
883 int lp_parm_int(int snum, const char *type, const char *option, int def);
884 unsigned long lp_parm_ulong(int snum, const char *type, const char *option, unsigned long def);
885 unsigned long long lp_parm_ulonglong(int snum, const char *type,
887 unsigned long long def);
888 bool lp_parm_bool(int snum, const char *type, const char *option, bool def);
890 int lp_parm_enum(int snum, const char *type, const char *option,
891 const struct enum_list *_enum, int def);
892 char *canonicalize_servicename(TALLOC_CTX *ctx, const char *src);
893 bool lp_add_home(const char *pszHomename, int iDefaultService,
894 const char *user, const char *pszHomedir);
895 int lp_add_service(const char *pszService, int iDefaultService);
896 bool lp_add_printer(const char *pszPrintername, int iDefaultService);
897 bool lp_parameter_is_valid(const char *pszParmName);
898 bool lp_parameter_is_global(const char *pszParmName);
899 bool lp_canonicalize_parameter(const char *parm_name, const char **canon_parm,
901 bool lp_canonicalize_parameter_with_value(const char *parm_name,
903 const char **canon_parm,
904 const char **canon_val);
905 void show_parameter_list(void);
906 bool lp_invert_boolean(const char *str, const char **inverse_str);
907 bool lp_canonicalize_boolean(const char *str, const char**canon_str);
908 bool process_registry_service(const char *service_name);
909 bool process_registry_shares(void);
910 bool lp_config_backend_is_registry(void);
911 bool lp_config_backend_is_file(void);
912 bool lp_file_list_changed(void);
913 const char *lp_ldap_machine_suffix(TALLOC_CTX *ctx);
914 const char *lp_ldap_user_suffix(TALLOC_CTX *ctx);
915 const char *lp_ldap_group_suffix(TALLOC_CTX *ctx);
916 const char *lp_ldap_idmap_suffix(TALLOC_CTX *ctx);
918 /* Return a pointer to a service by name. */
919 struct loadparm_service *lp_service(const char *pszServiceName);
920 struct loadparm_service *lp_servicebynum(int snum);
921 struct loadparm_service *lp_default_loadparm_service(void);
922 void *lp_parm_ptr(struct loadparm_service *service, struct parm_struct *parm);
923 void *lp_local_ptr_by_snum(int snum, struct parm_struct *parm);
924 bool lp_do_parameter(int snum, const char *pszParmName, const char *pszParmValue);
925 bool lp_set_cmdline(const char *pszParmName, const char *pszParmValue);
926 bool dump_a_parameter(int snum, char *parm_name, FILE * f, bool isGlobal);
927 bool lp_snum_ok(int iService);
928 void lp_add_one_printer(const char *name, const char *comment,
929 const char *location, void *pdata);
930 bool lp_loaded(void);
931 void lp_killunused(struct smbd_server_connection *sconn,
932 bool (*snumused) (struct smbd_server_connection *, int));
933 void lp_kill_all_services(void);
934 void lp_killservice(int iServiceIn);
935 const char* server_role_str(uint32_t role);
936 enum usershare_err parse_usershare_file(TALLOC_CTX *ctx,
937 SMB_STRUCT_STAT *psbuf,
938 const char *servicename,
944 char **pp_cp_share_name,
945 struct security_descriptor **ppsd,
947 int load_usershare_service(const char *servicename);
948 int load_usershare_shares(struct smbd_server_connection *sconn,
949 bool (*snumused) (struct smbd_server_connection *, int));
950 void gfree_loadparm(void);
951 bool lp_load_initial_only(const char *pszFname);
952 bool lp_load_global(const char *file_name);
953 bool lp_load_with_shares(const char *file_name);
954 bool lp_load_client(const char *file_name);
955 bool lp_load_global_no_reinit(const char *file_name);
956 bool lp_load_no_reinit(const char *file_name);
957 bool lp_load_client_no_reinit(const char *file_name);
958 bool lp_load_with_registry_shares(const char *pszFname);
959 int lp_numservices(void);
960 void lp_dump(FILE *f, bool show_defaults, int maxtoprint);
961 void lp_dump_one(FILE * f, bool show_defaults, int snum);
962 int lp_servicenumber(const char *pszServiceName);
963 const char *volume_label(TALLOC_CTX *ctx, int snum);
964 bool lp_domain_master(void);
965 bool lp_preferred_master(void);
966 void lp_remove_service(int snum);
967 void lp_copy_service(int snum, const char *new_name);
968 int lp_default_server_announce(void);
969 const char *lp_printername(TALLOC_CTX *ctx, int snum);
970 void lp_set_logfile(const char *name);
971 int lp_maxprintjobs(int snum);
972 const char *lp_printcapname(void);
973 bool lp_disable_spoolss( void );
974 void lp_set_spoolss_state( uint32_t state );
975 uint32_t lp_get_spoolss_state( void );
976 struct smb_signing_state;
977 bool lp_use_sendfile(int snum, struct smb_signing_state *signing_state);
978 void set_use_sendfile(int snum, bool val);
979 void lp_set_mangling_method(const char *new_method);
980 bool lp_posix_pathnames(void);
981 void lp_set_posix_pathnames(void);
982 enum brl_flavour lp_posix_cifsu_locktype(files_struct *fsp);
983 void lp_set_posix_default_cifsx_readwrite_locktype(enum brl_flavour val);
984 int lp_min_receive_file_size(void);
985 char* lp_perfcount_module(TALLOC_CTX *ctx);
986 void widelinks_warning(int snum);
987 const char *lp_ncalrpc_dir(void);
988 void _lp_set_server_role(int server_role);
990 /* The following definitions come from param/loadparm_ctx.c */
992 const struct loadparm_s3_helpers *loadparm_s3_helpers(void);
994 /* The following definitions come from param/loadparm_server_role.c */
996 int lp_server_role(void);
997 void set_server_role(void);
999 /* The following definitions come from param/util.c */
1001 uint32_t get_int_param( const char* param );
1002 char* get_string_param( const char* param );
1004 /* The following definitions come from lib/server_contexts.c */
1005 struct tevent_context *server_event_context(void);
1006 void server_event_context_free(void);
1007 struct messaging_context *server_messaging_context(void);
1008 void server_messaging_context_free(void);
1010 /* The following definitions come from lib/sessionid_tdb.c */
1012 NTSTATUS sessionid_traverse_read(int (*fn)(const char *key,
1013 struct sessionid *session,
1014 void *private_data),
1015 void *private_data);
1017 /* The following definitions come from utils/passwd_util.c */
1019 char *stdin_new_passwd( void);
1020 char *get_pass( const char *prompt, bool stdin_get);
1022 /* The following definitions come from lib/avahi.c */
1024 struct AvahiPoll *tevent_avahi_poll(TALLOC_CTX *mem_ctx,
1025 struct tevent_context *ev);
1027 /* The following definitions come from libsmb/smbsock_connect.c */
1029 struct tevent_req *smbsock_connect_send(TALLOC_CTX *mem_ctx,
1030 struct tevent_context *ev,
1031 const struct sockaddr_storage *addr,
1033 const char *called_name,
1035 const char *calling_name,
1037 NTSTATUS smbsock_connect_recv(struct tevent_req *req, int *sock,
1038 uint16_t *ret_port);
1039 NTSTATUS smbsock_connect(const struct sockaddr_storage *addr, uint16_t port,
1040 const char *called_name, int called_type,
1041 const char *calling_name, int calling_type,
1042 int *pfd, uint16_t *ret_port, int sec_timeout);
1044 struct tevent_req *smbsock_any_connect_send(TALLOC_CTX *mem_ctx,
1045 struct tevent_context *ev,
1046 const struct sockaddr_storage *addrs,
1047 const char **called_names,
1049 const char **calling_names,
1051 size_t num_addrs, uint16_t port);
1052 NTSTATUS smbsock_any_connect_recv(struct tevent_req *req, int *pfd,
1053 size_t *chosen_index, uint16_t *chosen_port);
1054 NTSTATUS smbsock_any_connect(const struct sockaddr_storage *addrs,
1055 const char **called_names,
1057 const char **calling_names,
1062 int *pfd, size_t *chosen_index,
1063 uint16_t *chosen_port);
1065 /* The following definitions come from lib/util_wellknown.c */
1067 bool sid_check_is_wellknown_domain(const struct dom_sid *sid, const char **name);
1068 bool sid_check_is_in_wellknown_domain(const struct dom_sid *sid);
1069 bool lookup_wellknown_sid(TALLOC_CTX *mem_ctx, const struct dom_sid *sid,
1070 const char **domain, const char **name);
1071 bool lookup_wellknown_name(TALLOC_CTX *mem_ctx, const char *name,
1072 struct dom_sid *sid, const char **domain);
1074 /* The following definitions come from lib/util_specialsids.c */
1075 bool sid_check_is_asserted_identity(const struct dom_sid *sid);
1076 bool sid_check_is_in_asserted_identity(const struct dom_sid *sid);
1077 const char *asserted_identity_domain_name(void);
1079 /* The following definitions come from lib/filename_util.c */
1081 NTSTATUS get_full_smb_filename(TALLOC_CTX *ctx, const struct smb_filename *smb_fname,
1083 struct smb_filename *synthetic_smb_fname(TALLOC_CTX *mem_ctx,
1084 const char *base_name,
1085 const char *stream_name,
1086 const SMB_STRUCT_STAT *psbuf,
1088 struct smb_filename *synthetic_smb_fname_split(TALLOC_CTX *ctx,
1091 const char *smb_fname_str_dbg(const struct smb_filename *smb_fname);
1092 const char *fsp_str_dbg(const struct files_struct *fsp);
1093 const char *fsp_fnum_dbg(const struct files_struct *fsp);
1094 struct smb_filename *cp_smb_filename(TALLOC_CTX *mem_ctx,
1095 const struct smb_filename *in);
1096 struct smb_filename *cp_smb_filename_nostream(TALLOC_CTX *mem_ctx,
1097 const struct smb_filename *in);
1098 bool is_ntfs_stream_smb_fname(const struct smb_filename *smb_fname);
1099 bool is_ntfs_default_stream_smb_fname(const struct smb_filename *smb_fname);
1100 bool is_invalid_windows_ea_name(const char *name);
1101 bool ea_list_has_invalid_name(struct ea_list *ea_list);
1102 bool split_stream_filename(TALLOC_CTX *ctx,
1103 const char *filename_in,
1104 char **filename_out,
1105 char **streamname_out);
1107 /* The following definitions come from lib/dummyroot.c */
1109 void become_root(void);
1110 void unbecome_root(void);
1112 /* The following definitions come from lib/smbd_shim.c */
1114 int find_service(TALLOC_CTX *ctx, const char *service_in, char **p_service_out);
1115 void cancel_pending_lock_requests_by_fid(files_struct *fsp,
1116 struct byte_range_lock *br_lck,
1117 enum file_close_type close_type);
1118 void send_stat_cache_delete_message(struct messaging_context *msg_ctx,
1120 NTSTATUS can_delete_directory_fsp(files_struct *fsp);
1121 bool change_to_root_user(void);
1122 bool become_authenticated_pipe_user(struct auth_session_info *session_info);
1123 bool unbecome_authenticated_pipe_user(void);
1125 void contend_level2_oplocks_begin(files_struct *fsp,
1126 enum level2_contention_type type);
1127 void contend_level2_oplocks_end(files_struct *fsp,
1128 enum level2_contention_type type);
1130 #endif /* _PROTO_H_ */