utils.h

   1 /*
   2  * Main functions of the program.
   3  *
   4  * Copyright (C) 2007 David Härdeman <david@hardeman.nu>
   5  *
   6  *      This program is free software; you can redistribute it and/or modify it
   7  *      under the terms of the GNU General Public License as published by the
   8  *      Free Software Foundation version 2 of the License.
   9  *
  10  *      This program is distributed in the hope that it will be useful, but
  11  *      WITHOUT ANY WARRANTY; without even the implied warranty of
  12  *      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  *      General Public License for more details.
  14  *
  15  *      You should have received a copy of the GNU General Public License along
  16  *      with this program; if not, write to the Free Software Foundation, Inc.,
  17  *      51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  18  *
  19  */
  20
  21 /* For uint64_t */
  22 #include <stdint.h>
  23 /* For ssize_t */
  24 #include <unistd.h>
  25 /* For FILE */
  26 #include <stdio.h>
  27 /* For struct passwd */
  28 #include <pwd.h>
  29 /* For struct group */
  30 #include <grp.h>
  31
  32 /* Adjusts the verbosity level for msg() */
  33 void adjust_verbosity(int adj);
  34
  35 /* Verbosity levels using stdout */
  36 #define MSG_NORMAL    0
  37 #define MSG_DEBUG     1
  38 #define MSG_QUIET    -1
  39 /* Verbosity levels using stderr */
  40 #define MSG_ERROR    -2
  41 #define MSG_CRITICAL -3
  42
  43 /* Prints messages to console according to the current verbosity */
  44 int msg(int level, const char *fmt, ...);
  45
  46 /* Malloc which either succeeds or exits */
  47 void *xmalloc(size_t size);
  48
  49 /* Ditto for strdup */
  50 char *xstrdup(const char *s);
  51
  52 /* Human-readable printout of binary data */
  53 void binary_print(const char *s, ssize_t len);
  54
  55 /* Writes data to a file or exits on failure */
  56 void xfwrite(const void *ptr, size_t size, FILE *stream);
  57
  58 /* Writes an int to a file, using len bytes, in bigendian order */
  59 void write_int(uint64_t value, size_t len, FILE *to);
  60
  61 /* Writes a binary string to a file */
  62 void write_binary_string(const char *string, size_t len, FILE *to);
  63
  64 /* Writes a normal C string to a file */
  65 void write_string(const char *string, FILE *to);
  66
  67 /* Reads an int from a file, using len bytes, in bigendian order */
  68 uint64_t read_int(char **from, size_t len, const char *max);
  69
  70 /* Reads a binary string from a file */
  71 char *read_binary_string(char **from, size_t len, const char *max);
  72
  73 /* Reads a normal C string from a file */
  74 char *read_string(char **from, const char *max);
  75
  76 /* Caching version of getgrnam */
  77 struct group *xgetgrnam(const char *name);
  78
  79 /* Caching version of getgrgid */
  80 struct group *xgetgrgid(gid_t gid);
  81
  82 /* Caching version of getpwnam */
  83 struct passwd *xgetpwnam(const char *name);
  84
  85 /* Caching version of getpwuid */
  86 struct passwd *xgetpwuid(uid_t uid);
  87