OSDN Git Service

Merge "sed -i run as root wasn't preserving ownership."
[android-x86/external-toybox.git] / lib / lib.c
1 /* lib.c - various reusable stuff.
2  *
3  * Copyright 2006 Rob Landley <rob@landley.net>
4  */
5
6 #include "toys.h"
7
8 void verror_msg(char *msg, int err, va_list va)
9 {
10   char *s = ": %s";
11
12   fprintf(stderr, "%s: ", toys.which->name);
13   if (msg) vfprintf(stderr, msg, va);
14   else s+=2;
15   if (err) fprintf(stderr, s, strerror(err));
16   if (msg || err) putc('\n', stderr);
17   if (!toys.exitval) toys.exitval++;
18 }
19
20 // These functions don't collapse together because of the va_stuff.
21
22 void error_msg(char *msg, ...)
23 {
24   va_list va;
25
26   va_start(va, msg);
27   verror_msg(msg, 0, va);
28   va_end(va);
29 }
30
31 void perror_msg(char *msg, ...)
32 {
33   va_list va;
34
35   va_start(va, msg);
36   verror_msg(msg, errno, va);
37   va_end(va);
38 }
39
40 // Die with an error message.
41 void error_exit(char *msg, ...)
42 {
43   va_list va;
44
45   va_start(va, msg);
46   verror_msg(msg, 0, va);
47   va_end(va);
48
49   xexit();
50 }
51
52 // Die with an error message and strerror(errno)
53 void perror_exit(char *msg, ...)
54 {
55   va_list va;
56
57   va_start(va, msg);
58   verror_msg(msg, errno, va);
59   va_end(va);
60
61   xexit();
62 }
63
64 // Exit with an error message after showing help text.
65 void help_exit(char *msg, ...)
66 {
67   va_list va;
68
69   if (CFG_TOYBOX_HELP) show_help(stderr);
70
71   if (msg) {
72     va_start(va, msg);
73     verror_msg(msg, 0, va);
74     va_end(va);
75   }
76
77   xexit();
78 }
79
80 // If you want to explicitly disable the printf() behavior (because you're
81 // printing user-supplied data, or because android's static checker produces
82 // false positives for 'char *s = x ? "blah1" : "blah2"; printf(s);' and it's
83 // -Werror there for policy reasons).
84 void error_msg_raw(char *msg)
85 {
86   error_msg("%s", msg);
87 }
88
89 void perror_msg_raw(char *msg)
90 {
91   perror_msg("%s", msg);
92 }
93
94 void error_exit_raw(char *msg)
95 {
96   error_exit("%s", msg);
97 }
98
99 void perror_exit_raw(char *msg)
100 {
101   perror_exit("%s", msg);
102 }
103
104 // Keep reading until full or EOF
105 ssize_t readall(int fd, void *buf, size_t len)
106 {
107   size_t count = 0;
108
109   while (count<len) {
110     int i = read(fd, (char *)buf+count, len-count);
111     if (!i) break;
112     if (i<0) return i;
113     count += i;
114   }
115
116   return count;
117 }
118
119 // Keep writing until done or EOF
120 ssize_t writeall(int fd, void *buf, size_t len)
121 {
122   size_t count = 0;
123   while (count<len) {
124     int i = write(fd, count+(char *)buf, len-count);
125     if (i<1) return i;
126     count += i;
127   }
128
129   return count;
130 }
131
132 // skip this many bytes of input. Return 0 for success, >0 means this much
133 // left after input skipped.
134 off_t lskip(int fd, off_t offset)
135 {
136   off_t cur = lseek(fd, 0, SEEK_CUR);
137
138   if (cur != -1) {
139     off_t end = lseek(fd, 0, SEEK_END) - cur;
140
141     if (end > 0 && end < offset) return offset - end;
142     end = offset+cur;
143     if (end == lseek(fd, end, SEEK_SET)) return 0;
144     perror_exit("lseek");
145   }
146
147   while (offset>0) {
148     int try = offset>sizeof(libbuf) ? sizeof(libbuf) : offset, or;
149
150     or = readall(fd, libbuf, try);
151     if (or < 0) perror_exit("lskip to %lld", (long long)offset);
152     else offset -= or;
153     if (or < try) break;
154   }
155
156   return offset;
157 }
158
159 // flags: 1=make last dir (with mode lastmode, otherwise skips last component)
160 //        2=make path (already exists is ok)
161 //        4=verbose
162 // returns 0 = path ok, 1 = error
163 int mkpathat(int atfd, char *dir, mode_t lastmode, int flags)
164 {
165   struct stat buf;
166   char *s;
167
168   // mkdir -p one/two/three is not an error if the path already exists,
169   // but is if "three" is a file. The others we dereference and catch
170   // not-a-directory along the way, but the last one we must explicitly
171   // test for. Might as well do it up front.
172
173   if (!fstatat(atfd, dir, &buf, 0) && !S_ISDIR(buf.st_mode)) {
174     errno = EEXIST;
175     return 1;
176   }
177
178   for (s = dir; ;s++) {
179     char save = 0;
180     mode_t mode = (0777&~toys.old_umask)|0300;
181
182     // find next '/', but don't try to mkdir "" at start of absolute path
183     if (*s == '/' && (flags&2) && s != dir) {
184       save = *s;
185       *s = 0;
186     } else if (*s) continue;
187
188     // Use the mode from the -m option only for the last directory.
189     if (!save) {
190       if (flags&1) mode = lastmode;
191       else break;
192     }
193
194     if (mkdirat(atfd, dir, mode)) {
195       if (!(flags&2) || errno != EEXIST) return 1;
196     } else if (flags&4)
197       fprintf(stderr, "%s: created directory '%s'\n", toys.which->name, dir);
198
199     if (!(*s = save)) break;
200   }
201
202   return 0;
203 }
204
205 // Split a path into linked list of components, tracking head and tail of list.
206 // Filters out // entries with no contents.
207 struct string_list **splitpath(char *path, struct string_list **list)
208 {
209   char *new = path;
210
211   *list = 0;
212   do {
213     int len;
214
215     if (*path && *path != '/') continue;
216     len = path-new;
217     if (len > 0) {
218       *list = xmalloc(sizeof(struct string_list) + len + 1);
219       (*list)->next = 0;
220       memcpy((*list)->str, new, len);
221       (*list)->str[len] = 0;
222       list = &(*list)->next;
223     }
224     new = path+1;
225   } while (*path++);
226
227   return list;
228 }
229
230 // Find all file in a colon-separated path with access type "type" (generally
231 // X_OK or R_OK).  Returns a list of absolute paths to each file found, in
232 // order.
233
234 struct string_list *find_in_path(char *path, char *filename)
235 {
236   struct string_list *rlist = NULL, **prlist=&rlist;
237   char *cwd;
238
239   if (!path) return 0;
240
241   cwd = xgetcwd();
242   for (;;) {
243     char *next = strchr(path, ':');
244     int len = next ? next-path : strlen(path);
245     struct string_list *rnext;
246     struct stat st;
247
248     rnext = xmalloc(sizeof(void *) + strlen(filename)
249       + (len ? len : strlen(cwd)) + 2);
250     if (!len) sprintf(rnext->str, "%s/%s", cwd, filename);
251     else {
252       char *res = rnext->str;
253
254       memcpy(res, path, len);
255       res += len;
256       *(res++) = '/';
257       strcpy(res, filename);
258     }
259
260     // Confirm it's not a directory.
261     if (!stat(rnext->str, &st) && S_ISREG(st.st_mode)) {
262       *prlist = rnext;
263       rnext->next = NULL;
264       prlist = &(rnext->next);
265     } else free(rnext);
266
267     if (!next) break;
268     path += len;
269     path++;
270   }
271   free(cwd);
272
273   return rlist;
274 }
275
276 long long estrtol(char *str, char **end, int base)
277 {
278   errno = 0;
279
280   return strtoll(str, end, base);
281 }
282
283 long long xstrtol(char *str, char **end, int base)
284 {
285   long long l = estrtol(str, end, base);
286
287   if (errno) perror_exit_raw(str);
288
289   return l;
290 }
291
292 // atol() with the kilo/mega/giga/tera/peta/exa extensions.
293 // (zetta and yotta don't fit in 64 bits.)
294 long long atolx(char *numstr)
295 {
296   char *c = numstr, *suffixes="cbkmgtpe", *end;
297   long long val;
298
299   val = xstrtol(numstr, &c, 0);
300   if (c != numstr && *c && (end = strchr(suffixes, tolower(*c)))) {
301     int shift = end-suffixes-2;
302
303     if (shift >= 0) {
304       if (toupper(*++c)=='d') do val *= 1000; while (shift--);
305       else val *= 1024LL<<(shift*10);
306     }
307   }
308   while (isspace(*c)) c++;
309   if (c==numstr || *c) error_exit("not integer: %s", numstr);
310
311   return val;
312 }
313
314 long long atolx_range(char *numstr, long long low, long long high)
315 {
316   long long val = atolx(numstr);
317
318   if (val < low) error_exit("%lld < %lld", val, low);
319   if (val > high) error_exit("%lld > %lld", val, high);
320
321   return val;
322 }
323
324 int stridx(char *haystack, char needle)
325 {
326   char *off;
327
328   if (!needle) return -1;
329   off = strchr(haystack, needle);
330   if (!off) return -1;
331
332   return off-haystack;
333 }
334
335 char *strlower(char *s)
336 {
337   char *try, *new;
338
339   if (!CFG_TOYBOX_I18N) {
340     try = new = xstrdup(s);
341     for (; *s; s++) *(new++) = tolower(*s);
342   } else {
343     // I can't guarantee the string _won't_ expand during reencoding, so...?
344     try = new = xmalloc(strlen(s)*2+1);
345
346     while (*s) {
347       wchar_t c;
348       int len = mbrtowc(&c, s, MB_CUR_MAX, 0);
349
350       if (len < 1) *(new++) = *(s++);
351       else {
352         s += len;
353         // squash title case too
354         c = towlower(c);
355
356         // if we had a valid utf8 sequence, convert it to lower case, and can't
357         // encode back to utf8, something is wrong with your libc. But just
358         // in case somebody finds an exploit...
359         len = wcrtomb(new, c, 0);
360         if (len < 1) error_exit("bad utf8 %x", (int)c);
361         new += len;
362       }
363     }
364     *new = 0;
365   }
366
367   return try;
368 }
369
370 // strstr but returns pointer after match
371 char *strafter(char *haystack, char *needle)
372 {
373   char *s = strstr(haystack, needle);
374
375   return s ? s+strlen(needle) : s;
376 }
377
378 // Remove trailing \n
379 char *chomp(char *s)
380 {
381   char *p = strrchr(s, '\n');
382
383   if (p && !p[1]) *p = 0;
384   return s;
385 }
386
387 int unescape(char c)
388 {
389   char *from = "\\abefnrtv", *to = "\\\a\b\033\f\n\r\t\v";
390   int idx = stridx(from, c);
391
392   return (idx == -1) ? 0 : to[idx];
393 }
394
395 // If *a starts with b, advance *a past it and return 1, else return 0;
396 int strstart(char **a, char *b)
397 {
398   int len = strlen(b), i = !strncmp(*a, b, len);
399
400   if (i) *a += len;
401
402   return i;
403 }
404
405 // Return how long the file at fd is, if there's any way to determine it.
406 off_t fdlength(int fd)
407 {
408   struct stat st;
409   off_t base = 0, range = 1, expand = 1, old;
410
411   if (!fstat(fd, &st) && S_ISREG(st.st_mode)) return st.st_size;
412
413   // If the ioctl works for this, return it.
414   // TODO: is blocksize still always 512, or do we stat for it?
415   // unsigned int size;
416   // if (ioctl(fd, BLKGETSIZE, &size) >= 0) return size*512L;
417
418   // If not, do a binary search for the last location we can read.  (Some
419   // block devices don't do BLKGETSIZE right.)  This should probably have
420   // a CONFIG option...
421
422   // If not, do a binary search for the last location we can read.
423
424   old = lseek(fd, 0, SEEK_CUR);
425   do {
426     char temp;
427     off_t pos = base + range / 2;
428
429     if (lseek(fd, pos, 0)>=0 && read(fd, &temp, 1)==1) {
430       off_t delta = (pos + 1) - base;
431
432       base += delta;
433       if (expand) range = (expand <<= 1) - base;
434       else range -= delta;
435     } else {
436       expand = 0;
437       range = pos - base;
438     }
439   } while (range > 0);
440
441   lseek(fd, old, SEEK_SET);
442
443   return base;
444 }
445
446 // Read contents of file as a single nul-terminated string.
447 // measure file size if !len, allocate buffer if !buf
448 // Existing buffers need len in *plen
449 // Returns amount of data read in *plen
450 char *readfileat(int dirfd, char *name, char *ibuf, off_t *plen)
451 {
452   off_t len, rlen;
453   int fd;
454   char *buf, *rbuf;
455
456   // Unsafe to probe for size with a supplied buffer, don't ever do that.
457   if (CFG_TOYBOX_DEBUG && (ibuf ? !*plen : *plen)) error_exit("bad readfileat");
458
459   if (-1 == (fd = openat(dirfd, name, O_RDONLY))) return 0;
460
461   // If we dunno the length, probe it. If we can't probe, start with 1 page.
462   if (!*plen) {
463     if ((len = fdlength(fd))>0) *plen = len;
464     else len = 4096;
465   } else len = *plen-1;
466
467   if (!ibuf) buf = xmalloc(len+1);
468   else buf = ibuf;
469
470   for (rbuf = buf;;) {
471     rlen = readall(fd, rbuf, len);
472     if (*plen || rlen<len) break;
473
474     // If reading unknown size, expand buffer by 1.5 each time we fill it up.
475     rlen += rbuf-buf;
476     buf = xrealloc(buf, len = (rlen*3)/2);
477     rbuf = buf+rlen;
478     len -= rlen;
479   }
480   *plen = len = rlen+(rbuf-buf);
481   close(fd);
482
483   if (rlen<0) {
484     if (ibuf != buf) free(buf);
485     buf = 0;
486   } else buf[len] = 0;
487
488   return buf;
489 }
490
491 char *readfile(char *name, char *ibuf, off_t len)
492 {
493   return readfileat(AT_FDCWD, name, ibuf, &len);
494 }
495
496 // Sleep for this many thousandths of a second
497 void msleep(long miliseconds)
498 {
499   struct timespec ts;
500
501   ts.tv_sec = miliseconds/1000;
502   ts.tv_nsec = (miliseconds%1000)*1000000;
503   nanosleep(&ts, &ts);
504 }
505
506 // Inefficient, but deals with unaligned access
507 int64_t peek_le(void *ptr, unsigned size)
508 {
509   int64_t ret = 0;
510   char *c = ptr;
511   int i;
512
513   for (i=0; i<size; i++) ret |= ((int64_t)c[i])<<(i*8);
514   return ret;
515 }
516
517 int64_t peek_be(void *ptr, unsigned size)
518 {
519   int64_t ret = 0;
520   char *c = ptr;
521   int i;
522
523   for (i=0; i<size; i++) ret = (ret<<8)|(c[i]&0xff);
524   return ret;
525 }
526
527 int64_t peek(void *ptr, unsigned size)
528 {
529   return IS_BIG_ENDIAN ? peek_be(ptr, size) : peek_le(ptr, size);
530 }
531
532 void poke(void *ptr, uint64_t val, int size)
533 {
534   if (size & 8) {
535     volatile uint64_t *p = (uint64_t *)ptr;
536     *p = val;
537   } else if (size & 4) {
538     volatile int *p = (int *)ptr;
539     *p = val;
540   } else if (size & 2) {
541     volatile short *p = (short *)ptr;
542     *p = val;
543   } else {
544     volatile char *p = (char *)ptr;
545     *p = val;
546   }
547 }
548
549 // Iterate through an array of files, opening each one and calling a function
550 // on that filehandle and name. The special filename "-" means stdin if
551 // flags is O_RDONLY, stdout otherwise. An empty argument list calls
552 // function() on just stdin/stdout.
553 //
554 // Note: pass O_CLOEXEC to automatically close filehandles when function()
555 // returns, otherwise filehandles must be closed by function().
556 // pass WARN_ONLY to produce warning messages about files it couldn't
557 // open/create, and skip them. Otherwise function is called with fd -1.
558 void loopfiles_rw(char **argv, int flags, int permissions,
559   void (*function)(int fd, char *name))
560 {
561   int fd, failok = !(flags&WARN_ONLY);
562
563   flags &= ~WARN_ONLY;
564
565   // If no arguments, read from stdin.
566   if (!*argv) function((flags & O_ACCMODE) != O_RDONLY ? 1 : 0, "-");
567   else do {
568     // Filename "-" means read from stdin.
569     // Inability to open a file prints a warning, but doesn't exit.
570
571     if (!strcmp(*argv, "-")) fd = 0;
572     else if (0>(fd = notstdio(open(*argv, flags, permissions))) && !failok) {
573       perror_msg_raw(*argv);
574       continue;
575     }
576     function(fd, *argv);
577     if ((flags & O_CLOEXEC) && fd) close(fd);
578   } while (*++argv);
579 }
580
581 // Call loopfiles_rw with O_RDONLY|O_CLOEXEC|WARN_ONLY (common case)
582 void loopfiles(char **argv, void (*function)(int fd, char *name))
583 {
584   loopfiles_rw(argv, O_RDONLY|O_CLOEXEC|WARN_ONLY, 0, function);
585 }
586
587 // Slow, but small.
588
589 char *get_rawline(int fd, long *plen, char end)
590 {
591   char c, *buf = NULL;
592   long len = 0;
593
594   for (;;) {
595     if (1>read(fd, &c, 1)) break;
596     if (!(len & 63)) buf=xrealloc(buf, len+65);
597     if ((buf[len++]=c) == end) break;
598   }
599   if (buf) buf[len]=0;
600   if (plen) *plen = len;
601
602   return buf;
603 }
604
605 char *get_line(int fd)
606 {
607   long len;
608   char *buf = get_rawline(fd, &len, '\n');
609
610   if (buf && buf[--len]=='\n') buf[len]=0;
611
612   return buf;
613 }
614
615 int wfchmodat(int fd, char *name, mode_t mode)
616 {
617   int rc = fchmodat(fd, name, mode, 0);
618
619   if (rc) {
620     perror_msg("chmod '%s' to %04o", name, mode);
621     toys.exitval=1;
622   }
623   return rc;
624 }
625
626 static char *tempfile2zap;
627 static void tempfile_handler(void)
628 {
629   if (1 < (long)tempfile2zap) unlink(tempfile2zap);
630 }
631
632 // Open a temporary file to copy an existing file into.
633 int copy_tempfile(int fdin, char *name, char **tempname)
634 {
635   struct stat statbuf;
636   int fd;
637
638   *tempname = xmprintf("%s%s", name, "XXXXXX");
639   if(-1 == (fd = mkstemp(*tempname))) error_exit("no temp file");
640   if (!tempfile2zap) sigatexit(tempfile_handler);
641   tempfile2zap = *tempname;
642
643   // Set permissions of output file (ignoring errors, usually due to nonroot)
644
645   fstat(fdin, &statbuf);
646   fchmod(fd, statbuf.st_mode);
647
648   // It's fine if this fails (generally because we're not root), but gcc no
649   // longer lets a (void) typecast silence the "unused result" warning, so...
650   if (fchown(fd, statbuf.st_uid, statbuf.st_gid));
651
652   return fd;
653 }
654
655 // Abort the copy and delete the temporary file.
656 void delete_tempfile(int fdin, int fdout, char **tempname)
657 {
658   close(fdin);
659   close(fdout);
660   if (*tempname) unlink(*tempname);
661   tempfile2zap = (char *)1;
662   free(*tempname);
663   *tempname = NULL;
664 }
665
666 // Copy the rest of the data and replace the original with the copy.
667 void replace_tempfile(int fdin, int fdout, char **tempname)
668 {
669   char *temp = xstrdup(*tempname);
670
671   temp[strlen(temp)-6]=0;
672   if (fdin != -1) {
673     xsendfile(fdin, fdout);
674     xclose(fdin);
675   }
676   xclose(fdout);
677   rename(*tempname, temp);
678   tempfile2zap = (char *)1;
679   free(*tempname);
680   free(temp);
681   *tempname = NULL;
682 }
683
684 // Create a 256 entry CRC32 lookup table.
685
686 void crc_init(unsigned int *crc_table, int little_endian)
687 {
688   unsigned int i;
689
690   // Init the CRC32 table (big endian)
691   for (i=0; i<256; i++) {
692     unsigned int j, c = little_endian ? i : i<<24;
693     for (j=8; j; j--)
694       if (little_endian) c = (c&1) ? (c>>1)^0xEDB88320 : c>>1;
695       else c=c&0x80000000 ? (c<<1)^0x04c11db7 : (c<<1);
696     crc_table[i] = c;
697   }
698 }
699
700 // Init base64 table
701
702 void base64_init(char *p)
703 {
704   int i;
705
706   for (i = 'A'; i != ':'; i++) {
707     if (i == 'Z'+1) i = 'a';
708     if (i == 'z'+1) i = '0';
709     *(p++) = i;
710   }
711   *(p++) = '+';
712   *(p++) = '/';
713 }
714
715 int yesno(int def)
716 {
717   char buf;
718
719   fprintf(stderr, " (%c/%c):", def ? 'Y' : 'y', def ? 'n' : 'N');
720   fflush(stderr);
721   while (fread(&buf, 1, 1, stdin)) {
722     int new;
723
724     // The letter changes the value, the newline (or space) returns it.
725     if (isspace(buf)) break;
726     if (-1 != (new = stridx("ny", tolower(buf)))) def = new;
727   }
728
729   return def;
730 }
731
732 struct signame {
733   int num;
734   char *name;
735 };
736
737 // Signals required by POSIX 2008:
738 // http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/signal.h.html
739
740 #define SIGNIFY(x) {SIG##x, #x}
741
742 static struct signame signames[] = {
743   SIGNIFY(ABRT), SIGNIFY(ALRM), SIGNIFY(BUS),
744   SIGNIFY(FPE), SIGNIFY(HUP), SIGNIFY(ILL), SIGNIFY(INT), SIGNIFY(KILL),
745   SIGNIFY(PIPE), SIGNIFY(QUIT), SIGNIFY(SEGV), SIGNIFY(TERM),
746   SIGNIFY(USR1), SIGNIFY(USR2), SIGNIFY(SYS), SIGNIFY(TRAP),
747   SIGNIFY(VTALRM), SIGNIFY(XCPU), SIGNIFY(XFSZ),
748
749   // Start of non-terminal signals
750
751   SIGNIFY(CHLD), SIGNIFY(CONT), SIGNIFY(STOP), SIGNIFY(TSTP),
752   SIGNIFY(TTIN), SIGNIFY(TTOU), SIGNIFY(URG)
753 };
754
755 // not in posix: SIGNIFY(STKFLT), SIGNIFY(WINCH), SIGNIFY(IO), SIGNIFY(PWR)
756 // obsolete: SIGNIFY(PROF) SIGNIFY(POLL)
757
758 // Handler that sets toys.signal, and writes to toys.signalfd if set
759 void generic_signal(int sig)
760 {
761   if (toys.signalfd) {
762     char c = sig;
763
764     writeall(toys.signalfd, &c, 1);
765   }
766   toys.signal = sig;
767 }
768
769 void exit_signal(int sig)
770 {
771   if (sig) toys.exitval = sig|128;
772   xexit();
773 }
774
775 // Install the same handler on every signal that defaults to killing the
776 // process, calling the handler on the way out. Calling multiple times
777 // adds the handlers to a list, to be called in order.
778 void sigatexit(void *handler)
779 {
780   struct arg_list *al = xmalloc(sizeof(struct arg_list));
781   int i;
782
783   for (i=0; signames[i].num != SIGCHLD; i++)
784     signal(signames[i].num, exit_signal);
785   al->next = toys.xexit;
786   al->arg = handler;
787   toys.xexit = al;
788 }
789
790 // Convert name to signal number.  If name == NULL print names.
791 int sig_to_num(char *pidstr)
792 {
793   int i;
794
795   if (pidstr) {
796     char *s;
797
798     i = estrtol(pidstr, &s, 10);
799     if (!errno && !*s) return i;
800
801     if (!strncasecmp(pidstr, "sig", 3)) pidstr+=3;
802   }
803   for (i = 0; i < sizeof(signames)/sizeof(struct signame); i++)
804     if (!pidstr) xputs(signames[i].name);
805     else if (!strcasecmp(pidstr, signames[i].name)) return signames[i].num;
806
807   return -1;
808 }
809
810 char *num_to_sig(int sig)
811 {
812   int i;
813
814   for (i=0; i<sizeof(signames)/sizeof(struct signame); i++)
815     if (signames[i].num == sig) return signames[i].name;
816   return NULL;
817 }
818
819 // premute mode bits based on posix mode strings.
820 mode_t string_to_mode(char *modestr, mode_t mode)
821 {
822   char *whos = "ogua", *hows = "=+-", *whats = "xwrstX", *whys = "ogu",
823        *s, *str = modestr;
824   mode_t extrabits = mode & ~(07777);
825
826   // Handle octal mode
827   if (isdigit(*str)) {
828     mode = estrtol(str, &s, 8);
829     if (errno || *s || (mode & ~(07777))) goto barf;
830
831     return mode | extrabits;
832   }
833
834   // Gaze into the bin of permission...
835   for (;;) {
836     int i, j, dowho, dohow, dowhat, amask;
837
838     dowho = dohow = dowhat = amask = 0;
839
840     // Find the who, how, and what stanzas, in that order
841     while (*str && (s = strchr(whos, *str))) {
842       dowho |= 1<<(s-whos);
843       str++;
844     }
845     // If who isn't specified, like "a" but honoring umask.
846     if (!dowho) {
847       dowho = 8;
848       umask(amask=umask(0));
849     }
850     if (!*str || !(s = strchr(hows, *str))) goto barf;
851     dohow = *(str++);
852
853     if (!dohow) goto barf;
854     while (*str && (s = strchr(whats, *str))) {
855       dowhat |= 1<<(s-whats);
856       str++;
857     }
858
859     // Convert X to x for directory or if already executable somewhere
860     if ((dowhat&32) &&  (S_ISDIR(mode) || (mode&0111))) dowhat |= 1;
861
862     // Copy mode from another category?
863     if (!dowhat && *str && (s = strchr(whys, *str))) {
864       dowhat = (mode>>(3*(s-whys)))&7;
865       str++;
866     }
867
868     // Are we ready to do a thing yet?
869     if (*str && *(str++) != ',') goto barf;
870
871     // Ok, apply the bits to the mode.
872     for (i=0; i<4; i++) {
873       for (j=0; j<3; j++) {
874         mode_t bit = 0;
875         int where = 1<<((3*i)+j);
876
877         if (amask & where) continue;
878
879         // Figure out new value at this location
880         if (i == 3) {
881           // suid/sticky bit.
882           if (j) {
883             if ((dowhat & 8) && (dowho&(8|(1<<i)))) bit++;
884           } else if (dowhat & 16) bit++;
885         } else {
886           if (!(dowho&(8|(1<<i)))) continue;
887           if (dowhat&(1<<j)) bit++;
888         }
889
890         // When selection active, modify bit
891
892         if (dohow == '=' || (bit && dohow == '-')) mode &= ~where;
893         if (bit && dohow != '-') mode |= where;
894       }
895     }
896
897     if (!*str) break;
898   }
899
900   return mode|extrabits;
901 barf:
902   error_exit("bad mode '%s'", modestr);
903 }
904
905 // Format access mode into a drwxrwxrwx string
906 void mode_to_string(mode_t mode, char *buf)
907 {
908   char c, d;
909   int i, bit;
910
911   buf[10]=0;
912   for (i=0; i<9; i++) {
913     bit = mode & (1<<i);
914     c = i%3;
915     if (!c && (mode & (1<<((d=i/3)+9)))) {
916       c = "tss"[d];
917       if (!bit) c &= ~0x20;
918     } else c = bit ? "xwr"[c] : '-';
919     buf[9-i] = c;
920   }
921
922   if (S_ISDIR(mode)) c = 'd';
923   else if (S_ISBLK(mode)) c = 'b';
924   else if (S_ISCHR(mode)) c = 'c';
925   else if (S_ISLNK(mode)) c = 'l';
926   else if (S_ISFIFO(mode)) c = 'p';
927   else if (S_ISSOCK(mode)) c = 's';
928   else c = '-';
929   *buf = c;
930 }
931
932 // basename() can modify its argument or return a pointer to a constant string
933 // This just gives after the last '/' or the whole stirng if no /
934 char *getbasename(char *name)
935 {
936   char *s = strrchr(name, '/');
937
938   if (s) return s+1;
939
940   return name;
941 }
942
943 // Execute a callback for each PID that matches a process name from a list.
944 void names_to_pid(char **names, int (*callback)(pid_t pid, char *name))
945 {
946   DIR *dp;
947   struct dirent *entry;
948
949   if (!(dp = opendir("/proc"))) perror_exit("opendir");
950
951   while ((entry = readdir(dp))) {
952     unsigned u;
953     char *cmd, **curname;
954
955     if (!(u = atoi(entry->d_name))) continue;
956     sprintf(libbuf, "/proc/%u/cmdline", u);
957     if (!(cmd = readfile(libbuf, libbuf, sizeof(libbuf)))) continue;
958
959     for (curname = names; *curname; curname++)
960       if (**curname == '/' ? !strcmp(cmd, *curname)
961           : !strcmp(getbasename(cmd), getbasename(*curname)))
962         if (callback(u, *curname)) break;
963     if (*curname) break;
964   }
965   closedir(dp);
966 }
967
968 // display first few digits of number with power of two units
969 int human_readable(char *buf, unsigned long long num, int style)
970 {
971   unsigned long long snap = 0;
972   int len, unit, divisor = (style&HR_1000) ? 1000 : 1024;
973
974   // Divide rounding up until we have 3 or fewer digits. Since the part we
975   // print is decimal, the test is 999 even when we divide by 1024.
976   // We can't run out of units because 2<<64 is 18 exabytes.
977   // test 5675 is 5.5k not 5.6k.
978   for (unit = 0; num > 999; unit++) num = ((snap = num)+(divisor/2))/divisor;
979   len = sprintf(buf, "%llu", num);
980   if (unit && len == 1) {
981     // Redo rounding for 1.2M case, this works with and without HR_1000.
982     num = snap/divisor;
983     snap -= num*divisor;
984     snap = ((snap*100)+50)/divisor;
985     snap /= 10;
986     len = sprintf(buf, "%llu.%llu", num, snap);
987   }
988   if (style & HR_SPACE) buf[len++] = ' ';
989   if (unit) {
990     unit = " kMGTPE"[unit];
991
992     if (!(style&HR_1000)) unit = toupper(unit);
993     buf[len++] = unit;
994   } else if (style & HR_B) buf[len++] = 'B';
995   buf[len] = 0;
996
997   return len;
998 }
999
1000 // The qsort man page says you can use alphasort, the posix committee
1001 // disagreed, and doubled down: http://austingroupbugs.net/view.php?id=142
1002 // So just do our own. (The const is entirely to humor the stupid compiler.)
1003 int qstrcmp(const void *a, const void *b)
1004 {
1005   return strcmp(*(char **)a, *(char **)b);
1006 }
1007
1008 // According to http://www.opengroup.org/onlinepubs/9629399/apdxa.htm
1009 // we should generate a uuid structure by reading a clock with 100 nanosecond
1010 // precision, normalizing it to the start of the gregorian calendar in 1582,
1011 // and looking up our eth0 mac address.
1012 //
1013 // On the other hand, we have 128 bits to come up with a unique identifier, of
1014 // which 6 have a defined value.  /dev/urandom it is.
1015
1016 void create_uuid(char *uuid)
1017 {
1018   // Read 128 random bits
1019   int fd = xopenro("/dev/urandom");
1020   xreadall(fd, uuid, 16);
1021   close(fd);
1022
1023   // Claim to be a DCE format UUID.
1024   uuid[6] = (uuid[6] & 0x0F) | 0x40;
1025   uuid[8] = (uuid[8] & 0x3F) | 0x80;
1026
1027   // rfc2518 section 6.4.1 suggests if we're not using a macaddr, we should
1028   // set bit 1 of the node ID, which is the mac multicast bit.  This means we
1029   // should never collide with anybody actually using a macaddr.
1030   uuid[11] |= 128;
1031 }
1032
1033 char *show_uuid(char *uuid)
1034 {
1035   char *out = libbuf;
1036   int i;
1037
1038   for (i=0; i<16; i++) out+=sprintf(out, "-%02x"+!(0x550&(1<<i)), uuid[i]);
1039   *out = 0;
1040
1041   return libbuf;
1042 }
1043
1044 // Returns pointer to letter at end, 0 if none. *start = initial %
1045 char *next_printf(char *s, char **start)
1046 {
1047   for (; *s; s++) {
1048     if (*s != '%') continue;
1049     if (*++s == '%') continue;
1050     if (start) *start = s-1;
1051     while (0 <= stridx("0'#-+ ", *s)) s++;
1052     while (isdigit(*s)) s++;
1053     if (*s == '.') s++;
1054     while (isdigit(*s)) s++;
1055
1056     return s;
1057   }
1058
1059   return 0;
1060 }
1061
1062 // Posix inexplicably hasn't got this, so find str in line.
1063 char *strnstr(char *line, char *str)
1064 {
1065   long len = strlen(str);
1066   char *s;
1067
1068   for (s = line; *s; s++) if (!strncasecmp(s, str, len)) break;
1069
1070   return *s ? s : 0;
1071 }
1072
1073 int dev_minor(int dev)
1074 {
1075   return ((dev&0xfff00000)>>12)|(dev&0xff);
1076 }
1077
1078 int dev_major(int dev)
1079 {
1080   return (dev&0xfff00)>>8;
1081 }
1082
1083 int dev_makedev(int major, int minor)
1084 {
1085   return (minor&0xff)|((major&0xfff)<<8)|((minor&0xfff00)<<12);
1086 }
1087
1088 // Return cached passwd entries.
1089 struct passwd *bufgetpwuid(uid_t uid)
1090 {
1091   struct pwuidbuf_list {
1092     struct pwuidbuf_list *next;
1093     struct passwd pw;
1094   } *list;
1095   struct passwd *temp;
1096   static struct pwuidbuf_list *pwuidbuf;
1097
1098   for (list = pwuidbuf; list; list = list->next)
1099     if (list->pw.pw_uid == uid) return &(list->pw);
1100
1101   list = xmalloc(512);
1102   list->next = pwuidbuf;
1103
1104   errno = getpwuid_r(uid, &list->pw, sizeof(*list)+(char *)list,
1105     512-sizeof(*list), &temp);
1106   if (!temp) {
1107     free(list);
1108
1109     return 0;
1110   }
1111   pwuidbuf = list;
1112
1113   return &list->pw;
1114 }
1115
1116 // Return cached passwd entries.
1117 struct group *bufgetgrgid(gid_t gid)
1118 {
1119   struct grgidbuf_list {
1120     struct grgidbuf_list *next;
1121     struct group gr;
1122   } *list;
1123   struct group *temp;
1124   static struct grgidbuf_list *grgidbuf;
1125
1126   for (list = grgidbuf; list; list = list->next)
1127     if (list->gr.gr_gid == gid) return &(list->gr);
1128
1129   list = xmalloc(512);
1130   list->next = grgidbuf;
1131
1132   errno = getgrgid_r(gid, &list->gr, sizeof(*list)+(char *)list,
1133     512-sizeof(*list), &temp);
1134   if (!temp) {
1135     free(list);
1136
1137     return 0;
1138   }
1139   grgidbuf = list;
1140
1141   return &list->gr;
1142 }
1143
1144 // Always null terminates, returns 0 for failure, len for success
1145 int readlinkat0(int dirfd, char *path, char *buf, int len)
1146 {
1147   if (!len) return 0;
1148
1149   len = readlinkat(dirfd, path, buf, len-1);
1150   if (len<1) return 0;
1151   buf[len] = 0;
1152
1153   return len;
1154 }
1155
1156 int readlink0(char *path, char *buf, int len)
1157 {
1158   return readlinkat0(AT_FDCWD, path, buf, len);
1159 }
1160
1161 // Do regex matching handling embedded NUL bytes in string (hence extra len
1162 // argument). Note that neither the pattern nor the match can currently include
1163 // NUL bytes (even with wildcards) and string must be null terminated at
1164 // string[len]. But this can find a match after the first NUL.
1165 int regexec0(regex_t *preg, char *string, long len, int nmatch,
1166   regmatch_t pmatch[], int eflags)
1167 {
1168   char *s = string;
1169
1170   for (;;) {
1171     long ll = 0;
1172     int rc;
1173
1174     while (len && !*s) {
1175       s++;
1176       len--;
1177     }
1178     while (s[ll] && ll<len) ll++;
1179
1180     rc = regexec(preg, s, nmatch, pmatch, eflags);
1181     if (!rc) {
1182       for (rc = 0; rc<nmatch && pmatch[rc].rm_so!=-1; rc++) {
1183         pmatch[rc].rm_so += s-string;
1184         pmatch[rc].rm_eo += s-string;
1185       }
1186
1187       return 0;
1188     }
1189     if (ll==len) return rc;
1190
1191     s += ll;
1192     len -= ll;
1193   }
1194 }
1195
1196 // Return user name or string representation of number, returned buffer
1197 // lasts until next call.
1198 char *getusername(uid_t uid)
1199 {
1200   struct passwd *pw = bufgetpwuid(uid);
1201   static char unum[12];
1202
1203   sprintf(unum, "%u", (unsigned)uid);
1204   return pw ? pw->pw_name : unum;
1205 }
1206
1207 // Return group name or string representation of number, returned buffer
1208 // lasts until next call.
1209 char *getgroupname(gid_t gid)
1210 {
1211   struct group *gr = bufgetgrgid(gid);
1212   static char gnum[12];
1213
1214   sprintf(gnum, "%u", (unsigned)gid);
1215   return gr ? gr->gr_name : gnum;
1216 }
1217
1218 // Iterate over lines in file, calling function. Function can write 0 to
1219 // the line pointer if they want to keep it, or 1 to terminate processing,
1220 // otherwise line is freed. Passed file descriptor is closed at the end.
1221 void do_lines(int fd, void (*call)(char **pline, long len))
1222 {
1223   FILE *fp = fd ? xfdopen(fd, "r") : stdin;
1224
1225   for (;;) {
1226     char *line = 0;
1227     ssize_t len;
1228
1229     len = getline(&line, (void *)&len, fp);
1230     if (len > 0) {
1231       call(&line, len);
1232       if (line == (void *)1) break;
1233       free(line);
1234     } else break;
1235   }
1236
1237   if (fd) fclose(fp);
1238 }