021f8c0edf56c738d940da0df091b11d475d7256
[kai/samba.git] / source3 / lib / util.c
1 /* 
2    Unix SMB/Netbios implementation.
3    Version 1.9.
4    Samba utility functions
5    Copyright (C) Andrew Tridgell 1992-1998
6    Copyright (C) Jeremy Allison 2001
7    Copyright (C) Simo Sorce 2001
8    
9    This program is free software; you can redistribute it and/or modify
10    it under the terms of the GNU General Public License as published by
11    the Free Software Foundation; either version 2 of the License, or
12    (at your option) any later version.
13    
14    This program is distributed in the hope that it will be useful,
15    but WITHOUT ANY WARRANTY; without even the implied warranty of
16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17    GNU General Public License for more details.
18    
19    You should have received a copy of the GNU General Public License
20    along with this program; if not, write to the Free Software
21    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
22 */
23
24 #include "includes.h"
25
26 #if (defined(HAVE_NETGROUP) && defined (WITH_AUTOMOUNT))
27 #ifdef WITH_NISPLUS_HOME
28 #ifdef BROKEN_NISPLUS_INCLUDE_FILES
29 /*
30  * The following lines are needed due to buggy include files
31  * in Solaris 2.6 which define GROUP in both /usr/include/sys/acl.h and
32  * also in /usr/include/rpcsvc/nis.h. The definitions conflict. JRA.
33  * Also GROUP_OBJ is defined as 0x4 in /usr/include/sys/acl.h and as
34  * an enum in /usr/include/rpcsvc/nis.h.
35  */
36
37 #if defined(GROUP)
38 #undef GROUP
39 #endif
40
41 #if defined(GROUP_OBJ)
42 #undef GROUP_OBJ
43 #endif
44
45 #endif /* BROKEN_NISPLUS_INCLUDE_FILES */
46
47 #include <rpcsvc/nis.h>
48
49 #else /* !WITH_NISPLUS_HOME */
50
51 #include "rpcsvc/ypclnt.h"
52
53 #endif /* WITH_NISPLUS_HOME */
54 #endif /* HAVE_NETGROUP && WITH_AUTOMOUNT */
55
56 #ifdef WITH_SSL
57 #include <openssl/ssl.h>
58 #undef Realloc  /* SSLeay defines this and samba has a function of this name */
59 extern SSL  *ssl;
60 extern int  sslFd;
61 #endif  /* WITH_SSL */
62
63 int Protocol = PROTOCOL_COREPLUS;
64
65 /* a default finfo structure to ensure all fields are sensible */
66 file_info def_finfo = {-1,0,0,0,0,0,0,"",""};
67
68 /* this is used by the chaining code */
69 int chain_size = 0;
70
71 int trans_num = 0;
72
73 /*
74    case handling on filenames 
75 */
76 int case_default = CASE_LOWER;
77
78 /* the following control case operations - they are put here so the
79    client can link easily */
80 BOOL case_sensitive;
81 BOOL case_preserve;
82 BOOL use_mangled_map = False;
83 BOOL short_case_preserve;
84 BOOL case_mangle;
85
86 static enum remote_arch_types ra_type = RA_UNKNOWN;
87 pstring user_socket_options=DEFAULT_SOCKET_OPTIONS;   
88
89 pstring global_myname = "";
90 fstring global_myworkgroup = "";
91 char **my_netbios_names;
92
93
94 /****************************************************************************
95   find a suitable temporary directory. The result should be copied immediately
96  as it may be overwritten by a subsequent call.
97   ****************************************************************************/
98 char *tmpdir(void)
99 {
100   char *p;
101         if ((p = getenv("TMPDIR")))
102     return p;
103   return "/tmp";
104 }
105
106 /****************************************************************************
107  Determine whether we are in the specified group.
108 ****************************************************************************/
109
110 BOOL in_group(gid_t group, gid_t current_gid, int ngroups, gid_t *groups)
111 {
112         int i;
113
114         if (group == current_gid)
115                 return(True);
116
117         for (i=0;i<ngroups;i++)
118                 if (group == groups[i])
119                         return(True);
120
121         return(False);
122 }
123
124 /****************************************************************************
125  Like atoi but gets the value up to the separator character.
126 ****************************************************************************/
127
128 char *Atoic(char *p, int *n, char *c)
129 {
130         if (!isdigit((int)*p)) {
131                 DEBUG(5, ("Atoic: malformed number\n"));
132                 return NULL;
133         }
134
135         (*n) = atoi(p);
136
137         while ((*p) && isdigit((int)*p))
138                 p++;
139
140         if (strchr_m(c, *p) == NULL)
141         {
142                 DEBUG(5, ("Atoic: no separator characters (%s) not found\n", c));
143                 return NULL;
144         }
145
146         return p;
147 }
148
149 /*************************************************************************
150  Reads a list of numbers.
151  *************************************************************************/
152
153 char *get_numlist(char *p, uint32 **num, int *count)
154 {
155         int val;
156
157         if (num == NULL || count == NULL)
158                 return NULL;
159
160         (*count) = 0;
161         (*num  ) = NULL;
162
163         while ((p = Atoic(p, &val, ":,")) != NULL && (*p) != ':') {
164                 uint32 *tn;
165                 
166                 tn = Realloc((*num), ((*count)+1) * sizeof(uint32));
167                 if (tn == NULL)
168                 {
169                         SAFE_FREE(*num);
170                         return NULL;
171                 } else
172                         (*num) = tn;
173                 (*num)[(*count)] = val;
174                 (*count)++;
175                 p++;
176         }
177
178         return p;
179 }
180
181 /*******************************************************************
182  Check if a file exists - call vfs_file_exist for samba files.
183 ********************************************************************/
184
185 BOOL file_exist(const char *fname,SMB_STRUCT_STAT *sbuf)
186 {
187   SMB_STRUCT_STAT st;
188         if (!sbuf)
189                 sbuf = &st;
190   
191   if (sys_stat(fname,sbuf) != 0) 
192     return(False);
193
194   return(S_ISREG(sbuf->st_mode));
195 }
196
197 /*******************************************************************
198  Check a files mod time.
199 ********************************************************************/
200
201 time_t file_modtime(const char *fname)
202 {
203   SMB_STRUCT_STAT st;
204   
205   if (sys_stat(fname,&st) != 0) 
206     return(0);
207
208   return(st.st_mtime);
209 }
210
211 /*******************************************************************
212  Check if a directory exists.
213 ********************************************************************/
214
215 BOOL directory_exist(char *dname,SMB_STRUCT_STAT *st)
216 {
217   SMB_STRUCT_STAT st2;
218   BOOL ret;
219
220   if (!st) st = &st2;
221
222   if (sys_stat(dname,st) != 0) 
223     return(False);
224
225   ret = S_ISDIR(st->st_mode);
226   if(!ret)
227     errno = ENOTDIR;
228   return ret;
229 }
230
231 /*******************************************************************
232 returns the size in bytes of the named file
233 ********************************************************************/
234 SMB_OFF_T get_file_size(char *file_name)
235 {
236   SMB_STRUCT_STAT buf;
237   buf.st_size = 0;
238   if(sys_stat(file_name,&buf) != 0)
239     return (SMB_OFF_T)-1;
240   return(buf.st_size);
241 }
242
243 /*******************************************************************
244 return a string representing an attribute for a file
245 ********************************************************************/
246 char *attrib_string(uint16 mode)
247 {
248   static fstring attrstr;
249
250   attrstr[0] = 0;
251
252   if (mode & aVOLID) fstrcat(attrstr,"V");
253   if (mode & aDIR) fstrcat(attrstr,"D");
254   if (mode & aARCH) fstrcat(attrstr,"A");
255   if (mode & aHIDDEN) fstrcat(attrstr,"H");
256   if (mode & aSYSTEM) fstrcat(attrstr,"S");
257   if (mode & aRONLY) fstrcat(attrstr,"R");        
258
259   return(attrstr);
260 }
261
262 /*******************************************************************
263   show a smb message structure
264 ********************************************************************/
265 void show_msg(char *buf)
266 {
267         int i;
268         int bcc=0;
269
270         if (DEBUGLEVEL < 5) return;
271
272         DEBUG(5,("size=%d\nsmb_com=0x%x\nsmb_rcls=%d\nsmb_reh=%d\nsmb_err=%d\nsmb_flg=%d\nsmb_flg2=%d\n",
273                         smb_len(buf),
274                         (int)CVAL(buf,smb_com),
275                         (int)CVAL(buf,smb_rcls),
276                         (int)CVAL(buf,smb_reh),
277                         (int)SVAL(buf,smb_err),
278                         (int)CVAL(buf,smb_flg),
279                         (int)SVAL(buf,smb_flg2)));
280         DEBUG(5,("smb_tid=%d\nsmb_pid=%d\nsmb_uid=%d\nsmb_mid=%d\nsmt_wct=%d\n",
281                         (int)SVAL(buf,smb_tid),
282                         (int)SVAL(buf,smb_pid),
283                         (int)SVAL(buf,smb_uid),
284                         (int)SVAL(buf,smb_mid),
285                         (int)CVAL(buf,smb_wct)));
286
287         for (i=0;i<(int)CVAL(buf,smb_wct);i++)
288         {
289                 DEBUG(5,("smb_vwv[%d]=%d (0x%X)\n",i,
290                         SVAL(buf,smb_vwv+2*i),SVAL(buf,smb_vwv+2*i)));
291         }
292
293         bcc = (int)SVAL(buf,smb_vwv+2*(CVAL(buf,smb_wct)));
294
295         DEBUG(5,("smb_bcc=%d\n",bcc));
296
297         if (DEBUGLEVEL < 10) return;
298
299         if (DEBUGLEVEL < 50)
300         {
301                 bcc = MIN(bcc, 512);
302         }
303
304         dump_data(10, smb_buf(buf), bcc);
305 }
306
307 /*******************************************************************
308   set the length and marker of an smb packet
309 ********************************************************************/
310 void smb_setlen(char *buf,int len)
311 {
312   _smb_setlen(buf,len);
313
314   SCVAL(buf,4,0xFF);
315   SCVAL(buf,5,'S');
316   SCVAL(buf,6,'M');
317   SCVAL(buf,7,'B');
318 }
319
320 /*******************************************************************
321   setup the word count and byte count for a smb message
322 ********************************************************************/
323 int set_message(char *buf,int num_words,int num_bytes,BOOL zero)
324 {
325         if (zero)
326                 memset(buf + smb_size,'\0',num_words*2 + num_bytes);
327         SCVAL(buf,smb_wct,num_words);
328         SSVAL(buf,smb_vwv + num_words*SIZEOFWORD,num_bytes);  
329         smb_setlen(buf,smb_size + num_words*2 + num_bytes - 4);
330         return (smb_size + num_words*2 + num_bytes);
331 }
332
333 /*******************************************************************
334   setup only the byte count for a smb message
335 ********************************************************************/
336 int set_message_bcc(char *buf,int num_bytes)
337 {
338         int num_words = CVAL(buf,smb_wct);
339         SSVAL(buf,smb_vwv + num_words*SIZEOFWORD,num_bytes);  
340         smb_setlen(buf,smb_size + num_words*2 + num_bytes - 4);
341         return (smb_size + num_words*2 + num_bytes);
342 }
343
344 /*******************************************************************
345   setup only the byte count for a smb message, using the end of the
346   message as a marker
347 ********************************************************************/
348 int set_message_end(void *outbuf,void *end_ptr)
349 {
350         return set_message_bcc((char *)outbuf,PTR_DIFF(end_ptr,smb_buf((char *)outbuf)));
351 }
352
353 /*******************************************************************
354 reduce a file name, removing .. elements.
355 ********************************************************************/
356 void dos_clean_name(char *s)
357 {
358   char *p=NULL;
359
360   DEBUG(3,("dos_clean_name [%s]\n",s));
361
362   /* remove any double slashes */
363   all_string_sub(s, "\\\\", "\\", 0);
364
365   while ((p = strstr(s,"\\..\\")) != NULL)
366     {
367       pstring s1;
368
369       *p = 0;
370       pstrcpy(s1,p+3);
371
372       if ((p=strrchr_m(s,'\\')) != NULL)
373         *p = 0;
374       else
375         *s = 0;
376       pstrcat(s,s1);
377     }  
378
379   trim_string(s,NULL,"\\..");
380
381   all_string_sub(s, "\\.\\", "\\", 0);
382 }
383
384 /*******************************************************************
385 reduce a file name, removing .. elements. 
386 ********************************************************************/
387 void unix_clean_name(char *s)
388 {
389   char *p=NULL;
390
391   DEBUG(3,("unix_clean_name [%s]\n",s));
392
393   /* remove any double slashes */
394   all_string_sub(s, "//","/", 0);
395
396   /* Remove leading ./ characters */
397   if(strncmp(s, "./", 2) == 0) {
398     trim_string(s, "./", NULL);
399     if(*s == 0)
400       pstrcpy(s,"./");
401   }
402
403   while ((p = strstr(s,"/../")) != NULL)
404     {
405       pstring s1;
406
407       *p = 0;
408       pstrcpy(s1,p+3);
409
410       if ((p=strrchr_m(s,'/')) != NULL)
411         *p = 0;
412       else
413         *s = 0;
414       pstrcat(s,s1);
415     }  
416
417   trim_string(s,NULL,"/..");
418 }
419
420 /*******************************************************************
421 convert '\' to '/'
422 reduce a file name, removing or reducing /../ , /./ , // elements.
423 remove also any trailing . and /
424 return a new allocated string.
425 ********************************************************************/
426 smb_ucs2_t *unix_clean_path(const smb_ucs2_t *s)
427 {
428         smb_ucs2_t *ns;
429         smb_ucs2_t *p, *r, *t;
430
431         DEBUG(3, ("unix_clean_path\n")); /*  [%unicode]\n")); */
432         if(!s) return NULL;
433
434         /* convert '\' to '/' */
435         ns = strdup_w(s);
436         if (!ns) return NULL;
437         unix_format_w(ns);
438
439         /* remove all double slashes */
440         p = ns;
441         ns = all_string_sub_wa(p, "//", "/");
442         SAFE_FREE(p);
443         if (!ns) return NULL;
444
445         /* remove any /./ */
446         p = ns;
447         ns = all_string_sub_wa(p, "/./", "/");
448         SAFE_FREE(p);
449         if (!ns) return NULL;
450
451         /* reduce any /../ */
452         t = ns;
453         while (*t && (r = strstr_wa(t, "/.."))) {
454                 t = &(r[3]);
455                 if (*t == UCS2_CHAR('/') || *t == 0) {
456                         *r = 0;
457                         p = strrchr_w(ns, UCS2_CHAR('/'));
458                         if (!p) p = ns;
459                         if (*t == 0) *p = 0;
460                         else memmove(p, t, (strlen_w(t) + 1) * sizeof(smb_ucs2_t));
461                         t = p;
462                 }
463         }
464
465         /* remove any leading ./ trailing /. */
466         trim_string_wa(ns, "./", "/.");
467
468         /* remove any leading and trailing / */
469         trim_string_wa(ns, "/", "/");
470
471         return ns;
472 }
473
474 /****************************************************************************
475   make a dir struct
476 ****************************************************************************/
477 void make_dir_struct(char *buf,char *mask,char *fname,SMB_OFF_T size,int mode,time_t date)
478 {  
479   char *p;
480   pstring mask2;
481
482   pstrcpy(mask2,mask);
483
484   if ((mode & aDIR) != 0)
485     size = 0;
486
487   memset(buf+1,' ',11);
488   if ((p = strchr_m(mask2,'.')) != NULL)
489     {
490       *p = 0;
491       push_ascii(buf+1,mask2,8, 0);
492       push_ascii(buf+9,p+1,3, 0);
493       *p = '.';
494     }
495   else
496       push_ascii(buf+1,mask2,11, 0);
497
498   memset(buf+21,'\0',DIR_STRUCT_SIZE-21);
499   SCVAL(buf,21,mode);
500   put_dos_date(buf,22,date);
501   SSVAL(buf,26,size & 0xFFFF);
502   SSVAL(buf,28,(size >> 16)&0xFFFF);
503   push_ascii(buf+30,fname,12, 0);
504   if (!case_sensitive)
505     strupper(buf+30);
506   DEBUG(8,("put name [%s] from [%s] into dir struct\n",buf+30, fname));
507 }
508
509
510 /*******************************************************************
511 close the low 3 fd's and open dev/null in their place
512 ********************************************************************/
513 void close_low_fds(void)
514 {
515   int fd;
516   int i;
517   close(0); close(1); 
518 #ifndef __INSURE__
519   close(2);
520 #endif
521   /* try and use up these file descriptors, so silly
522      library routines writing to stdout etc won't cause havoc */
523   for (i=0;i<3;i++) {
524     fd = sys_open("/dev/null",O_RDWR,0);
525     if (fd < 0) fd = sys_open("/dev/null",O_WRONLY,0);
526     if (fd < 0) {
527       DEBUG(0,("Can't open /dev/null\n"));
528       return;
529     }
530     if (fd != i) {
531       DEBUG(0,("Didn't get file descriptor %d\n",i));
532       return;
533     }
534   }
535 }
536
537 /****************************************************************************
538 Set a fd into blocking/nonblocking mode. Uses POSIX O_NONBLOCK if available,
539 else
540 if SYSV use O_NDELAY
541 if BSD use FNDELAY
542 ****************************************************************************/
543 int set_blocking(int fd, BOOL set)
544 {
545   int val;
546 #ifdef O_NONBLOCK
547 #define FLAG_TO_SET O_NONBLOCK
548 #else
549 #ifdef SYSV
550 #define FLAG_TO_SET O_NDELAY
551 #else /* BSD */
552 #define FLAG_TO_SET FNDELAY
553 #endif
554 #endif
555
556   if((val = fcntl(fd, F_GETFL, 0)) == -1)
557         return -1;
558   if(set) /* Turn blocking on - ie. clear nonblock flag */
559         val &= ~FLAG_TO_SET;
560   else
561     val |= FLAG_TO_SET;
562   return fcntl( fd, F_SETFL, val);
563 #undef FLAG_TO_SET
564 }
565
566 /****************************************************************************
567  Transfer some data between two fd's.
568 ****************************************************************************/
569
570 #ifndef TRANSFER_BUF_SIZE
571 #define TRANSFER_BUF_SIZE 65536
572 #endif
573
574 ssize_t transfer_file_internal(int infd, int outfd, size_t n, ssize_t (*read_fn)(int, void *, size_t),
575                                                 ssize_t (*write_fn)(int, const void *, size_t))
576 {
577         char *buf;
578         size_t total = 0;
579         ssize_t read_ret;
580         ssize_t write_ret;
581         size_t num_to_read_thistime;
582         size_t num_written = 0;
583
584         if ((buf = malloc(TRANSFER_BUF_SIZE)) == NULL)
585                 return -1;
586
587         while (total < n) {
588                 num_to_read_thistime = MIN((n - total), TRANSFER_BUF_SIZE);
589
590                 read_ret = (*read_fn)(infd, buf, num_to_read_thistime);
591                 if (read_ret == -1) {
592                         DEBUG(0,("transfer_file_internal: read failure. Error = %s\n", strerror(errno) ));
593                         SAFE_FREE(buf);
594                         return -1;
595                 }
596                 if (read_ret == 0)
597                         break;
598
599                 num_written = 0;
600  
601                 while (num_written < read_ret) {
602                         write_ret = (*write_fn)(outfd,buf + num_written, read_ret - num_written);
603  
604                         if (write_ret == -1) {
605                                 DEBUG(0,("transfer_file_internal: write failure. Error = %s\n", strerror(errno) ));
606                                 SAFE_FREE(buf);
607                                 return -1;
608                         }
609                         if (write_ret == 0)
610                                 return (ssize_t)total;
611  
612                         num_written += (size_t)write_ret;
613                 }
614
615                 total += (size_t)read_ret;
616         }
617
618         SAFE_FREE(buf);
619         return (ssize_t)total;          
620 }
621
622 SMB_OFF_T transfer_file(int infd,int outfd,SMB_OFF_T n)
623 {
624         return (SMB_OFF_T)transfer_file_internal(infd, outfd, (size_t)n, read, write);
625 }
626
627 /*******************************************************************
628  Sleep for a specified number of milliseconds.
629 ********************************************************************/
630
631 void msleep(int t)
632 {
633   int tdiff=0;
634   struct timeval tval,t1,t2;  
635   fd_set fds;
636
637   GetTimeOfDay(&t1);
638   GetTimeOfDay(&t2);
639   
640   while (tdiff < t) {
641     tval.tv_sec = (t-tdiff)/1000;
642     tval.tv_usec = 1000*((t-tdiff)%1000);
643  
644     FD_ZERO(&fds);
645     errno = 0;
646     sys_select_intr(0,&fds,&tval);
647
648     GetTimeOfDay(&t2);
649     tdiff = TvalDiff(&t1,&t2);
650   }
651 }
652
653 /****************************************************************************
654  Become a daemon, discarding the controlling terminal.
655 ****************************************************************************/
656
657 void become_daemon(void)
658 {
659         if (sys_fork()) {
660                 _exit(0);
661         }
662
663   /* detach from the terminal */
664 #ifdef HAVE_SETSID
665         setsid();
666 #elif defined(TIOCNOTTY)
667         {
668                 int i = sys_open("/dev/tty", O_RDWR, 0);
669                 if (i != -1) {
670                         ioctl(i, (int) TIOCNOTTY, (char *)0);      
671                         close(i);
672                 }
673         }
674 #endif /* HAVE_SETSID */
675
676         /* Close fd's 0,1,2. Needed if started by rsh */
677         close_low_fds();
678 }
679
680
681 /****************************************************************************
682 put up a yes/no prompt
683 ****************************************************************************/
684 BOOL yesno(char *p)
685 {
686   pstring ans;
687   printf("%s",p);
688
689   if (!fgets(ans,sizeof(ans)-1,stdin))
690     return(False);
691
692   if (*ans == 'y' || *ans == 'Y')
693     return(True);
694
695   return(False);
696 }
697
698 /****************************************************************************
699  Expand a pointer to be a particular size.
700 ****************************************************************************/
701
702 void *Realloc(void *p,size_t size)
703 {
704   void *ret=NULL;
705
706   if (size == 0) {
707     SAFE_FREE(p);
708     DEBUG(5,("Realloc asked for 0 bytes\n"));
709     return NULL;
710   }
711
712   if (!p)
713     ret = (void *)malloc(size);
714   else
715     ret = (void *)realloc(p,size);
716
717   if (!ret)
718     DEBUG(0,("Memory allocation error: failed to expand to %d bytes\n",(int)size));
719
720   return(ret);
721 }
722
723 /****************************************************************************
724  Free memory, checks for NULL.
725 use directly SAFE_FREE()
726 exist only because we need to pass a function pointer somewhere --SSS
727 ****************************************************************************/
728
729 void safe_free(void *p)
730 {
731         SAFE_FREE(p);
732 }
733
734 /****************************************************************************
735  Get my own name and IP.
736 ****************************************************************************/
737
738 BOOL get_myname(char *my_name)
739 {
740         pstring hostname;
741
742         *hostname = 0;
743
744         /* get my host name */
745         if (gethostname(hostname, sizeof(hostname)) == -1) {
746                 DEBUG(0,("gethostname failed\n"));
747                 return False;
748         } 
749
750         /* Ensure null termination. */
751         hostname[sizeof(hostname)-1] = '\0';
752
753         if (my_name) {
754                 /* split off any parts after an initial . */
755                 char *p = strchr_m(hostname,'.');
756
757                 if (p)
758                         *p = 0;
759                 
760                 fstrcpy(my_name,hostname);
761         }
762         
763         return(True);
764 }
765
766 /****************************************************************************
767  Interpret a protocol description string, with a default.
768 ****************************************************************************/
769
770 int interpret_protocol(char *str,int def)
771 {
772   if (strequal(str,"NT1"))
773     return(PROTOCOL_NT1);
774   if (strequal(str,"LANMAN2"))
775     return(PROTOCOL_LANMAN2);
776   if (strequal(str,"LANMAN1"))
777     return(PROTOCOL_LANMAN1);
778   if (strequal(str,"CORE"))
779     return(PROTOCOL_CORE);
780   if (strequal(str,"COREPLUS"))
781     return(PROTOCOL_COREPLUS);
782   if (strequal(str,"CORE+"))
783     return(PROTOCOL_COREPLUS);
784   
785   DEBUG(0,("Unrecognised protocol level %s\n",str));
786   
787   return(def);
788 }
789
790 /****************************************************************************
791  Return true if a string could be a pure IP address.
792 ****************************************************************************/
793
794 BOOL is_ipaddress(const char *str)
795 {
796   BOOL pure_address = True;
797   int i;
798   
799   for (i=0; pure_address && str[i]; i++)
800     if (!(isdigit((int)str[i]) || str[i] == '.'))
801       pure_address = False;
802
803   /* Check that a pure number is not misinterpreted as an IP */
804   pure_address = pure_address && (strchr_m(str, '.') != NULL);
805
806   return pure_address;
807 }
808
809 /****************************************************************************
810 interpret an internet address or name into an IP address in 4 byte form
811 ****************************************************************************/
812
813 uint32 interpret_addr(const char *str)
814 {
815   struct hostent *hp;
816   uint32 res;
817
818   if (strcmp(str,"0.0.0.0") == 0) return(0);
819   if (strcmp(str,"255.255.255.255") == 0) return(0xFFFFFFFF);
820
821   /* if it's in the form of an IP address then get the lib to interpret it */
822   if (is_ipaddress(str)) {
823     res = inet_addr(str);
824   } else {
825     /* otherwise assume it's a network name of some sort and use 
826        sys_gethostbyname */
827     if ((hp = sys_gethostbyname(str)) == 0) {
828       DEBUG(3,("sys_gethostbyname: Unknown host. %s\n",str));
829       return 0;
830     }
831     if(hp->h_addr == NULL) {
832       DEBUG(3,("sys_gethostbyname: host address is invalid for host %s\n",str));
833       return 0;
834     }
835     putip((char *)&res,(char *)hp->h_addr);
836   }
837
838   if (res == (uint32)-1) return(0);
839
840   return(res);
841 }
842
843 /*******************************************************************
844   a convenient addition to interpret_addr()
845   ******************************************************************/
846 struct in_addr *interpret_addr2(const char *str)
847 {
848   static struct in_addr ret;
849   uint32 a = interpret_addr(str);
850   ret.s_addr = a;
851   return(&ret);
852 }
853
854 /*******************************************************************
855   check if an IP is the 0.0.0.0
856   ******************************************************************/
857 BOOL is_zero_ip(struct in_addr ip)
858 {
859   uint32 a;
860   putip((char *)&a,(char *)&ip);
861   return(a == 0);
862 }
863
864 /* Set an IP to 0.0.0.0 */
865
866 void zero_ip(struct in_addr *ip)
867 {
868         static BOOL init;
869         static struct in_addr ipzero;
870
871         if (!init) {
872                 ipzero = *interpret_addr2("0.0.0.0");
873                 init = True;
874         }
875
876         *ip = ipzero;
877 }
878
879 #if (defined(HAVE_NETGROUP) && defined(WITH_AUTOMOUNT))
880 /******************************************************************
881  Remove any mount options such as -rsize=2048,wsize=2048 etc.
882  Based on a fix from <Thomas.Hepper@icem.de>.
883 *******************************************************************/
884
885 static void strip_mount_options( pstring *str)
886 {
887   if (**str == '-')
888   { 
889     char *p = *str;
890     while(*p && !isspace(*p))
891       p++;
892     while(*p && isspace(*p))
893       p++;
894     if(*p) {
895       pstring tmp_str;
896
897       pstrcpy(tmp_str, p);
898       pstrcpy(*str, tmp_str);
899     }
900   }
901 }
902
903 /*******************************************************************
904  Patch from jkf@soton.ac.uk
905  Split Luke's automount_server into YP lookup and string splitter
906  so can easily implement automount_path(). 
907  As we may end up doing both, cache the last YP result. 
908 *******************************************************************/
909
910 #ifdef WITH_NISPLUS_HOME
911 char *automount_lookup(const char *user_name)
912 {
913   static fstring last_key = "";
914   static pstring last_value = "";
915  
916   char *nis_map = (char *)lp_nis_home_map_name();
917  
918   char buffer[NIS_MAXATTRVAL + 1];
919   nis_result *result;
920   nis_object *object;
921   entry_obj  *entry;
922  
923   if (strcmp(user_name, last_key))
924   {
925     slprintf(buffer, sizeof(buffer)-1, "[key=%s],%s", user_name, nis_map);
926     DEBUG(5, ("NIS+ querystring: %s\n", buffer));
927  
928     if (result = nis_list(buffer, FOLLOW_PATH|EXPAND_NAME|HARD_LOOKUP, NULL, NULL))
929     {
930        if (result->status != NIS_SUCCESS)
931       {
932         DEBUG(3, ("NIS+ query failed: %s\n", nis_sperrno(result->status)));
933         fstrcpy(last_key, ""); pstrcpy(last_value, "");
934       }
935       else
936       {
937         object = result->objects.objects_val;
938         if (object->zo_data.zo_type == ENTRY_OBJ)
939         {
940            entry = &object->zo_data.objdata_u.en_data;
941            DEBUG(5, ("NIS+ entry type: %s\n", entry->en_type));
942            DEBUG(3, ("NIS+ result: %s\n", entry->en_cols.en_cols_val[1].ec_value.ec_value_val));
943  
944            pstrcpy(last_value, entry->en_cols.en_cols_val[1].ec_value.ec_value_val);
945            pstring_sub(last_value, "&", user_name);
946            fstrcpy(last_key, user_name);
947         }
948       }
949     }
950     nis_freeresult(result);
951   }
952
953   strip_mount_options(&last_value);
954
955   DEBUG(4, ("NIS+ Lookup: %s resulted in %s\n", user_name, last_value));
956   return last_value;
957 }
958 #else /* WITH_NISPLUS_HOME */
959 char *automount_lookup(const char *user_name)
960 {
961   static fstring last_key = "";
962   static pstring last_value = "";
963
964   int nis_error;        /* returned by yp all functions */
965   char *nis_result;     /* yp_match inits this */
966   int nis_result_len;  /* and set this */
967   char *nis_domain;     /* yp_get_default_domain inits this */
968   char *nis_map = (char *)lp_nis_home_map_name();
969
970   if ((nis_error = yp_get_default_domain(&nis_domain)) != 0) {
971     DEBUG(3, ("YP Error: %s\n", yperr_string(nis_error)));
972     return last_value;
973   }
974
975   DEBUG(5, ("NIS Domain: %s\n", nis_domain));
976
977   if (!strcmp(user_name, last_key)) {
978         nis_result = last_value;
979     nis_result_len = strlen(last_value);
980     nis_error = 0;
981
982   } else {
983
984     if ((nis_error = yp_match(nis_domain, nis_map,
985                               user_name, strlen(user_name),
986                               &nis_result, &nis_result_len)) == 0) {
987        if (!nis_error && nis_result_len >= sizeof(pstring)) {
988                nis_result_len = sizeof(pstring)-1;
989        }
990        fstrcpy(last_key, user_name);
991        strncpy(last_value, nis_result, nis_result_len);
992        last_value[nis_result_len] = '\0';
993         strip_mount_options(&last_value);
994
995     } else if(nis_error == YPERR_KEY) {
996
997     /* If Key lookup fails user home server is not in nis_map 
998        use default information for server, and home directory */
999        last_value[0] = 0;
1000        DEBUG(3, ("YP Key not found:  while looking up \"%s\" in map \"%s\"\n", 
1001                 user_name, nis_map));
1002        DEBUG(3, ("using defaults for server and home directory\n"));
1003     } else {
1004        DEBUG(3, ("YP Error: \"%s\" while looking up \"%s\" in map \"%s\"\n", 
1005                yperr_string(nis_error), user_name, nis_map));
1006     }
1007   }
1008
1009
1010   DEBUG(4, ("YP Lookup: %s resulted in %s\n", user_name, last_value));
1011   return last_value;
1012 }
1013 #endif /* WITH_NISPLUS_HOME */
1014 #endif
1015
1016
1017 /*******************************************************************
1018 are two IPs on the same subnet?
1019 ********************************************************************/
1020 BOOL same_net(struct in_addr ip1,struct in_addr ip2,struct in_addr mask)
1021 {
1022   uint32 net1,net2,nmask;
1023
1024   nmask = ntohl(mask.s_addr);
1025   net1  = ntohl(ip1.s_addr);
1026   net2  = ntohl(ip2.s_addr);
1027             
1028   return((net1 & nmask) == (net2 & nmask));
1029 }
1030
1031
1032 /****************************************************************************
1033 check if a process exists. Does this work on all unixes?
1034 ****************************************************************************/
1035
1036 BOOL process_exists(pid_t pid)
1037 {
1038         return(kill(pid,0) == 0 || errno != ESRCH);
1039 }
1040
1041
1042 /*******************************************************************
1043  Convert a uid into a user name.
1044 ********************************************************************/
1045
1046 char *uidtoname(uid_t uid)
1047 {
1048         static fstring name;
1049         struct passwd *pass;
1050
1051         pass = sys_getpwuid(uid);
1052         if (pass) return(pass->pw_name);
1053         slprintf(name, sizeof(name) - 1, "%d",(int)uid);
1054         return(name);
1055 }
1056
1057
1058 /*******************************************************************
1059  Convert a gid into a group name.
1060 ********************************************************************/
1061
1062 char *gidtoname(gid_t gid)
1063 {
1064         static fstring name;
1065         struct group *grp;
1066
1067         grp = getgrgid(gid);
1068         if (grp) return(grp->gr_name);
1069         slprintf(name,sizeof(name) - 1, "%d",(int)gid);
1070         return(name);
1071 }
1072
1073 /*******************************************************************
1074  Convert a user name into a uid. If winbindd is present uses this.
1075 ********************************************************************/
1076
1077 uid_t nametouid(char *name)
1078 {
1079         struct passwd *pass;
1080         char *p;
1081         uid_t u;
1082
1083         u = (uid_t)strtol(name, &p, 0);
1084         if ((p != name) && (*p == '\0'))
1085                 return u;
1086
1087         pass = getpwnam_alloc(name);
1088         if (pass) {
1089                 return(pass->pw_uid);
1090                 passwd_free(&pass);
1091         }
1092         return (uid_t)-1;
1093 }
1094
1095 /*******************************************************************
1096  Convert a name to a gid_t if possible. Return -1 if not a group. If winbindd
1097  is present does a shortcut lookup...
1098 ********************************************************************/
1099
1100 gid_t nametogid(const char *name)
1101 {
1102         struct group *grp;
1103         char *p;
1104         gid_t g;
1105
1106         g = (gid_t)strtol(name, &p, 0);
1107         if ((p != name) && (*p == '\0'))
1108                 return g;
1109
1110         grp = getgrnam(name);
1111         if (grp)
1112                 return(grp->gr_gid);
1113         return (gid_t)-1;
1114 }
1115
1116 /*******************************************************************
1117 something really nasty happened - panic!
1118 ********************************************************************/
1119 void smb_panic(char *why)
1120 {
1121         char *cmd = lp_panic_action();
1122         if (cmd && *cmd) {
1123                 system(cmd);
1124         }
1125         DEBUG(0,("PANIC: %s\n", why));
1126         dbgflush();
1127         abort();
1128 }
1129
1130
1131 /*******************************************************************
1132 a readdir wrapper which just returns the file name
1133 ********************************************************************/
1134 char *readdirname(DIR *p)
1135 {
1136         SMB_STRUCT_DIRENT *ptr;
1137         char *dname;
1138
1139         if (!p) return(NULL);
1140   
1141         ptr = (SMB_STRUCT_DIRENT *)sys_readdir(p);
1142         if (!ptr) return(NULL);
1143
1144         dname = ptr->d_name;
1145
1146 #ifdef NEXT2
1147         if (telldir(p) < 0) return(NULL);
1148 #endif
1149
1150 #ifdef HAVE_BROKEN_READDIR
1151         /* using /usr/ucb/cc is BAD */
1152         dname = dname - 2;
1153 #endif
1154
1155         {
1156                 static pstring buf;
1157                 int len = NAMLEN(ptr);
1158                 memcpy(buf, dname, len);
1159                 buf[len] = 0;
1160                 dname = buf;
1161         }
1162
1163         return(dname);
1164 }
1165
1166 /*******************************************************************
1167  Utility function used to decide if the last component 
1168  of a path matches a (possibly wildcarded) entry in a namelist.
1169 ********************************************************************/
1170
1171 BOOL is_in_path(char *name, name_compare_entry *namelist)
1172 {
1173   pstring last_component;
1174   char *p;
1175
1176   DEBUG(8, ("is_in_path: %s\n", name));
1177
1178   /* if we have no list it's obviously not in the path */
1179   if((namelist == NULL ) || ((namelist != NULL) && (namelist[0].name == NULL))) 
1180   {
1181     DEBUG(8,("is_in_path: no name list.\n"));
1182     return False;
1183   }
1184
1185   /* Get the last component of the unix name. */
1186   p = strrchr_m(name, '/');
1187   strncpy(last_component, p ? ++p : name, sizeof(last_component)-1);
1188   last_component[sizeof(last_component)-1] = '\0'; 
1189
1190   for(; namelist->name != NULL; namelist++)
1191   {
1192     if(namelist->is_wild)
1193     {
1194       if (mask_match(last_component, namelist->name, case_sensitive))
1195       {
1196          DEBUG(8,("is_in_path: mask match succeeded\n"));
1197          return True;
1198       }
1199     }
1200     else
1201     {
1202       if((case_sensitive && (strcmp(last_component, namelist->name) == 0))||
1203        (!case_sensitive && (StrCaseCmp(last_component, namelist->name) == 0)))
1204         {
1205          DEBUG(8,("is_in_path: match succeeded\n"));
1206          return True;
1207         }
1208     }
1209   }
1210   DEBUG(8,("is_in_path: match not found\n"));
1211  
1212   return False;
1213 }
1214
1215 /*******************************************************************
1216  Strip a '/' separated list into an array of 
1217  name_compare_enties structures suitable for 
1218  passing to is_in_path(). We do this for
1219  speed so we can pre-parse all the names in the list 
1220  and don't do it for each call to is_in_path().
1221  namelist is modified here and is assumed to be 
1222  a copy owned by the caller.
1223  We also check if the entry contains a wildcard to
1224  remove a potentially expensive call to mask_match
1225  if possible.
1226 ********************************************************************/
1227  
1228 void set_namearray(name_compare_entry **ppname_array, char *namelist)
1229 {
1230   char *name_end;
1231   char *nameptr = namelist;
1232   int num_entries = 0;
1233   int i;
1234
1235   (*ppname_array) = NULL;
1236
1237   if((nameptr == NULL ) || ((nameptr != NULL) && (*nameptr == '\0'))) 
1238     return;
1239
1240   /* We need to make two passes over the string. The
1241      first to count the number of elements, the second
1242      to split it.
1243    */
1244   while(*nameptr) 
1245     {
1246       if ( *nameptr == '/' ) 
1247         {
1248           /* cope with multiple (useless) /s) */
1249           nameptr++;
1250           continue;
1251         }
1252       /* find the next / */
1253       name_end = strchr_m(nameptr, '/');
1254
1255       /* oops - the last check for a / didn't find one. */
1256       if (name_end == NULL)
1257         break;
1258
1259       /* next segment please */
1260       nameptr = name_end + 1;
1261       num_entries++;
1262     }
1263
1264   if(num_entries == 0)
1265     return;
1266
1267   if(( (*ppname_array) = (name_compare_entry *)malloc( 
1268            (num_entries + 1) * sizeof(name_compare_entry))) == NULL)
1269         {
1270     DEBUG(0,("set_namearray: malloc fail\n"));
1271     return;
1272         }
1273
1274   /* Now copy out the names */
1275   nameptr = namelist;
1276   i = 0;
1277   while(*nameptr)
1278              {
1279       if ( *nameptr == '/' ) 
1280       {
1281           /* cope with multiple (useless) /s) */
1282           nameptr++;
1283           continue;
1284       }
1285       /* find the next / */
1286       if ((name_end = strchr_m(nameptr, '/')) != NULL) 
1287       {
1288           *name_end = 0;
1289          }
1290
1291       /* oops - the last check for a / didn't find one. */
1292       if(name_end == NULL) 
1293         break;
1294
1295       (*ppname_array)[i].is_wild = ms_has_wild(nameptr);
1296       if(((*ppname_array)[i].name = strdup(nameptr)) == NULL)
1297       {
1298         DEBUG(0,("set_namearray: malloc fail (1)\n"));
1299         return;
1300       }
1301
1302       /* next segment please */
1303       nameptr = name_end + 1;
1304       i++;
1305     }
1306   
1307   (*ppname_array)[i].name = NULL;
1308
1309   return;
1310 }
1311
1312 /****************************************************************************
1313 routine to free a namearray.
1314 ****************************************************************************/
1315
1316 void free_namearray(name_compare_entry *name_array)
1317 {
1318   if(name_array == NULL)
1319     return;
1320
1321   SAFE_FREE(name_array->name);
1322   SAFE_FREE(name_array);
1323 }
1324
1325 /****************************************************************************
1326  Simple routine to do POSIX file locking. Cruft in NFS and 64->32 bit mapping
1327  is dealt with in posix.c
1328 ****************************************************************************/
1329
1330 BOOL fcntl_lock(int fd, int op, SMB_OFF_T offset, SMB_OFF_T count, int type)
1331 {
1332   SMB_STRUCT_FLOCK lock;
1333   int ret;
1334
1335   DEBUG(8,("fcntl_lock %d %d %.0f %.0f %d\n",fd,op,(double)offset,(double)count,type));
1336
1337   lock.l_type = type;
1338   lock.l_whence = SEEK_SET;
1339   lock.l_start = offset;
1340   lock.l_len = count;
1341   lock.l_pid = 0;
1342
1343   errno = 0;
1344
1345   ret = fcntl(fd,op,&lock);
1346
1347   if (errno != 0)
1348     DEBUG(3,("fcntl_lock: fcntl lock gave errno %d (%s)\n",errno,strerror(errno)));
1349
1350   /* a lock query */
1351   if (op == SMB_F_GETLK)
1352   {
1353     if ((ret != -1) &&
1354         (lock.l_type != F_UNLCK) && 
1355         (lock.l_pid != 0) && 
1356         (lock.l_pid != sys_getpid()))
1357     {
1358       DEBUG(3,("fcntl_lock: fd %d is locked by pid %d\n",fd,(int)lock.l_pid));
1359       return(True);
1360     }
1361
1362     /* it must be not locked or locked by me */
1363     return(False);
1364   }
1365
1366   /* a lock set or unset */
1367   if (ret == -1)
1368   {
1369     DEBUG(3,("fcntl_lock: lock failed at offset %.0f count %.0f op %d type %d (%s)\n",
1370           (double)offset,(double)count,op,type,strerror(errno)));
1371     return(False);
1372   }
1373
1374   /* everything went OK */
1375   DEBUG(8,("fcntl_lock: Lock call successful\n"));
1376
1377   return(True);
1378 }
1379
1380 /*******************************************************************
1381 is the name specified one of my netbios names
1382 returns true is it is equal, false otherwise
1383 ********************************************************************/
1384 BOOL is_myname(char *s)
1385 {
1386   int n;
1387   BOOL ret = False;
1388
1389   for (n=0; my_netbios_names[n]; n++) {
1390     if (strequal(my_netbios_names[n], s))
1391       ret=True;
1392   }
1393   DEBUG(8, ("is_myname(\"%s\") returns %d\n", s, ret));
1394   return(ret);
1395 }
1396
1397 BOOL is_myname_or_ipaddr(char *s)
1398 {
1399         char **ptr;
1400         
1401         /* optimize for the common case */
1402         if (strequal(s, global_myname)) 
1403                 return True;
1404
1405         /* maybe its an IP address? */
1406         if (is_ipaddress(s))
1407         {
1408                 struct iface_struct nics[MAX_INTERFACES];
1409                 int i, n;
1410                 uint32 ip;
1411                 
1412                 ip = interpret_addr(s);
1413                 if ((ip==0) || (ip==0xffffffff))
1414                         return False;
1415                         
1416                 n = get_interfaces(nics, MAX_INTERFACES);
1417                 for (i=0; i<n; i++) {
1418                         if (ip == nics[i].ip.s_addr)
1419                                 return True;
1420                 }
1421         }       
1422
1423         /* check for an alias */
1424         ptr = lp_netbios_aliases();
1425         for ( ; *ptr; ptr++ )
1426         {
1427                 if (StrCaseCmp(s, *ptr) == 0)
1428                         return True;
1429         }
1430         
1431         
1432         /* no match */
1433         return False;
1434
1435 }
1436
1437
1438 /*******************************************************************
1439 set the horrid remote_arch string based on an enum.
1440 ********************************************************************/
1441 void set_remote_arch(enum remote_arch_types type)
1442 {
1443   extern fstring remote_arch;
1444   ra_type = type;
1445   switch( type )
1446   {
1447   case RA_WFWG:
1448     fstrcpy(remote_arch, "WfWg");
1449     return;
1450   case RA_OS2:
1451     fstrcpy(remote_arch, "OS2");
1452     return;
1453   case RA_WIN95:
1454     fstrcpy(remote_arch, "Win95");
1455     return;
1456   case RA_WINNT:
1457     fstrcpy(remote_arch, "WinNT");
1458     return;
1459   case RA_WIN2K:
1460     fstrcpy(remote_arch, "Win2K");
1461     return;
1462   case RA_SAMBA:
1463     fstrcpy(remote_arch,"Samba");
1464     return;
1465   default:
1466     ra_type = RA_UNKNOWN;
1467     fstrcpy(remote_arch, "UNKNOWN");
1468     break;
1469   }
1470 }
1471
1472 /*******************************************************************
1473  Get the remote_arch type.
1474 ********************************************************************/
1475 enum remote_arch_types get_remote_arch(void)
1476 {
1477   return ra_type;
1478 }
1479
1480
1481 void out_ascii(FILE *f, unsigned char *buf,int len)
1482 {
1483         int i;
1484         for (i=0;i<len;i++)
1485         {
1486                 fprintf(f, "%c", isprint(buf[i])?buf[i]:'.');
1487         }
1488 }
1489
1490 void out_data(FILE *f,char *buf1,int len, int per_line)
1491 {
1492         unsigned char *buf = (unsigned char *)buf1;
1493         int i=0;
1494         if (len<=0)
1495         {
1496                 return;
1497         }
1498
1499         fprintf(f, "[%03X] ",i);
1500         for (i=0;i<len;)
1501         {
1502                 fprintf(f, "%02X ",(int)buf[i]);
1503                 i++;
1504                 if (i%(per_line/2) == 0) fprintf(f, " ");
1505                 if (i%per_line == 0)
1506                 {      
1507                         out_ascii(f,&buf[i-per_line  ],per_line/2); fprintf(f, " ");
1508                         out_ascii(f,&buf[i-per_line/2],per_line/2); fprintf(f, "\n");
1509                         if (i<len) fprintf(f, "[%03X] ",i);
1510                 }
1511         }
1512         if ((i%per_line) != 0)
1513         {
1514                 int n;
1515
1516                 n = per_line - (i%per_line);
1517                 fprintf(f, " ");
1518                 if (n>(per_line/2)) fprintf(f, " ");
1519                 while (n--)
1520                 {
1521                         fprintf(f, "   ");
1522                 }
1523                 n = MIN(per_line/2,i%per_line);
1524                 out_ascii(f,&buf[i-(i%per_line)],n); fprintf(f, " ");
1525                 n = (i%per_line) - n;
1526                 if (n>0) out_ascii(f,&buf[i-n],n); 
1527                 fprintf(f, "\n");    
1528         }
1529 }
1530
1531 void print_asc(int level, const unsigned char *buf,int len)
1532 {
1533         int i;
1534         for (i=0;i<len;i++)
1535                 DEBUG(level,("%c", isprint(buf[i])?buf[i]:'.'));
1536 }
1537
1538 void dump_data(int level, const char *buf1,int len)
1539 {
1540   const unsigned char *buf = (const unsigned char *)buf1;
1541   int i=0;
1542   if (len<=0) return;
1543
1544   DEBUG(level,("[%03X] ",i));
1545   for (i=0;i<len;) {
1546     DEBUG(level,("%02X ",(int)buf[i]));
1547     i++;
1548     if (i%8 == 0) DEBUG(level,(" "));
1549     if (i%16 == 0) {      
1550       print_asc(level,&buf[i-16],8); DEBUG(level,(" "));
1551       print_asc(level,&buf[i-8],8); DEBUG(level,("\n"));
1552       if (i<len) DEBUG(level,("[%03X] ",i));
1553     }
1554   }
1555   if (i%16) {
1556     int n;
1557
1558     n = 16 - (i%16);
1559     DEBUG(level,(" "));
1560     if (n>8) DEBUG(level,(" "));
1561     while (n--) DEBUG(level,("   "));
1562
1563     n = MIN(8,i%16);
1564     print_asc(level,&buf[i-(i%16)],n); DEBUG(level,(" "));
1565     n = (i%16) - n;
1566     if (n>0) print_asc(level,&buf[i-n],n); 
1567     DEBUG(level,("\n"));    
1568   }
1569 }
1570
1571 char *tab_depth(int depth)
1572 {
1573         static pstring spaces;
1574         memset(spaces, ' ', depth * 4);
1575         spaces[depth * 4] = 0;
1576         return spaces;
1577 }
1578
1579 /*****************************************************************************
1580  * Provide a checksum on a string
1581  *
1582  *  Input:  s - the null-terminated character string for which the checksum
1583  *              will be calculated.
1584  *
1585  *  Output: The checksum value calculated for s.
1586  *
1587  * ****************************************************************************
1588  */
1589 int str_checksum(const char *s)
1590 {
1591         int res = 0;
1592         int c;
1593         int i=0;
1594         
1595         while(*s) {
1596                 c = *s;
1597                 res ^= (c << (i % 15)) ^ (c >> (15-(i%15)));
1598                 s++;
1599                 i++;
1600         }
1601         return(res);
1602 } /* str_checksum */
1603
1604
1605
1606 /*****************************************************************
1607 zero a memory area then free it. Used to catch bugs faster
1608 *****************************************************************/  
1609 void zero_free(void *p, size_t size)
1610 {
1611         memset(p, 0, size);
1612         SAFE_FREE(p);
1613 }
1614
1615
1616 /*****************************************************************
1617 set our open file limit to a requested max and return the limit
1618 *****************************************************************/  
1619 int set_maxfiles(int requested_max)
1620 {
1621 #if (defined(HAVE_GETRLIMIT) && defined(RLIMIT_NOFILE))
1622         struct rlimit rlp;
1623         int saved_current_limit;
1624
1625         if(getrlimit(RLIMIT_NOFILE, &rlp)) {
1626                 DEBUG(0,("set_maxfiles: getrlimit (1) for RLIMIT_NOFILE failed with error %s\n",
1627                         strerror(errno) ));
1628                 /* just guess... */
1629                 return requested_max;
1630         }
1631
1632         /* 
1633      * Set the fd limit to be real_max_open_files + MAX_OPEN_FUDGEFACTOR to
1634          * account for the extra fd we need 
1635          * as well as the log files and standard
1636          * handles etc. Save the limit we want to set in case
1637          * we are running on an OS that doesn't support this limit (AIX)
1638          * which always returns RLIM_INFINITY for rlp.rlim_max.
1639          */
1640
1641         /* Try raising the hard (max) limit to the requested amount. */
1642
1643 #if defined(RLIM_INFINITY)
1644         if (rlp.rlim_max != RLIM_INFINITY) {
1645                 int orig_max = rlp.rlim_max;
1646
1647                 if ( rlp.rlim_max < requested_max )
1648                         rlp.rlim_max = requested_max;
1649
1650                 /* This failing is not an error - many systems (Linux) don't
1651                         support our default request of 10,000 open files. JRA. */
1652
1653                 if(setrlimit(RLIMIT_NOFILE, &rlp)) {
1654                         DEBUG(3,("set_maxfiles: setrlimit for RLIMIT_NOFILE for %d max files failed with error %s\n", 
1655                                 (int)rlp.rlim_max, strerror(errno) ));
1656
1657                         /* Set failed - restore original value from get. */
1658                         rlp.rlim_max = orig_max;
1659                 }
1660         }
1661 #endif
1662
1663         /* Now try setting the soft (current) limit. */
1664
1665         saved_current_limit = rlp.rlim_cur = MIN(requested_max,rlp.rlim_max);
1666
1667         if(setrlimit(RLIMIT_NOFILE, &rlp)) {
1668                 DEBUG(0,("set_maxfiles: setrlimit for RLIMIT_NOFILE for %d files failed with error %s\n", 
1669                         (int)rlp.rlim_cur, strerror(errno) ));
1670                 /* just guess... */
1671                 return saved_current_limit;
1672         }
1673
1674         if(getrlimit(RLIMIT_NOFILE, &rlp)) {
1675                 DEBUG(0,("set_maxfiles: getrlimit (2) for RLIMIT_NOFILE failed with error %s\n",
1676                         strerror(errno) ));
1677                 /* just guess... */
1678                 return saved_current_limit;
1679     }
1680
1681 #if defined(RLIM_INFINITY)
1682         if(rlp.rlim_cur == RLIM_INFINITY)
1683                 return saved_current_limit;
1684 #endif
1685
1686     if((int)rlp.rlim_cur > saved_current_limit)
1687                 return saved_current_limit;
1688
1689         return rlp.rlim_cur;
1690 #else /* !defined(HAVE_GETRLIMIT) || !defined(RLIMIT_NOFILE) */
1691         /*
1692          * No way to know - just guess...
1693          */
1694         return requested_max;
1695 #endif
1696 }
1697
1698 /*****************************************************************
1699  splits out the start of the key (HKLM or HKU) and the rest of the key
1700  *****************************************************************/  
1701 BOOL reg_split_key(char *full_keyname, uint32 *reg_type, char *key_name)
1702 {
1703         pstring tmp;
1704
1705         if (!next_token(&full_keyname, tmp, "\\", sizeof(tmp)))
1706         {
1707                 return False;
1708         }
1709
1710         (*reg_type) = 0;
1711
1712         DEBUG(10, ("reg_split_key: hive %s\n", tmp));
1713
1714         if (strequal(tmp, "HKLM") || strequal(tmp, "HKEY_LOCAL_MACHINE"))
1715         {
1716                 (*reg_type) = HKEY_LOCAL_MACHINE;
1717         }
1718         else if (strequal(tmp, "HKU") || strequal(tmp, "HKEY_USERS"))
1719         {
1720                 (*reg_type) = HKEY_USERS;
1721         }
1722         else
1723         {
1724                 DEBUG(10,("reg_split_key: unrecognised hive key %s\n", tmp));
1725                 return False;
1726         }
1727         
1728         if (next_token(&full_keyname, tmp, "\n\r", sizeof(tmp)))
1729         {
1730                 fstrcpy(key_name, tmp);
1731         }
1732         else
1733         {
1734                 key_name[0] = 0;
1735         }
1736
1737         DEBUG(10, ("reg_split_key: name %s\n", key_name));
1738
1739         return True;
1740 }
1741
1742
1743 /*****************************************************************
1744 possibly replace mkstemp if it is broken
1745 *****************************************************************/  
1746 int smb_mkstemp(char *template)
1747 {
1748 #if HAVE_SECURE_MKSTEMP
1749         return mkstemp(template);
1750 #else
1751         /* have a reasonable go at emulating it. Hope that
1752            the system mktemp() isn't completly hopeless */
1753         char *p = mktemp(template);
1754         if (!p) return -1;
1755         return open(p, O_CREAT|O_EXCL|O_RDWR, 0600);
1756 #endif
1757 }
1758
1759
1760 /**
1761  malloc that aborts with smb_panic on fail or zero size.
1762 **/
1763 void *smb_xmalloc(size_t size)
1764 {
1765         void *p;
1766         if (size == 0)
1767                 smb_panic("smb_xmalloc: called with zero size.\n");
1768         if ((p = malloc(size)) == NULL)
1769                 smb_panic("smb_xmalloc: malloc fail.\n");
1770         return p;
1771 }
1772
1773 /**
1774  Memdup with smb_panic on fail.
1775 **/
1776 void *smb_xmemdup(const void *p, size_t size)
1777 {
1778         void *p2;
1779         p2 = smb_xmalloc(size);
1780         memcpy(p2, p, size);
1781         return p2;
1782 }
1783
1784 /**
1785  strdup that aborts on malloc fail.
1786 **/
1787 char *smb_xstrdup(const char *s)
1788 {
1789         char *s1 = strdup(s);
1790         if (!s1)
1791                 smb_panic("smb_xstrdup: malloc fail\n");
1792         return s1;
1793 }
1794
1795 /*
1796   vasprintf that aborts on malloc fail
1797 */
1798 int smb_xvasprintf(char **ptr, const char *format, va_list ap)
1799 {
1800         int n;
1801         n = vasprintf(ptr, format, ap);
1802         if (n == -1 || ! *ptr) {
1803                 smb_panic("smb_xvasprintf: out of memory");
1804         }
1805         return n;
1806 }
1807
1808 /*****************************************************************
1809 like strdup but for memory
1810  *****************************************************************/  
1811 void *memdup(const void *p, size_t size)
1812 {
1813         void *p2;
1814         if (size == 0) return NULL;
1815         p2 = malloc(size);
1816         if (!p2) return NULL;
1817         memcpy(p2, p, size);
1818         return p2;
1819 }
1820
1821 /*****************************************************************
1822 get local hostname and cache result
1823  *****************************************************************/  
1824 char *myhostname(void)
1825 {
1826         static pstring ret;
1827         if (ret[0] == 0) {
1828                 get_myname(ret);
1829         }
1830         return ret;
1831 }
1832
1833
1834 /*****************************************************************
1835 a useful function for returning a path in the Samba lock directory
1836  *****************************************************************/  
1837 char *lock_path(char *name)
1838 {
1839         static pstring fname;
1840
1841         pstrcpy(fname,lp_lockdir());
1842         trim_string(fname,"","/");
1843         
1844         if (!directory_exist(fname,NULL)) {
1845                 mkdir(fname,0755);
1846         }
1847         
1848         pstrcat(fname,"/");
1849         pstrcat(fname,name);
1850
1851         return fname;
1852 }
1853
1854
1855 /**
1856  * @brief Returns an absolute path to a file in the Samba lib directory.
1857  *
1858  * @param name File to find, relative to LIBDIR.
1859  *
1860  * @retval Pointer to a static #pstring containing the full path.
1861  **/
1862 char *lib_path(char *name)
1863 {
1864         static pstring fname;
1865         snprintf(fname, sizeof(fname), "%s/%s", dyn_LIBDIR, name);
1866         return fname;
1867 }
1868
1869 /*******************************************************************
1870  Given a filename - get its directory name
1871  NB: Returned in static storage.  Caveats:
1872  o  Not safe in thread environment.
1873  o  Caller must not free.
1874  o  If caller wishes to preserve, they should copy.
1875 ********************************************************************/
1876
1877 char *parent_dirname(const char *path)
1878 {
1879         static pstring dirpath;
1880         char *p;
1881
1882         if (!path)
1883                 return(NULL);
1884
1885         pstrcpy(dirpath, path);
1886         p = strrchr_m(dirpath, '/');  /* Find final '/', if any */
1887         if (!p) {
1888                 pstrcpy(dirpath, ".");    /* No final "/", so dir is "." */
1889         } else {
1890                 if (p == dirpath)
1891                         ++p;    /* For root "/", leave "/" in place */
1892                 *p = '\0';
1893         }
1894         return dirpath;
1895 }
1896
1897
1898 /*******************************************************************
1899 determine if a pattern contains any Microsoft wildcard characters
1900  *******************************************************************/
1901 BOOL ms_has_wild(char *s)
1902 {
1903         char c;
1904         while ((c = *s++)) {
1905                 switch (c) {
1906                 case '*':
1907                 case '?':
1908                 case '<':
1909                 case '>':
1910                 case '"':
1911                         return True;
1912                 }
1913         }
1914         return False;
1915 }
1916
1917 BOOL ms_has_wild_w(const smb_ucs2_t *s)
1918 {
1919         smb_ucs2_t c;
1920         if (!s) return False;
1921         while ((c = *s++)) {
1922                 switch (c) {
1923                 case UCS2_CHAR('*'):
1924                 case UCS2_CHAR('?'):
1925                 case UCS2_CHAR('<'):
1926                 case UCS2_CHAR('>'):
1927                 case UCS2_CHAR('"'):
1928                         return True;
1929                 }
1930         }
1931         return False;
1932 }
1933
1934 /*******************************************************************
1935  a wrapper that handles case sensitivity and the special handling
1936    of the ".." name
1937  *******************************************************************/
1938 BOOL mask_match(char *string, char *pattern, BOOL is_case_sensitive)
1939 {
1940         fstring p2, s2;
1941
1942         if (strcmp(string,"..") == 0) string = ".";
1943         if (strcmp(pattern,".") == 0) return False;
1944         
1945         if (is_case_sensitive) {
1946                 return ms_fnmatch(pattern, string, Protocol) == 0;
1947         }
1948
1949         fstrcpy(p2, pattern);
1950         fstrcpy(s2, string);
1951         strlower(p2); 
1952         strlower(s2);
1953         return ms_fnmatch(p2, s2, Protocol) == 0;
1954 }
1955
1956 /*********************************************************
1957  Recursive routine that is called by unix_wild_match.
1958 *********************************************************/
1959
1960 static BOOL unix_do_match(char *regexp, char *str)
1961 {
1962         char *p;
1963
1964         for( p = regexp; *p && *str; ) {
1965
1966                 switch(*p) {
1967                         case '?':
1968                                 str++;
1969                                 p++;
1970                                 break;
1971
1972                         case '*':
1973
1974                                 /*
1975                                  * Look for a character matching 
1976                                  * the one after the '*'.
1977                                  */
1978                                 p++;
1979                                 if(!*p)
1980                                         return True; /* Automatic match */
1981                                 while(*str) {
1982
1983                                         while(*str && (*p != *str))
1984                                                 str++;
1985
1986                                         /*
1987                                          * Patch from weidel@multichart.de. In the case of the regexp
1988                                          * '*XX*' we want to ensure there are at least 2 'X' characters
1989                                          * in the string after the '*' for a match to be made.
1990                                          */
1991
1992                                         {
1993                                                 int matchcount=0;
1994
1995                                                 /*
1996                                                  * Eat all the characters that match, but count how many there were.
1997                                                  */
1998
1999                                                 while(*str && (*p == *str)) {
2000                                                         str++;
2001                                                         matchcount++;
2002                                                 }
2003
2004                                                 /*
2005                                                  * Now check that if the regexp had n identical characters that
2006                                                  * matchcount had at least that many matches.
2007                                                  */
2008
2009                                                 while ( *(p+1) && (*(p+1) == *p)) {
2010                                                         p++;
2011                                                         matchcount--;
2012                                                 }
2013
2014                                                 if ( matchcount <= 0 )
2015                                                         return False;
2016                                         }
2017
2018                                         str--; /* We've eaten the match char after the '*' */
2019
2020                                         if(unix_do_match(p, str))
2021                                                 return True;
2022
2023                                         if(!*str)
2024                                                 return False;
2025                                         else
2026                                                 str++;
2027                                 }
2028                                 return False;
2029
2030                         default:
2031                                 if(*str != *p)
2032                                         return False;
2033                                 str++;
2034                                 p++;
2035                                 break;
2036                 }
2037         }
2038
2039         if(!*p && !*str)
2040                 return True;
2041
2042         if (!*p && str[0] == '.' && str[1] == 0)
2043                 return(True);
2044   
2045         if (!*str && *p == '?') {
2046                 while (*p == '?')
2047                         p++;
2048                 return(!*p);
2049         }
2050
2051         if(!*str && (*p == '*' && p[1] == '\0'))
2052                 return True;
2053
2054         return False;
2055 }
2056
2057 /*******************************************************************
2058  Simple case insensitive interface to a UNIX wildcard matcher.
2059 *******************************************************************/
2060
2061 BOOL unix_wild_match(char *pattern, char *string)
2062 {
2063         pstring p2, s2;
2064         char *p;
2065
2066         pstrcpy(p2, pattern);
2067         pstrcpy(s2, string);
2068         strlower(p2);
2069         strlower(s2);
2070
2071         /* Remove any *? and ** from the pattern as they are meaningless */
2072         for(p = p2; *p; p++)
2073                 while( *p == '*' && (p[1] == '?' ||p[1] == '*'))
2074                         pstrcpy( &p[1], &p[2]);
2075  
2076         if (strequal(p2,"*"))
2077                 return True;
2078
2079         return unix_do_match(p2, s2) == 0;      
2080 }
2081
2082 /*******************************************************************
2083  free() a data blob
2084 *******************************************************************/
2085 static void free_data_blob(DATA_BLOB *d)
2086 {
2087         if ((d) && (d->free)) {
2088                 SAFE_FREE(d->data);
2089         }
2090 }
2091
2092 /*******************************************************************
2093  construct a data blob, must be freed with data_blob_free()
2094  you can pass NULL for p and get a blank data blob
2095 *******************************************************************/
2096 DATA_BLOB data_blob(const void *p, size_t length)
2097 {
2098         DATA_BLOB ret;
2099
2100         if (!length) {
2101                 ZERO_STRUCT(ret);
2102                 return ret;
2103         }
2104
2105         if (p) {
2106                 ret.data = smb_xmemdup(p, length);
2107         } else {
2108                 ret.data = smb_xmalloc(length);
2109         }
2110         ret.length = length;
2111         ret.free = free_data_blob;
2112         return ret;
2113 }
2114
2115 /*******************************************************************
2116  construct a data blob, using supplied TALLOC_CTX
2117 *******************************************************************/
2118 DATA_BLOB data_blob_talloc(TALLOC_CTX *mem_ctx, const void *p, size_t length)
2119 {
2120         DATA_BLOB ret;
2121
2122         if (!p || !length) {
2123                 ZERO_STRUCT(ret);
2124                 return ret;
2125         }
2126
2127         ret.data = talloc_memdup(mem_ctx, p, length);
2128         if (ret.data == NULL)
2129                 smb_panic("data_blob_talloc: talloc_memdup failed.\n");
2130
2131         ret.length = length;
2132         ret.free = NULL;
2133         return ret;
2134 }
2135
2136 /*******************************************************************
2137 free a data blob
2138 *******************************************************************/
2139 void data_blob_free(DATA_BLOB *d)
2140 {
2141         if (d) {
2142                 if (d->free) {
2143                         (d->free)(d);
2144                 }
2145                 ZERO_STRUCTP(d);
2146         }
2147 }
2148
2149 /*******************************************************************
2150 clear a DATA_BLOB's contents
2151 *******************************************************************/
2152 void data_blob_clear(DATA_BLOB *d)
2153 {
2154         if (d->data) {
2155                 memset(d->data, 0, d->length);
2156         }
2157 }
2158
2159 /*******************************************************************
2160 free a data blob and clear its contents
2161 *******************************************************************/
2162 void data_blob_clear_free(DATA_BLOB *d)
2163 {
2164         data_blob_clear(d);
2165         data_blob_free(d);
2166 }
2167
2168 #ifdef __INSURE__
2169
2170 /*******************************************************************
2171 This routine is a trick to immediately catch errors when debugging
2172 with insure. A xterm with a gdb is popped up when insure catches
2173 a error. It is Linux specific.
2174 ********************************************************************/
2175 int _Insure_trap_error(int a1, int a2, int a3, int a4, int a5, int a6)
2176 {
2177         static int (*fn)();
2178         int ret;
2179         char pidstr[10];
2180         /* you can get /usr/bin/backtrace from 
2181            http://samba.org/ftp/unpacked/junkcode/backtrace */
2182         pstring cmd = "/usr/bin/backtrace %d";
2183
2184         slprintf(pidstr, sizeof(pidstr)-1, "%d", sys_getpid());
2185         pstring_sub(cmd, "%d", pidstr);
2186
2187         if (!fn) {
2188                 static void *h;
2189                 h = dlopen("/usr/local/parasoft/insure++lite/lib.linux2/libinsure.so", RTLD_LAZY);
2190                 fn = dlsym(h, "_Insure_trap_error");
2191         }
2192
2193         ret = fn(a1, a2, a3, a4, a5, a6);
2194
2195         system(cmd);
2196
2197         return ret;
2198 }
2199 #endif