2 Unix SMB/CIFS implementation.
3 Samba utility functions
4 Copyright (C) Andrew Tridgell 1992-1998
5 Copyright (C) Jeremy Allison 2001-2007
6 Copyright (C) Simo Sorce 2001
7 Copyright (C) Jim McDonough <jmcd@us.ibm.com> 2003
8 Copyright (C) James Peach 2006
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation; either version 3 of the License, or
13 (at your option) any later version.
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with this program. If not, see <http://www.gnu.org/licenses/>.
26 extern char *global_clobber_region_function
;
27 extern unsigned int global_clobber_region_line
;
29 /* Max allowable allococation - 256mb - 0x10000000 */
30 #define MAX_ALLOC_SIZE (1024*1024*256)
32 #if (defined(HAVE_NETGROUP) && defined (WITH_AUTOMOUNT))
33 #ifdef WITH_NISPLUS_HOME
34 #ifdef BROKEN_NISPLUS_INCLUDE_FILES
36 * The following lines are needed due to buggy include files
37 * in Solaris 2.6 which define GROUP in both /usr/include/sys/acl.h and
38 * also in /usr/include/rpcsvc/nis.h. The definitions conflict. JRA.
39 * Also GROUP_OBJ is defined as 0x4 in /usr/include/sys/acl.h and as
40 * an enum in /usr/include/rpcsvc/nis.h.
47 #if defined(GROUP_OBJ)
51 #endif /* BROKEN_NISPLUS_INCLUDE_FILES */
53 #include <rpcsvc/nis.h>
55 #endif /* WITH_NISPLUS_HOME */
56 #endif /* HAVE_NETGROUP && WITH_AUTOMOUNT */
58 enum protocol_types Protocol
= PROTOCOL_COREPLUS
;
60 static enum remote_arch_types ra_type
= RA_UNKNOWN
;
62 /***********************************************************************
63 Definitions for all names.
64 ***********************************************************************/
66 static char *smb_myname
;
67 static char *smb_myworkgroup
;
68 static char *smb_scope
;
69 static int smb_num_netbios_names
;
70 static char **smb_my_netbios_names
;
72 /***********************************************************************
73 Allocate and set myname. Ensure upper case.
74 ***********************************************************************/
76 bool set_global_myname(const char *myname
)
78 SAFE_FREE(smb_myname
);
79 smb_myname
= SMB_STRDUP(myname
);
82 strupper_m(smb_myname
);
86 const char *global_myname(void)
91 /***********************************************************************
92 Allocate and set myworkgroup. Ensure upper case.
93 ***********************************************************************/
95 bool set_global_myworkgroup(const char *myworkgroup
)
97 SAFE_FREE(smb_myworkgroup
);
98 smb_myworkgroup
= SMB_STRDUP(myworkgroup
);
101 strupper_m(smb_myworkgroup
);
105 const char *lp_workgroup(void)
107 return smb_myworkgroup
;
110 /***********************************************************************
111 Allocate and set scope. Ensure upper case.
112 ***********************************************************************/
114 bool set_global_scope(const char *scope
)
116 SAFE_FREE(smb_scope
);
117 smb_scope
= SMB_STRDUP(scope
);
120 strupper_m(smb_scope
);
124 /*********************************************************************
125 Ensure scope is never null string.
126 *********************************************************************/
128 const char *global_scope(void)
131 set_global_scope("");
135 static void free_netbios_names_array(void)
139 for (i
= 0; i
< smb_num_netbios_names
; i
++)
140 SAFE_FREE(smb_my_netbios_names
[i
]);
142 SAFE_FREE(smb_my_netbios_names
);
143 smb_num_netbios_names
= 0;
146 static bool allocate_my_netbios_names_array(size_t number
)
148 free_netbios_names_array();
150 smb_num_netbios_names
= number
+ 1;
151 smb_my_netbios_names
= SMB_MALLOC_ARRAY( char *, smb_num_netbios_names
);
153 if (!smb_my_netbios_names
)
156 memset(smb_my_netbios_names
, '\0', sizeof(char *) * smb_num_netbios_names
);
160 static bool set_my_netbios_names(const char *name
, int i
)
162 SAFE_FREE(smb_my_netbios_names
[i
]);
164 smb_my_netbios_names
[i
] = SMB_STRDUP(name
);
165 if (!smb_my_netbios_names
[i
])
167 strupper_m(smb_my_netbios_names
[i
]);
171 /***********************************************************************
172 Free memory allocated to global objects
173 ***********************************************************************/
175 void gfree_names(void)
177 SAFE_FREE( smb_myname
);
178 SAFE_FREE( smb_myworkgroup
);
179 SAFE_FREE( smb_scope
);
180 free_netbios_names_array();
181 free_local_machine_name();
184 void gfree_all( void )
194 const char *my_netbios_names(int i
)
196 return smb_my_netbios_names
[i
];
199 bool set_netbios_aliases(const char **str_array
)
203 /* Work out the max number of netbios aliases that we have */
204 for( namecount
=0; str_array
&& (str_array
[namecount
] != NULL
); namecount
++ )
207 if ( global_myname() && *global_myname())
210 /* Allocate space for the netbios aliases */
211 if (!allocate_my_netbios_names_array(namecount
))
214 /* Use the global_myname string first */
216 if ( global_myname() && *global_myname()) {
217 set_my_netbios_names( global_myname(), namecount
);
223 for ( i
= 0; str_array
[i
] != NULL
; i
++) {
225 bool duplicate
= False
;
227 /* Look for duplicates */
228 for( n
=0; n
<namecount
; n
++ ) {
229 if( strequal( str_array
[i
], my_netbios_names(n
) ) ) {
235 if (!set_my_netbios_names(str_array
[i
], namecount
))
244 /****************************************************************************
245 Common name initialization code.
246 ****************************************************************************/
248 bool init_names(void)
252 if (global_myname() == NULL
|| *global_myname() == '\0') {
253 if (!set_global_myname(myhostname())) {
254 DEBUG( 0, ( "init_structs: malloc fail.\n" ) );
259 if (!set_netbios_aliases(lp_netbios_aliases())) {
260 DEBUG( 0, ( "init_structs: malloc fail.\n" ) );
264 set_local_machine_name(global_myname(),false);
266 DEBUG( 5, ("Netbios name list:-\n") );
267 for( n
=0; my_netbios_names(n
); n
++ ) {
268 DEBUGADD( 5, ("my_netbios_names[%d]=\"%s\"\n",
269 n
, my_netbios_names(n
) ) );
275 /**************************************************************************n
276 Code to cope with username/password auth options from the commandline.
277 Used mainly in client tools.
278 ****************************************************************************/
280 struct user_auth_info
*user_auth_info_init(TALLOC_CTX
*mem_ctx
)
282 struct user_auth_info
*result
;
284 result
= TALLOC_ZERO_P(mem_ctx
, struct user_auth_info
);
285 if (result
== NULL
) {
289 result
->signing_state
= Undefined
;
293 const char *get_cmdline_auth_info_username(const struct user_auth_info
*auth_info
)
295 if (!auth_info
->username
) {
298 return auth_info
->username
;
301 void set_cmdline_auth_info_username(struct user_auth_info
*auth_info
,
302 const char *username
)
304 TALLOC_FREE(auth_info
->username
);
305 auth_info
->username
= talloc_strdup(auth_info
, username
);
306 if (!auth_info
->username
) {
311 const char *get_cmdline_auth_info_domain(const struct user_auth_info
*auth_info
)
313 if (!auth_info
->domain
) {
316 return auth_info
->domain
;
319 void set_cmdline_auth_info_domain(struct user_auth_info
*auth_info
,
322 TALLOC_FREE(auth_info
->domain
);
323 auth_info
->domain
= talloc_strdup(auth_info
, domain
);
324 if (!auth_info
->domain
) {
329 const char *get_cmdline_auth_info_password(const struct user_auth_info
*auth_info
)
331 if (!auth_info
->password
) {
334 return auth_info
->password
;
337 void set_cmdline_auth_info_password(struct user_auth_info
*auth_info
,
338 const char *password
)
340 TALLOC_FREE(auth_info
->password
);
341 if (password
== NULL
) {
344 auth_info
->password
= talloc_strdup(auth_info
, password
);
345 if (!auth_info
->password
) {
348 auth_info
->got_pass
= true;
351 bool set_cmdline_auth_info_signing_state(struct user_auth_info
*auth_info
,
354 auth_info
->signing_state
= -1;
355 if (strequal(arg
, "off") || strequal(arg
, "no") ||
356 strequal(arg
, "false")) {
357 auth_info
->signing_state
= false;
358 } else if (strequal(arg
, "on") || strequal(arg
, "yes") ||
359 strequal(arg
, "true") || strequal(arg
, "auto")) {
360 auth_info
->signing_state
= true;
361 } else if (strequal(arg
, "force") || strequal(arg
, "required") ||
362 strequal(arg
, "forced")) {
363 auth_info
->signing_state
= Required
;
370 int get_cmdline_auth_info_signing_state(const struct user_auth_info
*auth_info
)
372 return auth_info
->signing_state
;
375 void set_cmdline_auth_info_use_kerberos(struct user_auth_info
*auth_info
,
378 auth_info
->use_kerberos
= b
;
381 bool get_cmdline_auth_info_use_kerberos(const struct user_auth_info
*auth_info
)
383 return auth_info
->use_kerberos
;
386 void set_cmdline_auth_info_fallback_after_kerberos(struct user_auth_info
*auth_info
,
389 auth_info
->fallback_after_kerberos
= b
;
392 bool get_cmdline_auth_info_fallback_after_kerberos(const struct user_auth_info
*auth_info
)
394 return auth_info
->fallback_after_kerberos
;
397 /* This should only be used by lib/popt_common.c JRA */
398 void set_cmdline_auth_info_use_krb5_ticket(struct user_auth_info
*auth_info
)
400 auth_info
->use_kerberos
= true;
401 auth_info
->got_pass
= true;
404 /* This should only be used by lib/popt_common.c JRA */
405 void set_cmdline_auth_info_smb_encrypt(struct user_auth_info
*auth_info
)
407 auth_info
->smb_encrypt
= true;
410 void set_cmdline_auth_info_use_machine_account(struct user_auth_info
*auth_info
)
412 auth_info
->use_machine_account
= true;
415 bool get_cmdline_auth_info_got_pass(const struct user_auth_info
*auth_info
)
417 return auth_info
->got_pass
;
420 bool get_cmdline_auth_info_smb_encrypt(const struct user_auth_info
*auth_info
)
422 return auth_info
->smb_encrypt
;
425 bool get_cmdline_auth_info_use_machine_account(const struct user_auth_info
*auth_info
)
427 return auth_info
->use_machine_account
;
430 struct user_auth_info
*get_cmdline_auth_info_copy(TALLOC_CTX
*mem_ctx
,
431 const struct user_auth_info
*src
)
433 struct user_auth_info
*result
;
435 result
= user_auth_info_init(mem_ctx
);
436 if (result
== NULL
) {
442 result
->username
= talloc_strdup(
443 result
, get_cmdline_auth_info_username(src
));
444 result
->password
= talloc_strdup(
445 result
, get_cmdline_auth_info_password(src
));
446 if ((result
->username
== NULL
) || (result
->password
== NULL
)) {
454 bool set_cmdline_auth_info_machine_account_creds(struct user_auth_info
*auth_info
)
457 char *account
= NULL
;
459 if (!get_cmdline_auth_info_use_machine_account(auth_info
)) {
463 if (!secrets_init()) {
464 d_printf("ERROR: Unable to open secrets database\n");
468 if (asprintf(&account
, "%s$@%s", global_myname(), lp_realm()) < 0) {
472 pass
= secrets_fetch_machine_password(lp_workgroup(), NULL
, NULL
);
474 d_printf("ERROR: Unable to fetch machine password for "
476 account
, lp_workgroup());
481 set_cmdline_auth_info_username(auth_info
, account
);
482 set_cmdline_auth_info_password(auth_info
, pass
);
490 /****************************************************************************
491 Ensure we have a password if one not given.
492 ****************************************************************************/
494 void set_cmdline_auth_info_getpass(struct user_auth_info
*auth_info
)
500 if (get_cmdline_auth_info_got_pass(auth_info
) ||
501 get_cmdline_auth_info_use_kerberos(auth_info
)) {
502 /* Already got one... */
506 frame
= talloc_stackframe();
507 label
= talloc_asprintf(frame
, "Enter %s's password: ",
508 get_cmdline_auth_info_username(auth_info
));
509 pass
= getpass(label
);
511 set_cmdline_auth_info_password(auth_info
, pass
);
516 /*******************************************************************
517 Check if a file exists - call vfs_file_exist for samba files.
518 ********************************************************************/
520 bool file_exist_stat(const char *fname
,SMB_STRUCT_STAT
*sbuf
)
526 if (sys_stat(fname
,sbuf
) != 0)
529 return((S_ISREG(sbuf
->st_ex_mode
)) || (S_ISFIFO(sbuf
->st_ex_mode
)));
532 /*******************************************************************
533 Check if a unix domain socket exists - call vfs_file_exist for samba files.
534 ********************************************************************/
536 bool socket_exist(const char *fname
)
539 if (sys_stat(fname
,&st
) != 0)
542 return S_ISSOCK(st
.st_ex_mode
);
545 /*******************************************************************
546 Check if a directory exists.
547 ********************************************************************/
549 bool directory_exist_stat(char *dname
,SMB_STRUCT_STAT
*st
)
557 if (sys_stat(dname
,st
) != 0)
560 ret
= S_ISDIR(st
->st_ex_mode
);
566 /*******************************************************************
567 Returns the size in bytes of the named given the stat struct.
568 ********************************************************************/
570 uint64_t get_file_size_stat(const SMB_STRUCT_STAT
*sbuf
)
572 return sbuf
->st_ex_size
;
575 /*******************************************************************
576 Returns the size in bytes of the named file.
577 ********************************************************************/
579 SMB_OFF_T
get_file_size(char *file_name
)
583 if(sys_stat(file_name
,&buf
) != 0)
584 return (SMB_OFF_T
)-1;
585 return get_file_size_stat(&buf
);
588 /*******************************************************************
589 Return a string representing an attribute for a file.
590 ********************************************************************/
592 char *attrib_string(uint16 mode
)
598 if (mode
& aVOLID
) fstrcat(attrstr
,"V");
599 if (mode
& aDIR
) fstrcat(attrstr
,"D");
600 if (mode
& aARCH
) fstrcat(attrstr
,"A");
601 if (mode
& aHIDDEN
) fstrcat(attrstr
,"H");
602 if (mode
& aSYSTEM
) fstrcat(attrstr
,"S");
603 if (mode
& aRONLY
) fstrcat(attrstr
,"R");
605 return talloc_strdup(talloc_tos(), attrstr
);
608 /*******************************************************************
609 Show a smb message structure.
610 ********************************************************************/
612 void show_msg(char *buf
)
620 DEBUG(5,("size=%d\nsmb_com=0x%x\nsmb_rcls=%d\nsmb_reh=%d\nsmb_err=%d\nsmb_flg=%d\nsmb_flg2=%d\n",
622 (int)CVAL(buf
,smb_com
),
623 (int)CVAL(buf
,smb_rcls
),
624 (int)CVAL(buf
,smb_reh
),
625 (int)SVAL(buf
,smb_err
),
626 (int)CVAL(buf
,smb_flg
),
627 (int)SVAL(buf
,smb_flg2
)));
628 DEBUGADD(5,("smb_tid=%d\nsmb_pid=%d\nsmb_uid=%d\nsmb_mid=%d\n",
629 (int)SVAL(buf
,smb_tid
),
630 (int)SVAL(buf
,smb_pid
),
631 (int)SVAL(buf
,smb_uid
),
632 (int)SVAL(buf
,smb_mid
)));
633 DEBUGADD(5,("smt_wct=%d\n",(int)CVAL(buf
,smb_wct
)));
635 for (i
=0;i
<(int)CVAL(buf
,smb_wct
);i
++)
636 DEBUGADD(5,("smb_vwv[%2d]=%5d (0x%X)\n",i
,
637 SVAL(buf
,smb_vwv
+2*i
),SVAL(buf
,smb_vwv
+2*i
)));
639 bcc
= (int)SVAL(buf
,smb_vwv
+2*(CVAL(buf
,smb_wct
)));
641 DEBUGADD(5,("smb_bcc=%d\n",bcc
));
649 dump_data(10, (uint8
*)smb_buf(buf
), bcc
);
652 /*******************************************************************
653 Set the length and marker of an encrypted smb packet.
654 ********************************************************************/
656 void smb_set_enclen(char *buf
,int len
,uint16 enc_ctx_num
)
658 _smb_setlen(buf
,len
);
662 SSVAL(buf
,6,enc_ctx_num
);
665 /*******************************************************************
666 Set the length and marker of an smb packet.
667 ********************************************************************/
669 void smb_setlen(char *buf
,int len
)
671 _smb_setlen(buf
,len
);
679 /*******************************************************************
680 Setup only the byte count for a smb message.
681 ********************************************************************/
683 int set_message_bcc(char *buf
,int num_bytes
)
685 int num_words
= CVAL(buf
,smb_wct
);
686 SSVAL(buf
,smb_vwv
+ num_words
*SIZEOFWORD
,num_bytes
);
687 _smb_setlen(buf
,smb_size
+ num_words
*2 + num_bytes
- 4);
688 return (smb_size
+ num_words
*2 + num_bytes
);
691 /*******************************************************************
692 Add a data blob to the end of a smb_buf, adjusting bcc and smb_len.
693 Return the bytes added
694 ********************************************************************/
696 ssize_t
message_push_blob(uint8
**outbuf
, DATA_BLOB blob
)
698 size_t newlen
= smb_len(*outbuf
) + 4 + blob
.length
;
701 if (!(tmp
= TALLOC_REALLOC_ARRAY(NULL
, *outbuf
, uint8
, newlen
))) {
702 DEBUG(0, ("talloc failed\n"));
707 memcpy(tmp
+ smb_len(tmp
) + 4, blob
.data
, blob
.length
);
708 set_message_bcc((char *)tmp
, smb_buflen(tmp
) + blob
.length
);
712 /*******************************************************************
713 Reduce a file name, removing .. elements.
714 ********************************************************************/
716 static char *dos_clean_name(TALLOC_CTX
*ctx
, const char *s
)
721 DEBUG(3,("dos_clean_name [%s]\n",s
));
723 /* remove any double slashes */
724 str
= talloc_all_string_sub(ctx
, s
, "\\\\", "\\");
729 /* Remove leading .\\ characters */
730 if(strncmp(str
, ".\\", 2) == 0) {
731 trim_string(str
, ".\\", NULL
);
733 str
= talloc_strdup(ctx
, ".\\");
740 while ((p
= strstr_m(str
,"\\..\\")) != NULL
) {
746 if ((p
=strrchr_m(str
,'\\')) != NULL
) {
751 str
= talloc_asprintf(ctx
,
760 trim_string(str
,NULL
,"\\..");
761 return talloc_all_string_sub(ctx
, str
, "\\.\\", "\\");
764 /*******************************************************************
765 Reduce a file name, removing .. elements.
766 ********************************************************************/
768 char *unix_clean_name(TALLOC_CTX
*ctx
, const char *s
)
773 DEBUG(3,("unix_clean_name [%s]\n",s
));
775 /* remove any double slashes */
776 str
= talloc_all_string_sub(ctx
, s
, "//","/");
781 /* Remove leading ./ characters */
782 if(strncmp(str
, "./", 2) == 0) {
783 trim_string(str
, "./", NULL
);
785 str
= talloc_strdup(ctx
, "./");
792 while ((p
= strstr_m(str
,"/../")) != NULL
) {
798 if ((p
=strrchr_m(str
,'/')) != NULL
) {
803 str
= talloc_asprintf(ctx
,
812 trim_string(str
,NULL
,"/..");
813 return talloc_all_string_sub(ctx
, str
, "/./", "/");
816 char *clean_name(TALLOC_CTX
*ctx
, const char *s
)
818 char *str
= dos_clean_name(ctx
, s
);
822 return unix_clean_name(ctx
, str
);
825 /*******************************************************************
826 Write data into an fd at a given offset. Ignore seek errors.
827 ********************************************************************/
829 ssize_t
write_data_at_offset(int fd
, const char *buffer
, size_t N
, SMB_OFF_T pos
)
834 if (pos
== (SMB_OFF_T
)-1) {
835 return write_data(fd
, buffer
, N
);
837 #if defined(HAVE_PWRITE) || defined(HAVE_PRWITE64)
839 ret
= sys_pwrite(fd
,buffer
+ total
,N
- total
, pos
);
840 if (ret
== -1 && errno
== ESPIPE
) {
841 return write_data(fd
, buffer
+ total
,N
- total
);
844 DEBUG(0,("write_data_at_offset: write failure. Error = %s\n", strerror(errno
) ));
853 return (ssize_t
)total
;
855 /* Use lseek and write_data. */
856 if (sys_lseek(fd
, pos
, SEEK_SET
) == -1) {
857 if (errno
!= ESPIPE
) {
861 return write_data(fd
, buffer
, N
);
865 /*******************************************************************
866 Sleep for a specified number of milliseconds.
867 ********************************************************************/
869 void smb_msleep(unsigned int t
)
871 #if defined(HAVE_NANOSLEEP)
872 struct timespec tval
;
875 tval
.tv_sec
= t
/1000;
876 tval
.tv_nsec
= 1000000*(t
%1000);
880 ret
= nanosleep(&tval
, &tval
);
881 } while (ret
< 0 && errno
== EINTR
&& (tval
.tv_sec
> 0 || tval
.tv_nsec
> 0));
883 unsigned int tdiff
=0;
884 struct timeval tval
,t1
,t2
;
891 tval
.tv_sec
= (t
-tdiff
)/1000;
892 tval
.tv_usec
= 1000*((t
-tdiff
)%1000);
894 /* Never wait for more than 1 sec. */
895 if (tval
.tv_sec
> 1) {
902 sys_select_intr(0,&fds
,NULL
,NULL
,&tval
);
905 if (t2
.tv_sec
< t1
.tv_sec
) {
906 /* Someone adjusted time... */
910 tdiff
= TvalDiff(&t1
,&t2
);
915 NTSTATUS
reinit_after_fork(struct messaging_context
*msg_ctx
,
916 struct event_context
*ev_ctx
,
917 bool parent_longlived
)
919 NTSTATUS status
= NT_STATUS_OK
;
921 /* Reset the state of the random
922 * number generation system, so
923 * children do not get the same random
924 * numbers as each other */
925 set_need_random_reseed();
927 /* tdb needs special fork handling */
928 if (tdb_reopen_all(parent_longlived
? 1 : 0) == -1) {
929 DEBUG(0,("tdb_reopen_all failed.\n"));
930 status
= NT_STATUS_OPEN_FAILED
;
935 event_context_reinit(ev_ctx
);
940 * For clustering, we need to re-init our ctdbd connection after the
943 status
= messaging_reinit(msg_ctx
);
944 if (!NT_STATUS_IS_OK(status
)) {
945 DEBUG(0,("messaging_reinit() failed: %s\n",
953 /****************************************************************************
954 Put up a yes/no prompt.
955 ****************************************************************************/
957 bool yesno(const char *p
)
962 if (!fgets(ans
,sizeof(ans
)-1,stdin
))
965 if (*ans
== 'y' || *ans
== 'Y')
971 #if defined(PARANOID_MALLOC_CHECKER)
973 /****************************************************************************
974 Internal malloc wrapper. Externally visible.
975 ****************************************************************************/
977 void *malloc_(size_t size
)
984 #define malloc(s) __ERROR_DONT_USE_MALLOC_DIRECTLY
987 /****************************************************************************
988 Internal calloc wrapper. Not externally visible.
989 ****************************************************************************/
991 static void *calloc_(size_t count
, size_t size
)
993 if (size
== 0 || count
== 0) {
997 return calloc(count
, size
);
998 #define calloc(n,s) __ERROR_DONT_USE_CALLOC_DIRECTLY
1001 /****************************************************************************
1002 Internal realloc wrapper. Not externally visible.
1003 ****************************************************************************/
1005 static void *realloc_(void *ptr
, size_t size
)
1008 return realloc(ptr
, size
);
1009 #define realloc(p,s) __ERROR_DONT_USE_RELLOC_DIRECTLY
1012 #endif /* PARANOID_MALLOC_CHECKER */
1014 /****************************************************************************
1016 ****************************************************************************/
1018 void *memalign_array(size_t el_size
, size_t align
, unsigned int count
)
1020 if (count
>= MAX_ALLOC_SIZE
/el_size
) {
1024 return sys_memalign(align
, el_size
*count
);
1027 /****************************************************************************
1029 ****************************************************************************/
1031 void *calloc_array(size_t size
, size_t nmemb
)
1033 if (nmemb
>= MAX_ALLOC_SIZE
/size
) {
1036 if (size
== 0 || nmemb
== 0) {
1039 #if defined(PARANOID_MALLOC_CHECKER)
1040 return calloc_(nmemb
, size
);
1042 return calloc(nmemb
, size
);
1046 /****************************************************************************
1047 Expand a pointer to be a particular size.
1048 Note that this version of Realloc has an extra parameter that decides
1049 whether to free the passed in storage on allocation failure or if the
1052 This is designed for use in the typical idiom of :
1054 p = SMB_REALLOC(p, size)
1059 and not to have to keep track of the old 'p' contents to free later, nor
1060 to worry if the size parameter was zero. In the case where NULL is returned
1061 we guarentee that p has been freed.
1063 If free later semantics are desired, then pass 'free_old_on_error' as False which
1064 guarentees that the old contents are not freed on error, even if size == 0. To use
1067 tmp = SMB_REALLOC_KEEP_OLD_ON_ERROR(p, size);
1075 Changes were instigated by Coverity error checking. JRA.
1076 ****************************************************************************/
1078 void *Realloc(void *p
, size_t size
, bool free_old_on_error
)
1083 if (free_old_on_error
) {
1086 DEBUG(2,("Realloc asked for 0 bytes\n"));
1090 #if defined(PARANOID_MALLOC_CHECKER)
1092 ret
= (void *)malloc_(size
);
1094 ret
= (void *)realloc_(p
,size
);
1098 ret
= (void *)malloc(size
);
1100 ret
= (void *)realloc(p
,size
);
1105 if (free_old_on_error
&& p
) {
1108 DEBUG(0,("Memory allocation error: failed to expand to %d bytes\n",(int)size
));
1114 /****************************************************************************
1115 (Hopefully) efficient array append.
1116 ****************************************************************************/
1118 void add_to_large_array(TALLOC_CTX
*mem_ctx
, size_t element_size
,
1119 void *element
, void *_array
, uint32
*num_elements
,
1120 ssize_t
*array_size
)
1122 void **array
= (void **)_array
;
1124 if (*array_size
< 0) {
1128 if (*array
== NULL
) {
1129 if (*array_size
== 0) {
1133 if (*array_size
>= MAX_ALLOC_SIZE
/element_size
) {
1137 *array
= TALLOC(mem_ctx
, element_size
* (*array_size
));
1138 if (*array
== NULL
) {
1143 if (*num_elements
== *array_size
) {
1146 if (*array_size
>= MAX_ALLOC_SIZE
/element_size
) {
1150 *array
= TALLOC_REALLOC(mem_ctx
, *array
,
1151 element_size
* (*array_size
));
1153 if (*array
== NULL
) {
1158 memcpy((char *)(*array
) + element_size
*(*num_elements
),
1159 element
, element_size
);
1169 /****************************************************************************
1170 Get my own domain name, or "" if we have none.
1171 ****************************************************************************/
1173 char *get_mydnsdomname(TALLOC_CTX
*ctx
)
1175 const char *domname
;
1178 domname
= get_mydnsfullname();
1183 p
= strchr_m(domname
, '.');
1186 return talloc_strdup(ctx
, p
);
1188 return talloc_strdup(ctx
, "");
1192 /****************************************************************************
1193 Interpret a protocol description string, with a default.
1194 ****************************************************************************/
1196 int interpret_protocol(const char *str
,int def
)
1198 if (strequal(str
,"NT1"))
1199 return(PROTOCOL_NT1
);
1200 if (strequal(str
,"LANMAN2"))
1201 return(PROTOCOL_LANMAN2
);
1202 if (strequal(str
,"LANMAN1"))
1203 return(PROTOCOL_LANMAN1
);
1204 if (strequal(str
,"CORE"))
1205 return(PROTOCOL_CORE
);
1206 if (strequal(str
,"COREPLUS"))
1207 return(PROTOCOL_COREPLUS
);
1208 if (strequal(str
,"CORE+"))
1209 return(PROTOCOL_COREPLUS
);
1211 DEBUG(0,("Unrecognised protocol level %s\n",str
));
1217 #if (defined(HAVE_NETGROUP) && defined(WITH_AUTOMOUNT))
1218 /******************************************************************
1219 Remove any mount options such as -rsize=2048,wsize=2048 etc.
1220 Based on a fix from <Thomas.Hepper@icem.de>.
1221 Returns a malloc'ed string.
1222 *******************************************************************/
1224 static char *strip_mount_options(TALLOC_CTX
*ctx
, const char *str
)
1227 const char *p
= str
;
1228 while(*p
&& !isspace(*p
))
1230 while(*p
&& isspace(*p
))
1233 return talloc_strdup(ctx
, p
);
1239 /*******************************************************************
1240 Patch from jkf@soton.ac.uk
1241 Split Luke's automount_server into YP lookup and string splitter
1242 so can easily implement automount_path().
1243 Returns a malloc'ed string.
1244 *******************************************************************/
1246 #ifdef WITH_NISPLUS_HOME
1247 char *automount_lookup(TALLOC_CTX
*ctx
, const char *user_name
)
1251 char *nis_map
= (char *)lp_nis_home_map_name();
1253 char buffer
[NIS_MAXATTRVAL
+ 1];
1258 snprintf(buffer
, sizeof(buffer
), "[key=%s],%s", user_name
, nis_map
);
1259 DEBUG(5, ("NIS+ querystring: %s\n", buffer
));
1261 if (result
= nis_list(buffer
, FOLLOW_PATH
|EXPAND_NAME
|HARD_LOOKUP
, NULL
, NULL
)) {
1262 if (result
->status
!= NIS_SUCCESS
) {
1263 DEBUG(3, ("NIS+ query failed: %s\n", nis_sperrno(result
->status
)));
1265 object
= result
->objects
.objects_val
;
1266 if (object
->zo_data
.zo_type
== ENTRY_OBJ
) {
1267 entry
= &object
->zo_data
.objdata_u
.en_data
;
1268 DEBUG(5, ("NIS+ entry type: %s\n", entry
->en_type
));
1269 DEBUG(3, ("NIS+ result: %s\n", entry
->en_cols
.en_cols_val
[1].ec_value
.ec_value_val
));
1271 value
= talloc_strdup(ctx
,
1272 entry
->en_cols
.en_cols_val
[1].ec_value
.ec_value_val
);
1274 nis_freeresult(result
);
1277 value
= talloc_string_sub(ctx
,
1284 nis_freeresult(result
);
1287 value
= strip_mount_options(ctx
, value
);
1288 DEBUG(4, ("NIS+ Lookup: %s resulted in %s\n",
1293 #else /* WITH_NISPLUS_HOME */
1295 char *automount_lookup(TALLOC_CTX
*ctx
, const char *user_name
)
1299 int nis_error
; /* returned by yp all functions */
1300 char *nis_result
; /* yp_match inits this */
1301 int nis_result_len
; /* and set this */
1302 char *nis_domain
; /* yp_get_default_domain inits this */
1303 char *nis_map
= (char *)lp_nis_home_map_name();
1305 if ((nis_error
= yp_get_default_domain(&nis_domain
)) != 0) {
1306 DEBUG(3, ("YP Error: %s\n", yperr_string(nis_error
)));
1310 DEBUG(5, ("NIS Domain: %s\n", nis_domain
));
1312 if ((nis_error
= yp_match(nis_domain
, nis_map
, user_name
,
1313 strlen(user_name
), &nis_result
,
1314 &nis_result_len
)) == 0) {
1315 value
= talloc_strdup(ctx
, nis_result
);
1319 value
= strip_mount_options(ctx
, value
);
1320 } else if(nis_error
== YPERR_KEY
) {
1321 DEBUG(3, ("YP Key not found: while looking up \"%s\" in map \"%s\"\n",
1322 user_name
, nis_map
));
1323 DEBUG(3, ("using defaults for server and home directory\n"));
1325 DEBUG(3, ("YP Error: \"%s\" while looking up \"%s\" in map \"%s\"\n",
1326 yperr_string(nis_error
), user_name
, nis_map
));
1330 DEBUG(4, ("YP Lookup: %s resulted in %s\n", user_name
, value
));
1334 #endif /* WITH_NISPLUS_HOME */
1337 /****************************************************************************
1338 Check if a process exists. Does this work on all unixes?
1339 ****************************************************************************/
1341 bool process_exists(const struct server_id pid
)
1343 if (procid_is_me(&pid
)) {
1347 if (procid_is_local(&pid
)) {
1348 return (kill(pid
.pid
,0) == 0 || errno
!= ESRCH
);
1351 #ifdef CLUSTER_SUPPORT
1352 return ctdbd_process_exists(messaging_ctdbd_connection(), pid
.vnn
,
1359 /*******************************************************************
1360 Convert a uid into a user name.
1361 ********************************************************************/
1363 const char *uidtoname(uid_t uid
)
1365 TALLOC_CTX
*ctx
= talloc_tos();
1367 struct passwd
*pass
= NULL
;
1369 pass
= getpwuid_alloc(ctx
,uid
);
1371 name
= talloc_strdup(ctx
,pass
->pw_name
);
1374 name
= talloc_asprintf(ctx
,
1381 /*******************************************************************
1382 Convert a gid into a group name.
1383 ********************************************************************/
1385 char *gidtoname(gid_t gid
)
1389 grp
= getgrgid(gid
);
1391 return talloc_strdup(talloc_tos(), grp
->gr_name
);
1394 return talloc_asprintf(talloc_tos(),
1400 /*******************************************************************
1401 Convert a user name into a uid.
1402 ********************************************************************/
1404 uid_t
nametouid(const char *name
)
1406 struct passwd
*pass
;
1410 pass
= getpwnam_alloc(talloc_autofree_context(), name
);
1417 u
= (uid_t
)strtol(name
, &p
, 0);
1418 if ((p
!= name
) && (*p
== '\0'))
1424 /*******************************************************************
1425 Convert a name to a gid_t if possible. Return -1 if not a group.
1426 ********************************************************************/
1428 gid_t
nametogid(const char *name
)
1434 g
= (gid_t
)strtol(name
, &p
, 0);
1435 if ((p
!= name
) && (*p
== '\0'))
1438 grp
= sys_getgrnam(name
);
1440 return(grp
->gr_gid
);
1444 /*******************************************************************
1445 Something really nasty happened - panic !
1446 ********************************************************************/
1448 void smb_panic(const char *const why
)
1456 if (global_clobber_region_function
) {
1457 DEBUG(0,("smb_panic: clobber_region() last called from [%s(%u)]\n",
1458 global_clobber_region_function
,
1459 global_clobber_region_line
));
1464 DEBUG(0,("PANIC (pid %llu): %s\n",
1465 (unsigned long long)sys_getpid(), why
));
1468 cmd
= lp_panic_action();
1470 DEBUG(0, ("smb_panic(): calling panic action [%s]\n", cmd
));
1471 result
= system(cmd
);
1474 DEBUG(0, ("smb_panic(): fork failed in panic action: %s\n",
1477 DEBUG(0, ("smb_panic(): action returned status %d\n",
1478 WEXITSTATUS(result
)));
1484 /*******************************************************************
1485 Print a backtrace of the stack to the debug log. This function
1486 DELIBERATELY LEAKS MEMORY. The expectation is that you should
1487 exit shortly after calling it.
1488 ********************************************************************/
1490 #ifdef HAVE_LIBUNWIND_H
1491 #include <libunwind.h>
1494 #ifdef HAVE_EXECINFO_H
1495 #include <execinfo.h>
1498 #ifdef HAVE_LIBEXC_H
1502 void log_stack_trace(void)
1504 #ifdef HAVE_LIBUNWIND
1505 /* Try to use libunwind before any other technique since on ia64
1506 * libunwind correctly walks the stack in more circumstances than
1509 unw_cursor_t cursor
;
1514 unw_word_t ip
, sp
, off
;
1516 procname
[sizeof(procname
) - 1] = '\0';
1518 if (unw_getcontext(&uc
) != 0) {
1519 goto libunwind_failed
;
1522 if (unw_init_local(&cursor
, &uc
) != 0) {
1523 goto libunwind_failed
;
1526 DEBUG(0, ("BACKTRACE:\n"));
1530 unw_get_reg(&cursor
, UNW_REG_IP
, &ip
);
1531 unw_get_reg(&cursor
, UNW_REG_SP
, &sp
);
1533 switch (unw_get_proc_name(&cursor
,
1534 procname
, sizeof(procname
) - 1, &off
) ) {
1538 /* Name truncated. */
1539 DEBUGADD(0, (" #%u %s + %#llx [ip=%#llx] [sp=%#llx]\n",
1540 i
, procname
, (long long)off
,
1541 (long long)ip
, (long long) sp
));
1544 /* case -UNW_ENOINFO: */
1545 /* case -UNW_EUNSPEC: */
1546 /* No symbol name found. */
1547 DEBUGADD(0, (" #%u %s [ip=%#llx] [sp=%#llx]\n",
1548 i
, "<unknown symbol>",
1549 (long long)ip
, (long long) sp
));
1552 } while (unw_step(&cursor
) > 0);
1557 DEBUG(0, ("unable to produce a stack trace with libunwind\n"));
1559 #elif HAVE_BACKTRACE_SYMBOLS
1560 void *backtrace_stack
[BACKTRACE_STACK_SIZE
];
1561 size_t backtrace_size
;
1562 char **backtrace_strings
;
1564 /* get the backtrace (stack frames) */
1565 backtrace_size
= backtrace(backtrace_stack
,BACKTRACE_STACK_SIZE
);
1566 backtrace_strings
= backtrace_symbols(backtrace_stack
, backtrace_size
);
1568 DEBUG(0, ("BACKTRACE: %lu stack frames:\n",
1569 (unsigned long)backtrace_size
));
1571 if (backtrace_strings
) {
1574 for (i
= 0; i
< backtrace_size
; i
++)
1575 DEBUGADD(0, (" #%u %s\n", i
, backtrace_strings
[i
]));
1577 /* Leak the backtrace_strings, rather than risk what free() might do */
1582 /* The IRIX libexc library provides an API for unwinding the stack. See
1583 * libexc(3) for details. Apparantly trace_back_stack leaks memory, but
1584 * since we are about to abort anyway, it hardly matters.
1587 #define NAMESIZE 32 /* Arbitrary */
1589 __uint64_t addrs
[BACKTRACE_STACK_SIZE
];
1590 char * names
[BACKTRACE_STACK_SIZE
];
1591 char namebuf
[BACKTRACE_STACK_SIZE
* NAMESIZE
];
1598 ZERO_ARRAY(namebuf
);
1600 /* We need to be root so we can open our /proc entry to walk
1601 * our stack. It also helps when we want to dump core.
1605 for (i
= 0; i
< BACKTRACE_STACK_SIZE
; i
++) {
1606 names
[i
] = namebuf
+ (i
* NAMESIZE
);
1609 levels
= trace_back_stack(0, addrs
, names
,
1610 BACKTRACE_STACK_SIZE
, NAMESIZE
- 1);
1612 DEBUG(0, ("BACKTRACE: %d stack frames:\n", levels
));
1613 for (i
= 0; i
< levels
; i
++) {
1614 DEBUGADD(0, (" #%d 0x%llx %s\n", i
, addrs
[i
], names
[i
]));
1619 DEBUG(0, ("unable to produce a stack trace on this platform\n"));
1623 /*******************************************************************
1624 A readdir wrapper which just returns the file name.
1625 ********************************************************************/
1627 const char *readdirname(SMB_STRUCT_DIR
*p
)
1629 SMB_STRUCT_DIRENT
*ptr
;
1635 ptr
= (SMB_STRUCT_DIRENT
*)sys_readdir(p
);
1639 dname
= ptr
->d_name
;
1646 #ifdef HAVE_BROKEN_READDIR_NAME
1647 /* using /usr/ucb/cc is BAD */
1651 return talloc_strdup(talloc_tos(), dname
);
1654 /*******************************************************************
1655 Utility function used to decide if the last component
1656 of a path matches a (possibly wildcarded) entry in a namelist.
1657 ********************************************************************/
1659 bool is_in_path(const char *name
, name_compare_entry
*namelist
, bool case_sensitive
)
1661 const char *last_component
;
1663 /* if we have no list it's obviously not in the path */
1664 if((namelist
== NULL
) || ((namelist
!= NULL
) && (namelist
[0].name
== NULL
))) {
1668 DEBUG(8, ("is_in_path: %s\n", name
));
1670 /* Get the last component of the unix name. */
1671 last_component
= strrchr_m(name
, '/');
1672 if (!last_component
) {
1673 last_component
= name
;
1675 last_component
++; /* Go past '/' */
1678 for(; namelist
->name
!= NULL
; namelist
++) {
1679 if(namelist
->is_wild
) {
1680 if (mask_match(last_component
, namelist
->name
, case_sensitive
)) {
1681 DEBUG(8,("is_in_path: mask match succeeded\n"));
1685 if((case_sensitive
&& (strcmp(last_component
, namelist
->name
) == 0))||
1686 (!case_sensitive
&& (StrCaseCmp(last_component
, namelist
->name
) == 0))) {
1687 DEBUG(8,("is_in_path: match succeeded\n"));
1692 DEBUG(8,("is_in_path: match not found\n"));
1696 /*******************************************************************
1697 Strip a '/' separated list into an array of
1698 name_compare_enties structures suitable for
1699 passing to is_in_path(). We do this for
1700 speed so we can pre-parse all the names in the list
1701 and don't do it for each call to is_in_path().
1702 namelist is modified here and is assumed to be
1703 a copy owned by the caller.
1704 We also check if the entry contains a wildcard to
1705 remove a potentially expensive call to mask_match
1707 ********************************************************************/
1709 void set_namearray(name_compare_entry
**ppname_array
, const char *namelist
)
1712 char *nameptr
= (char *)namelist
;
1713 int num_entries
= 0;
1716 (*ppname_array
) = NULL
;
1718 if((nameptr
== NULL
) || ((nameptr
!= NULL
) && (*nameptr
== '\0')))
1721 /* We need to make two passes over the string. The
1722 first to count the number of elements, the second
1727 if ( *nameptr
== '/' ) {
1728 /* cope with multiple (useless) /s) */
1732 /* anything left? */
1733 if ( *nameptr
== '\0' )
1736 /* find the next '/' or consume remaining */
1737 name_end
= strchr_m(nameptr
, '/');
1738 if (name_end
== NULL
)
1739 name_end
= (char *)nameptr
+ strlen(nameptr
);
1741 /* next segment please */
1742 nameptr
= name_end
+ 1;
1746 if(num_entries
== 0)
1749 if(( (*ppname_array
) = SMB_MALLOC_ARRAY(name_compare_entry
, num_entries
+ 1)) == NULL
) {
1750 DEBUG(0,("set_namearray: malloc fail\n"));
1754 /* Now copy out the names */
1755 nameptr
= (char *)namelist
;
1758 if ( *nameptr
== '/' ) {
1759 /* cope with multiple (useless) /s) */
1763 /* anything left? */
1764 if ( *nameptr
== '\0' )
1767 /* find the next '/' or consume remaining */
1768 name_end
= strchr_m(nameptr
, '/');
1772 name_end
= nameptr
+ strlen(nameptr
);
1774 (*ppname_array
)[i
].is_wild
= ms_has_wild(nameptr
);
1775 if(((*ppname_array
)[i
].name
= SMB_STRDUP(nameptr
)) == NULL
) {
1776 DEBUG(0,("set_namearray: malloc fail (1)\n"));
1780 /* next segment please */
1781 nameptr
= name_end
+ 1;
1785 (*ppname_array
)[i
].name
= NULL
;
1790 /****************************************************************************
1791 Routine to free a namearray.
1792 ****************************************************************************/
1794 void free_namearray(name_compare_entry
*name_array
)
1798 if(name_array
== NULL
)
1801 for(i
=0; name_array
[i
].name
!=NULL
; i
++)
1802 SAFE_FREE(name_array
[i
].name
);
1803 SAFE_FREE(name_array
);
1807 #define DBGC_CLASS DBGC_LOCKING
1809 /****************************************************************************
1810 Simple routine to query existing file locks. Cruft in NFS and 64->32 bit mapping
1811 is dealt with in posix.c
1812 Returns True if we have information regarding this lock region (and returns
1813 F_UNLCK in *ptype if the region is unlocked). False if the call failed.
1814 ****************************************************************************/
1816 bool fcntl_getlock(int fd
, SMB_OFF_T
*poffset
, SMB_OFF_T
*pcount
, int *ptype
, pid_t
*ppid
)
1818 SMB_STRUCT_FLOCK lock
;
1821 DEBUG(8,("fcntl_getlock fd=%d offset=%.0f count=%.0f type=%d\n",
1822 fd
,(double)*poffset
,(double)*pcount
,*ptype
));
1824 lock
.l_type
= *ptype
;
1825 lock
.l_whence
= SEEK_SET
;
1826 lock
.l_start
= *poffset
;
1827 lock
.l_len
= *pcount
;
1830 ret
= sys_fcntl_ptr(fd
,SMB_F_GETLK
,&lock
);
1834 DEBUG(3,("fcntl_getlock: lock request failed at offset %.0f count %.0f type %d (%s)\n",
1835 (double)*poffset
,(double)*pcount
,*ptype
,strerror(errno
)));
1840 *ptype
= lock
.l_type
;
1841 *poffset
= lock
.l_start
;
1842 *pcount
= lock
.l_len
;
1845 DEBUG(3,("fcntl_getlock: fd %d is returned info %d pid %u\n",
1846 fd
, (int)lock
.l_type
, (unsigned int)lock
.l_pid
));
1851 #define DBGC_CLASS DBGC_ALL
1853 /*******************************************************************
1854 Is the name specified one of my netbios names.
1855 Returns true if it is equal, false otherwise.
1856 ********************************************************************/
1858 bool is_myname(const char *s
)
1863 for (n
=0; my_netbios_names(n
); n
++) {
1864 if (strequal(my_netbios_names(n
), s
)) {
1869 DEBUG(8, ("is_myname(\"%s\") returns %d\n", s
, ret
));
1873 /*******************************************************************
1874 Is the name specified our workgroup/domain.
1875 Returns true if it is equal, false otherwise.
1876 ********************************************************************/
1878 bool is_myworkgroup(const char *s
)
1882 if (strequal(s
, lp_workgroup())) {
1886 DEBUG(8, ("is_myworkgroup(\"%s\") returns %d\n", s
, ret
));
1890 /*******************************************************************
1891 we distinguish between 2K and XP by the "Native Lan Manager" string
1892 WinXP => "Windows 2002 5.1"
1893 WinXP 64bit => "Windows XP 5.2"
1894 Win2k => "Windows 2000 5.0"
1895 NT4 => "Windows NT 4.0"
1896 Win9x => "Windows 4.0"
1897 Windows 2003 doesn't set the native lan manager string but
1898 they do set the domain to "Windows 2003 5.2" (probably a bug).
1899 ********************************************************************/
1901 void ra_lanman_string( const char *native_lanman
)
1903 if ( strcmp( native_lanman
, "Windows 2002 5.1" ) == 0 )
1904 set_remote_arch( RA_WINXP
);
1905 else if ( strcmp( native_lanman
, "Windows XP 5.2" ) == 0 )
1906 set_remote_arch( RA_WINXP64
);
1907 else if ( strcmp( native_lanman
, "Windows Server 2003 5.2" ) == 0 )
1908 set_remote_arch( RA_WIN2K3
);
1911 static const char *remote_arch_str
;
1913 const char *get_remote_arch_str(void)
1915 if (!remote_arch_str
) {
1918 return remote_arch_str
;
1921 /*******************************************************************
1922 Set the horrid remote_arch string based on an enum.
1923 ********************************************************************/
1925 void set_remote_arch(enum remote_arch_types type
)
1930 remote_arch_str
= "WfWg";
1933 remote_arch_str
= "OS2";
1936 remote_arch_str
= "Win95";
1939 remote_arch_str
= "WinNT";
1942 remote_arch_str
= "Win2K";
1945 remote_arch_str
= "WinXP";
1948 remote_arch_str
= "WinXP64";
1951 remote_arch_str
= "Win2K3";
1954 remote_arch_str
= "Vista";
1957 remote_arch_str
= "Samba";
1960 remote_arch_str
= "CIFSFS";
1963 ra_type
= RA_UNKNOWN
;
1964 remote_arch_str
= "UNKNOWN";
1968 DEBUG(10,("set_remote_arch: Client arch is \'%s\'\n",
1972 /*******************************************************************
1973 Get the remote_arch type.
1974 ********************************************************************/
1976 enum remote_arch_types
get_remote_arch(void)
1981 const char *tab_depth(int level
, int depth
)
1983 if( CHECK_DEBUGLVL(level
) ) {
1984 dbgtext("%*s", depth
*4, "");
1989 /*****************************************************************************
1990 Provide a checksum on a string
1992 Input: s - the null-terminated character string for which the checksum
1995 Output: The checksum value calculated for s.
1996 *****************************************************************************/
1998 int str_checksum(const char *s
)
2006 res
^= (c
<< (i
% 15)) ^ (c
>> (15-(i
%15)));
2013 /*****************************************************************
2014 Zero a memory area then free it. Used to catch bugs faster.
2015 *****************************************************************/
2017 void zero_free(void *p
, size_t size
)
2023 /*****************************************************************
2024 Set our open file limit to a requested max and return the limit.
2025 *****************************************************************/
2027 int set_maxfiles(int requested_max
)
2029 #if (defined(HAVE_GETRLIMIT) && defined(RLIMIT_NOFILE))
2031 int saved_current_limit
;
2033 if(getrlimit(RLIMIT_NOFILE
, &rlp
)) {
2034 DEBUG(0,("set_maxfiles: getrlimit (1) for RLIMIT_NOFILE failed with error %s\n",
2037 return requested_max
;
2041 * Set the fd limit to be real_max_open_files + MAX_OPEN_FUDGEFACTOR to
2042 * account for the extra fd we need
2043 * as well as the log files and standard
2044 * handles etc. Save the limit we want to set in case
2045 * we are running on an OS that doesn't support this limit (AIX)
2046 * which always returns RLIM_INFINITY for rlp.rlim_max.
2049 /* Try raising the hard (max) limit to the requested amount. */
2051 #if defined(RLIM_INFINITY)
2052 if (rlp
.rlim_max
!= RLIM_INFINITY
) {
2053 int orig_max
= rlp
.rlim_max
;
2055 if ( rlp
.rlim_max
< requested_max
)
2056 rlp
.rlim_max
= requested_max
;
2058 /* This failing is not an error - many systems (Linux) don't
2059 support our default request of 10,000 open files. JRA. */
2061 if(setrlimit(RLIMIT_NOFILE
, &rlp
)) {
2062 DEBUG(3,("set_maxfiles: setrlimit for RLIMIT_NOFILE for %d max files failed with error %s\n",
2063 (int)rlp
.rlim_max
, strerror(errno
) ));
2065 /* Set failed - restore original value from get. */
2066 rlp
.rlim_max
= orig_max
;
2071 /* Now try setting the soft (current) limit. */
2073 saved_current_limit
= rlp
.rlim_cur
= MIN(requested_max
,rlp
.rlim_max
);
2075 if(setrlimit(RLIMIT_NOFILE
, &rlp
)) {
2076 DEBUG(0,("set_maxfiles: setrlimit for RLIMIT_NOFILE for %d files failed with error %s\n",
2077 (int)rlp
.rlim_cur
, strerror(errno
) ));
2079 return saved_current_limit
;
2082 if(getrlimit(RLIMIT_NOFILE
, &rlp
)) {
2083 DEBUG(0,("set_maxfiles: getrlimit (2) for RLIMIT_NOFILE failed with error %s\n",
2086 return saved_current_limit
;
2089 #if defined(RLIM_INFINITY)
2090 if(rlp
.rlim_cur
== RLIM_INFINITY
)
2091 return saved_current_limit
;
2094 if((int)rlp
.rlim_cur
> saved_current_limit
)
2095 return saved_current_limit
;
2097 return rlp
.rlim_cur
;
2098 #else /* !defined(HAVE_GETRLIMIT) || !defined(RLIMIT_NOFILE) */
2100 * No way to know - just guess...
2102 return requested_max
;
2106 /*****************************************************************
2107 malloc that aborts with smb_panic on fail or zero size.
2108 *****************************************************************/
2110 void *smb_xmalloc_array(size_t size
, unsigned int count
)
2114 smb_panic("smb_xmalloc_array: called with zero size");
2116 if (count
>= MAX_ALLOC_SIZE
/size
) {
2117 smb_panic("smb_xmalloc_array: alloc size too large");
2119 if ((p
= SMB_MALLOC(size
*count
)) == NULL
) {
2120 DEBUG(0, ("smb_xmalloc_array failed to allocate %lu * %lu bytes\n",
2121 (unsigned long)size
, (unsigned long)count
));
2122 smb_panic("smb_xmalloc_array: malloc failed");
2128 vasprintf that aborts on malloc fail
2131 int smb_xvasprintf(char **ptr
, const char *format
, va_list ap
)
2138 n
= vasprintf(ptr
, format
, ap2
);
2140 if (n
== -1 || ! *ptr
) {
2141 smb_panic("smb_xvasprintf: out of memory");
2146 /*****************************************************************
2147 Get local hostname and cache result.
2148 *****************************************************************/
2150 char *myhostname(void)
2154 /* This is cached forever so
2155 * use talloc_autofree_context() ctx. */
2156 ret
= get_myname(talloc_autofree_context());
2162 * @brief Returns an absolute path to a file concatenating the provided
2163 * @a rootpath and @a basename
2165 * @param name Filename, relative to @a rootpath
2167 * @retval Pointer to a string containing the full path.
2170 static char *xx_path(const char *name
, const char *rootpath
)
2174 fname
= talloc_strdup(talloc_tos(), rootpath
);
2178 trim_string(fname
,"","/");
2180 if (!directory_exist(fname
)) {
2181 if (!mkdir(fname
,0755))
2182 DEBUG(1, ("Unable to create directory %s for file %s. "
2183 "Error was %s\n", fname
, name
, strerror(errno
)));
2186 return talloc_asprintf(talloc_tos(),
2193 * @brief Returns an absolute path to a file in the Samba lock directory.
2195 * @param name File to find, relative to LOCKDIR.
2197 * @retval Pointer to a talloc'ed string containing the full path.
2200 char *lock_path(const char *name
)
2202 return xx_path(name
, lp_lockdir());
2206 * @brief Returns an absolute path to a file in the Samba pid directory.
2208 * @param name File to find, relative to PIDDIR.
2210 * @retval Pointer to a talloc'ed string containing the full path.
2213 char *pid_path(const char *name
)
2215 return xx_path(name
, lp_piddir());
2219 * @brief Returns an absolute path to a file in the Samba lib directory.
2221 * @param name File to find, relative to LIBDIR.
2223 * @retval Pointer to a string containing the full path.
2226 char *lib_path(const char *name
)
2228 return talloc_asprintf(talloc_tos(), "%s/%s", get_dyn_LIBDIR(), name
);
2232 * @brief Returns an absolute path to a file in the Samba modules directory.
2234 * @param name File to find, relative to MODULESDIR.
2236 * @retval Pointer to a string containing the full path.
2239 char *modules_path(const char *name
)
2241 return talloc_asprintf(talloc_tos(), "%s/%s", get_dyn_MODULESDIR(), name
);
2245 * @brief Returns an absolute path to a file in the Samba data directory.
2247 * @param name File to find, relative to CODEPAGEDIR.
2249 * @retval Pointer to a talloc'ed string containing the full path.
2252 char *data_path(const char *name
)
2254 return talloc_asprintf(talloc_tos(), "%s/%s", get_dyn_CODEPAGEDIR(), name
);
2258 * @brief Returns an absolute path to a file in the Samba state directory.
2260 * @param name File to find, relative to STATEDIR.
2262 * @retval Pointer to a talloc'ed string containing the full path.
2265 char *state_path(const char *name
)
2267 return xx_path(name
, lp_statedir());
2271 * @brief Returns an absolute path to a file in the Samba cache directory.
2273 * @param name File to find, relative to CACHEDIR.
2275 * @retval Pointer to a talloc'ed string containing the full path.
2278 char *cache_path(const char *name
)
2280 return xx_path(name
, lp_cachedir());
2284 * @brief Returns the platform specific shared library extension.
2286 * @retval Pointer to a const char * containing the extension.
2289 const char *shlib_ext(void)
2291 return get_dyn_SHLIBEXT();
2294 /*******************************************************************
2295 Given a filename - get its directory name
2296 ********************************************************************/
2298 bool parent_dirname(TALLOC_CTX
*mem_ctx
, const char *dir
, char **parent
,
2304 p
= strrchr_m(dir
, '/'); /* Find final '/', if any */
2307 if (!(*parent
= talloc_strdup(mem_ctx
, "."))) {
2318 if (!(*parent
= (char *)TALLOC_MEMDUP(mem_ctx
, dir
, len
+1))) {
2321 (*parent
)[len
] = '\0';
2329 /*******************************************************************
2330 Determine if a pattern contains any Microsoft wildcard characters.
2331 *******************************************************************/
2333 bool ms_has_wild(const char *s
)
2337 if (lp_posix_pathnames()) {
2338 /* With posix pathnames no characters are wild. */
2342 while ((c
= *s
++)) {
2355 bool ms_has_wild_w(const smb_ucs2_t
*s
)
2358 if (!s
) return False
;
2359 while ((c
= *s
++)) {
2361 case UCS2_CHAR('*'):
2362 case UCS2_CHAR('?'):
2363 case UCS2_CHAR('<'):
2364 case UCS2_CHAR('>'):
2365 case UCS2_CHAR('"'):
2372 /*******************************************************************
2373 A wrapper that handles case sensitivity and the special handling
2375 *******************************************************************/
2377 bool mask_match(const char *string
, const char *pattern
, bool is_case_sensitive
)
2379 if (strcmp(string
,"..") == 0)
2381 if (strcmp(pattern
,".") == 0)
2384 return ms_fnmatch(pattern
, string
, Protocol
<= PROTOCOL_LANMAN2
, is_case_sensitive
) == 0;
2387 /*******************************************************************
2388 A wrapper that handles case sensitivity and the special handling
2389 of the ".." name. Varient that is only called by old search code which requires
2390 pattern translation.
2391 *******************************************************************/
2393 bool mask_match_search(const char *string
, const char *pattern
, bool is_case_sensitive
)
2395 if (strcmp(string
,"..") == 0)
2397 if (strcmp(pattern
,".") == 0)
2400 return ms_fnmatch(pattern
, string
, True
, is_case_sensitive
) == 0;
2403 /*******************************************************************
2404 A wrapper that handles a list of patters and calls mask_match()
2405 on each. Returns True if any of the patterns match.
2406 *******************************************************************/
2408 bool mask_match_list(const char *string
, char **list
, int listLen
, bool is_case_sensitive
)
2410 while (listLen
-- > 0) {
2411 if (mask_match(string
, *list
++, is_case_sensitive
))
2417 /*********************************************************
2418 Recursive routine that is called by unix_wild_match.
2419 *********************************************************/
2421 static bool unix_do_match(const char *regexp
, const char *str
)
2425 for( p
= regexp
; *p
&& *str
; ) {
2436 * Look for a character matching
2437 * the one after the '*'.
2441 return true; /* Automatic match */
2444 while(*str
&& (*p
!= *str
))
2448 * Patch from weidel@multichart.de. In the case of the regexp
2449 * '*XX*' we want to ensure there are at least 2 'X' characters
2450 * in the string after the '*' for a match to be made.
2457 * Eat all the characters that match, but count how many there were.
2460 while(*str
&& (*p
== *str
)) {
2466 * Now check that if the regexp had n identical characters that
2467 * matchcount had at least that many matches.
2470 while ( *(p
+1) && (*(p
+1) == *p
)) {
2475 if ( matchcount
<= 0 )
2479 str
--; /* We've eaten the match char after the '*' */
2481 if(unix_do_match(p
, str
))
2503 if (!*p
&& str
[0] == '.' && str
[1] == 0)
2506 if (!*str
&& *p
== '?') {
2512 if(!*str
&& (*p
== '*' && p
[1] == '\0'))
2518 /*******************************************************************
2519 Simple case insensitive interface to a UNIX wildcard matcher.
2520 Returns True if match, False if not.
2521 *******************************************************************/
2523 bool unix_wild_match(const char *pattern
, const char *string
)
2525 TALLOC_CTX
*ctx
= talloc_stackframe();
2531 p2
= talloc_strdup(ctx
,pattern
);
2532 s2
= talloc_strdup(ctx
,string
);
2540 /* Remove any *? and ** from the pattern as they are meaningless */
2541 for(p
= p2
; *p
; p
++) {
2542 while( *p
== '*' && (p
[1] == '?' ||p
[1] == '*')) {
2543 memmove(&p
[1], &p
[2], strlen(&p
[2])+1);
2547 if (strequal(p2
,"*")) {
2552 ret
= unix_do_match(p2
, s2
);
2557 /**********************************************************************
2558 Converts a name to a fully qualified domain name.
2559 Returns true if lookup succeeded, false if not (then fqdn is set to name)
2560 Note we deliberately use gethostbyname here, not getaddrinfo as we want
2561 to examine the h_aliases and I don't know how to do that with getaddrinfo.
2562 ***********************************************************************/
2564 bool name_to_fqdn(fstring fqdn
, const char *name
)
2567 struct hostent
*hp
= gethostbyname(name
);
2569 if (!hp
|| !hp
->h_name
|| !*hp
->h_name
) {
2570 DEBUG(10,("name_to_fqdn: lookup for %s failed.\n", name
));
2571 fstrcpy(fqdn
, name
);
2575 /* Find out if the fqdn is returned as an alias
2576 * to cope with /etc/hosts files where the first
2577 * name is not the fqdn but the short name */
2578 if (hp
->h_aliases
&& (! strchr_m(hp
->h_name
, '.'))) {
2580 for (i
= 0; hp
->h_aliases
[i
]; i
++) {
2581 if (strchr_m(hp
->h_aliases
[i
], '.')) {
2582 full
= hp
->h_aliases
[i
];
2587 if (full
&& (StrCaseCmp(full
, "localhost.localdomain") == 0)) {
2588 DEBUG(1, ("WARNING: your /etc/hosts file may be broken!\n"));
2589 DEBUGADD(1, (" Specifing the machine hostname for address 127.0.0.1 may lead\n"));
2590 DEBUGADD(1, (" to Kerberos authentication problems as localhost.localdomain\n"));
2591 DEBUGADD(1, (" may end up being used instead of the real machine FQDN.\n"));
2598 DEBUG(10,("name_to_fqdn: lookup for %s -> %s.\n", name
, full
));
2599 fstrcpy(fqdn
, full
);
2603 /**********************************************************************
2604 Append a DATA_BLOB to a talloc'ed object
2605 ***********************************************************************/
2607 void *talloc_append_blob(TALLOC_CTX
*mem_ctx
, void *buf
, DATA_BLOB blob
)
2609 size_t old_size
= 0;
2612 if (blob
.length
== 0) {
2617 old_size
= talloc_get_size(buf
);
2620 result
= (char *)TALLOC_REALLOC(mem_ctx
, buf
, old_size
+ blob
.length
);
2621 if (result
== NULL
) {
2625 memcpy(result
+ old_size
, blob
.data
, blob
.length
);
2629 uint32
map_share_mode_to_deny_mode(uint32 share_access
, uint32 private_options
)
2631 switch (share_access
& ~FILE_SHARE_DELETE
) {
2632 case FILE_SHARE_NONE
:
2634 case FILE_SHARE_READ
:
2636 case FILE_SHARE_WRITE
:
2638 case FILE_SHARE_READ
|FILE_SHARE_WRITE
:
2641 if (private_options
& NTCREATEX_OPTIONS_PRIVATE_DENY_DOS
) {
2643 } else if (private_options
& NTCREATEX_OPTIONS_PRIVATE_DENY_FCB
) {
2650 pid_t
procid_to_pid(const struct server_id
*proc
)
2655 static uint32 my_vnn
= NONCLUSTER_VNN
;
2657 void set_my_vnn(uint32 vnn
)
2659 DEBUG(10, ("vnn pid %d = %u\n", (int)sys_getpid(), (unsigned int)vnn
));
2663 uint32
get_my_vnn(void)
2668 struct server_id
pid_to_procid(pid_t pid
)
2670 struct server_id result
;
2672 #ifdef CLUSTER_SUPPORT
2673 result
.vnn
= my_vnn
;
2678 struct server_id
procid_self(void)
2680 return pid_to_procid(sys_getpid());
2683 struct server_id
server_id_self(void)
2685 return procid_self();
2688 bool procid_equal(const struct server_id
*p1
, const struct server_id
*p2
)
2690 if (p1
->pid
!= p2
->pid
)
2692 #ifdef CLUSTER_SUPPORT
2693 if (p1
->vnn
!= p2
->vnn
)
2699 bool cluster_id_equal(const struct server_id
*id1
,
2700 const struct server_id
*id2
)
2702 return procid_equal(id1
, id2
);
2705 bool procid_is_me(const struct server_id
*pid
)
2707 if (pid
->pid
!= sys_getpid())
2709 #ifdef CLUSTER_SUPPORT
2710 if (pid
->vnn
!= my_vnn
)
2716 struct server_id
interpret_pid(const char *pid_string
)
2718 struct server_id result
;
2720 #ifdef CLUSTER_SUPPORT
2722 if (sscanf(pid_string
, "%u:%d", &vnn
, &pid
) == 2) {
2726 else if (sscanf(pid_string
, "%d", &pid
) == 1) {
2727 result
.vnn
= get_my_vnn();
2731 result
.vnn
= NONCLUSTER_VNN
;
2735 if (sscanf(pid_string
, "%d", &pid
) != 1) {
2741 /* Assigning to result.pid may have overflowed
2742 Map negative pid to -1: i.e. error */
2743 if (result
.pid
< 0) {
2749 char *procid_str(TALLOC_CTX
*mem_ctx
, const struct server_id
*pid
)
2751 #ifdef CLUSTER_SUPPORT
2752 if (pid
->vnn
== NONCLUSTER_VNN
) {
2753 return talloc_asprintf(mem_ctx
,
2758 return talloc_asprintf(mem_ctx
,
2764 return talloc_asprintf(mem_ctx
,
2770 char *procid_str_static(const struct server_id
*pid
)
2772 return procid_str(talloc_tos(), pid
);
2775 bool procid_valid(const struct server_id
*pid
)
2777 return (pid
->pid
!= -1);
2780 bool procid_is_local(const struct server_id
*pid
)
2782 #ifdef CLUSTER_SUPPORT
2783 return pid
->vnn
== my_vnn
;
2789 int this_is_smp(void)
2791 #if defined(HAVE_SYSCONF)
2793 #if defined(SYSCONF_SC_NPROC_ONLN)
2794 return (sysconf(_SC_NPROC_ONLN
) > 1) ? 1 : 0;
2795 #elif defined(SYSCONF_SC_NPROCESSORS_ONLN)
2796 return (sysconf(_SC_NPROCESSORS_ONLN
) > 1) ? 1 : 0;
2806 /****************************************************************
2807 Check if offset/length fit into bufsize. Should probably be
2808 merged with is_offset_safe, but this would require a rewrite
2809 of lanman.c. Later :-)
2810 ****************************************************************/
2812 bool trans_oob(uint32_t bufsize
, uint32_t offset
, uint32_t length
)
2814 if ((offset
+ length
< offset
) || (offset
+ length
< length
)) {
2818 if ((offset
> bufsize
) || (offset
+ length
> bufsize
)) {
2825 /****************************************************************
2826 Check if an offset into a buffer is safe.
2827 If this returns True it's safe to indirect into the byte at
2829 ****************************************************************/
2831 bool is_offset_safe(const char *buf_base
, size_t buf_len
, char *ptr
, size_t off
)
2833 const char *end_base
= buf_base
+ buf_len
;
2834 char *end_ptr
= ptr
+ off
;
2836 if (!buf_base
|| !ptr
) {
2840 if (end_base
< buf_base
|| end_ptr
< ptr
) {
2841 return False
; /* wrap. */
2844 if (end_ptr
< end_base
) {
2850 /****************************************************************
2851 Return a safe pointer into a buffer, or NULL.
2852 ****************************************************************/
2854 char *get_safe_ptr(const char *buf_base
, size_t buf_len
, char *ptr
, size_t off
)
2856 return is_offset_safe(buf_base
, buf_len
, ptr
, off
) ?
2860 /****************************************************************
2861 Return a safe pointer into a string within a buffer, or NULL.
2862 ****************************************************************/
2864 char *get_safe_str_ptr(const char *buf_base
, size_t buf_len
, char *ptr
, size_t off
)
2866 if (!is_offset_safe(buf_base
, buf_len
, ptr
, off
)) {
2869 /* Check if a valid string exists at this offset. */
2870 if (skip_string(buf_base
,buf_len
, ptr
+ off
) == NULL
) {
2876 /****************************************************************
2877 Return an SVAL at a pointer, or failval if beyond the end.
2878 ****************************************************************/
2880 int get_safe_SVAL(const char *buf_base
, size_t buf_len
, char *ptr
, size_t off
, int failval
)
2883 * Note we use off+1 here, not off+2 as SVAL accesses ptr[0] and ptr[1],
2886 if (!is_offset_safe(buf_base
, buf_len
, ptr
, off
+1)) {
2889 return SVAL(ptr
,off
);
2892 /****************************************************************
2893 Return an IVAL at a pointer, or failval if beyond the end.
2894 ****************************************************************/
2896 int get_safe_IVAL(const char *buf_base
, size_t buf_len
, char *ptr
, size_t off
, int failval
)
2899 * Note we use off+3 here, not off+4 as IVAL accesses
2900 * ptr[0] ptr[1] ptr[2] ptr[3] NOT ptr[4].
2902 if (!is_offset_safe(buf_base
, buf_len
, ptr
, off
+3)) {
2905 return IVAL(ptr
,off
);
2908 /****************************************************************
2909 Split DOM\user into DOM and user. Do not mix with winbind variants of that
2910 call (they take care of winbind separator and other winbind specific settings).
2911 ****************************************************************/
2913 void split_domain_user(TALLOC_CTX
*mem_ctx
,
2914 const char *full_name
,
2918 const char *p
= NULL
;
2920 p
= strchr_m(full_name
, '\\');
2923 *domain
= talloc_strndup(mem_ctx
, full_name
,
2924 PTR_DIFF(p
, full_name
));
2925 *user
= talloc_strdup(mem_ctx
, p
+1);
2927 *domain
= talloc_strdup(mem_ctx
, "");
2928 *user
= talloc_strdup(mem_ctx
, full_name
);
2934 Disable these now we have checked all code paths
and ensured
2935 NULL returns on zero request
. JRA
.
2937 /****************************************************************
2938 talloc wrapper functions that guarentee a null pointer return
2940 ****************************************************************/
2942 #ifndef MAX_TALLOC_SIZE
2943 #define MAX_TALLOC_SIZE 0x10000000
2947 * talloc and zero memory.
2948 * - returns NULL if size is zero.
2951 void *_talloc_zero_zeronull(const void *ctx
, size_t size
, const char *name
)
2959 p
= talloc_named_const(ctx
, size
, name
);
2962 memset(p
, '\0', size
);
2969 * memdup with a talloc.
2970 * - returns NULL if size is zero.
2973 void *_talloc_memdup_zeronull(const void *t
, const void *p
, size_t size
, const char *name
)
2981 newp
= talloc_named_const(t
, size
, name
);
2983 memcpy(newp
, p
, size
);
2990 * alloc an array, checking for integer overflow in the array size.
2991 * - returns NULL if count or el_size are zero.
2994 void *_talloc_array_zeronull(const void *ctx
, size_t el_size
, unsigned count
, const char *name
)
2996 if (count
>= MAX_TALLOC_SIZE
/el_size
) {
3000 if (el_size
== 0 || count
== 0) {
3004 return talloc_named_const(ctx
, el_size
* count
, name
);
3008 * alloc an zero array, checking for integer overflow in the array size
3009 * - returns NULL if count or el_size are zero.
3012 void *_talloc_zero_array_zeronull(const void *ctx
, size_t el_size
, unsigned count
, const char *name
)
3014 if (count
>= MAX_TALLOC_SIZE
/el_size
) {
3018 if (el_size
== 0 || count
== 0) {
3022 return _talloc_zero(ctx
, el_size
* count
, name
);
3026 * Talloc wrapper that returns NULL if size == 0.
3028 void *talloc_zeronull(const void *context
, size_t size
, const char *name
)
3033 return talloc_named_const(context
, size
, name
);
3037 bool is_valid_policy_hnd(const struct policy_handle
*hnd
)
3039 struct policy_handle tmp
;
3041 return (memcmp(&tmp
, hnd
, sizeof(tmp
)) != 0);
3044 bool policy_hnd_equal(const struct policy_handle
*hnd1
,
3045 const struct policy_handle
*hnd2
)
3047 if (!hnd1
|| !hnd2
) {
3051 return (memcmp(hnd1
, hnd2
, sizeof(*hnd1
)) == 0);
3054 /****************************************************************
3055 strip off leading '\\' from a hostname
3056 ****************************************************************/
3058 const char *strip_hostname(const char *s
)
3064 if (strlen_m(s
) < 3) {
3068 if (s
[0] == '\\') s
++;
3069 if (s
[0] == '\\') s
++;