lib/util.h

   1 /** \file lib/util.h
   2  *  \brief Header: various utilities
   3  */
   4
   5 #ifndef MC_UTIL_H
   6 #define MC_UTIL_H
   7
   8 #include <sys/types.h>
   9 #include <sys/stat.h>
  10 #include <inttypes.h>           /* uintmax_t */
  11 #include <unistd.h>
  12
  13 #include "lib/global.h"         /* include <glib.h> */
  14
  15 #include "lib/vfs/vfs.h"
  16
  17 /*** typedefs(not structures) and defined constants **********************************************/
  18
  19 #ifndef MAXSYMLINKS
  20 #define MAXSYMLINKS 32
  21 #endif
  22
  23 #define MAX_SAVED_BOOKMARKS 10
  24
  25 #define MC_PTR_FREE(ptr) do { g_free (ptr); (ptr) = NULL; } while (0)
  26
  27 #define mc_return_if_error(mcerror) do { if (mcerror != NULL && *mcerror != NULL) return; } while (0)
  28 #define mc_return_val_if_error(mcerror, mcvalue) do { if (mcerror != NULL && *mcerror != NULL) return mcvalue; } while (0)
  29
  30 #define whitespace(c) ((c) == ' ' || (c) == '\t')
  31 #define whiteness(c) (whitespace (c) || (c) == '\n')
  32
  33 #define MC_PIPE_BUFSIZE BUF_8K
  34 #define MC_PIPE_STREAM_EOF 0
  35 #define MC_PIPE_STREAM_UNREAD -1
  36 #define MC_PIPE_ERROR_CREATE_PIPE -2
  37 #define MC_PIPE_ERROR_PARSE_COMMAND -3
  38 #define MC_PIPE_ERROR_CREATE_PIPE_STREAM -4
  39 #define MC_PIPE_ERROR_READ -5
  40
  41 /* gnulib efa15594e17fc20827dba66414fb391e99905394
  42
  43  *_GL_CMP (n1, n2) performs a three-valued comparison on n1 vs. n2.
  44  *  It returns
  45  *    1  if n1 > n2
  46  *    0  if n1 == n2
  47  *    -1 if n1 < n2
  48  *  The native code   (n1 > n2 ? 1 : n1 < n2 ? -1 : 0)  produces a conditional
  49  *  jump with nearly all GCC versions up to GCC 10.
  50  *  This variant      (n1 < n2 ? -1 : n1 > n2)  produces a conditional with many
  51  *  GCC versions up to GCC 9.
  52  *  The better code  (n1 > n2) - (n1 < n2)  from Hacker's Delight para 2-9
  53  *  avoids conditional jumps in all GCC versions >= 3.4.
  54  */
  55 #define _GL_CMP(n1, n2) (((n1) > (n2)) - ((n1) < (n2)))
  56
  57 /* Difference or zero */
  58 #define DOZ(a, b) ((a) > (b) ? (a) - (b) : 0)
  59
  60 /* flags for shell_execute */
  61 #define EXECUTE_INTERNAL (1 << 0)
  62 #define EXECUTE_AS_SHELL (1 << 2)
  63 #define EXECUTE_HIDE     (1 << 3)
  64
  65 /*** enums ***************************************************************************************/
  66
  67 /* Pathname canonicalization */
  68 /* *INDENT-OFF* */
  69 typedef enum
  70 {
  71     CANON_PATH_NOCHANGE = 0,
  72     CANON_PATH_JOINSLASHES = 1L << 0,   /**< Multiple '/'s are collapsed to a single '/' */
  73     CANON_PATH_REMSLASHDOTS = 1L << 1,  /**< Leading './'s, '/'s and trailing '/.'s are removed */
  74     CANON_PATH_REMDOUBLEDOTS = 1L << 3, /**< Non-leading '../'s and trailing '..'s are handled by removing
  75                                              portions of the path */
  76     CANON_PATH_GUARDUNC = 1L << 4,      /**< Detect and preserve UNC paths: //server/... */
  77     CANON_PATH_ALL = CANON_PATH_JOINSLASHES | CANON_PATH_REMSLASHDOTS
  78                    | CANON_PATH_REMDOUBLEDOTS | CANON_PATH_GUARDUNC  /**< All flags */
  79 } canon_path_flags_t;
  80 /* *INDENT-ON* */
  81
  82 enum compression_type
  83 {
  84     COMPRESSION_NONE,
  85     COMPRESSION_ZIP,
  86     COMPRESSION_GZIP,
  87     COMPRESSION_BZIP,
  88     COMPRESSION_BZIP2,
  89     COMPRESSION_LZIP,
  90     COMPRESSION_LZ4,
  91     COMPRESSION_LZMA,
  92     COMPRESSION_LZO,
  93     COMPRESSION_XZ,
  94     COMPRESSION_ZSTD,
  95 };
  96
  97 /* stdout or stderr stream of child process */
  98 typedef struct
  99 {
 100     /* file descriptor */
 101     int fd;
 102     /* data read from fd */
 103     char buf[MC_PIPE_BUFSIZE];
 104     /* current position in @buf (used by mc_pstream_get_string()) */
 105     size_t pos;
 106     /* positive: length of data in buf;
 107      * MC_PIPE_STREAM_EOF: EOF of fd;
 108      * MC_PIPE_STREAM_UNREAD: there was not read from fd;
 109      * MC_PIPE_ERROR_READ: reading error from fd.
 110      */
 111     ssize_t len;
 112     /* whether buf is null-terminated or not */
 113     gboolean null_term;
 114     /* error code in case of len == MC_PIPE_ERROR_READ */
 115     int error;
 116 } mc_pipe_stream_t;
 117
 118 /* Pipe descriptor for child process */
 119 typedef struct
 120 {
 121     /* PID of child process */
 122     GPid child_pid;
 123     /* stdout of child process */
 124     mc_pipe_stream_t out;
 125     /* stderr of child process */
 126     mc_pipe_stream_t err;
 127 } mc_pipe_t;
 128
 129 /*** structures declarations (and typedefs of structures)*****************************************/
 130
 131 /*** global variables defined in .c file *********************************************************/
 132
 133 extern struct sigaction startup_handler;
 134
 135 /*** declarations of public functions ************************************************************/
 136
 137 int is_printable (int c);
 138
 139 /* Quote the filename for the purpose of inserting it into the command
 140  * line.  If quote_percent is 1, replace "%" with "%%" - the percent is
 141  * processed by the mc command line. */
 142 char *name_quote (const char *c, gboolean quote_percent);
 143
 144 /* returns a duplicate of c. */
 145 char *fake_name_quote (const char *c, gboolean quote_percent);
 146
 147 /* path_trunc() is the same as str_trunc() but
 148  * it deletes possible password from path for security
 149  * reasons. */
 150 const char *path_trunc (const char *path, size_t trunc_len);
 151
 152 /* return a static string representing size, appending "K" or "M" for
 153  * big sizes.
 154  * NOTE: uses the same static buffer as size_trunc_sep. */
 155 const char *size_trunc (uintmax_t size, gboolean use_si);
 156
 157 /* return a static string representing size, appending "K" or "M" for
 158  * big sizes. Separates every three digits by ",".
 159  * NOTE: uses the same static buffer as size_trunc. */
 160 const char *size_trunc_sep (uintmax_t size, gboolean use_si);
 161
 162 /* Print file SIZE to BUFFER, but don't exceed LEN characters,
 163  * not including trailing 0. BUFFER should be at least LEN+1 long.
 164  *
 165  * Units: size units (0=bytes, 1=Kbytes, 2=Mbytes, etc.) */
 166 void size_trunc_len (char *buffer, unsigned int len, uintmax_t size, int units, gboolean use_si);
 167 const char *string_perm (mode_t mode_bits);
 168
 169 const char *extension (const char *);
 170 const char *unix_error_string (int error_num);
 171 const char *skip_separators (const char *s);
 172 const char *skip_numbers (const char *s);
 173 char *strip_ctrl_codes (char *s);
 174
 175 /* Replaces "\\E" and "\\e" with "\033". Replaces "^" + [a-z] with
 176  * ((char) 1 + (c - 'a')). The same goes for "^" + [A-Z].
 177  * Returns a newly allocated string. */
 178 char *convert_controls (const char *s);
 179
 180 /* overwrites passwd with '\0's and frees it. */
 181 void wipe_password (char *passwd);
 182
 183 char *diff_two_paths (const vfs_path_t * vpath1, const vfs_path_t * vpath2);
 184
 185 /* Returns the basename of fname. The result is a pointer into fname. */
 186 const char *x_basename (const char *fname);
 187
 188 char *load_mc_home_file (const char *from, const char *filename, char **allocated_filename,
 189                          size_t *length);
 190
 191 /* uid/gid managing */
 192 void init_groups (void);
 193 void destroy_groups (void);
 194 int get_user_permissions (struct stat *buf);
 195
 196 void init_uid_gid_cache (void);
 197 const char *get_group (gid_t gid);
 198 const char *get_owner (uid_t uid);
 199
 200 /* Returns a copy of *s until a \n is found and is below top */
 201 const const char *extract_line (const char *s, const char *top, size_t *len);
 202
 203 /* Process spawning */
 204 int my_system (int flags, const char *shell, const char *command);
 205 int my_systeml (int flags, const char *shell, ...);
 206 int my_systemv (const char *command, char *const argv[]);
 207 int my_systemv_flags (int flags, const char *command, char *const argv[]);
 208
 209 mc_pipe_t *mc_popen (const char *command, gboolean read_out, gboolean read_err, GError ** error);
 210 void mc_pread (mc_pipe_t * p, GError ** error);
 211 void mc_pclose (mc_pipe_t * p, GError ** error);
 212
 213 GString *mc_pstream_get_string (mc_pipe_stream_t * ps);
 214
 215 void my_exit (int status);
 216 void save_stop_handler (void);
 217
 218 /* Tilde expansion */
 219 char *tilde_expand (const char *directory);
 220
 221 void canonicalize_pathname_custom (char *path, canon_path_flags_t flags);
 222
 223 char *mc_realpath (const char *path, char *resolved_path);
 224
 225 /* Looks for "magic" bytes at the start of the VFS file to guess the
 226  * compression type. Side effect: modifies the file position. */
 227 enum compression_type get_compression_type (int fd, const char *name);
 228 const char *decompress_extension (int type);
 229
 230 GList *list_append_unique (GList * list, char *text);
 231
 232 /* Position saving and restoring */
 233 /* Load position for the given filename */
 234 void load_file_position (const vfs_path_t * filename_vpath, long *line, long *column,
 235                          off_t * offset, GArray ** bookmarks);
 236 /* Save position for the given filename */
 237 void save_file_position (const vfs_path_t * filename_vpath, long line, long column, off_t offset,
 238                          GArray * bookmarks);
 239
 240
 241 /* if ch is in [A-Za-z], returns the corresponding control character,
 242  * else returns the argument. */
 243 extern int ascii_alpha_to_cntrl (int ch);
 244
 245 #undef Q_
 246 const char *Q_ (const char *s);
 247
 248 gboolean mc_util_make_backup_if_possible (const char *file_name, const char *backup_suffix);
 249 gboolean mc_util_restore_from_backup_if_possible (const char *file_name, const char *backup_suffix);
 250 gboolean mc_util_unlink_backup_if_possible (const char *file_name, const char *backup_suffix);
 251
 252 char *guess_message_value (void);
 253
 254 char *mc_build_filename (const char *first_element, ...);
 255 char *mc_build_filenamev (const char *first_element, va_list args);
 256
 257 const char *mc_get_profile_root (void);
 258
 259 /* *INDENT-OFF* */
 260 void mc_propagate_error (GError ** dest, int code, const char *format, ...) G_GNUC_PRINTF (3, 4);
 261 void mc_replace_error (GError ** dest, int code, const char *format, ...) G_GNUC_PRINTF (3, 4);
 262 /* *INDENT-ON* */
 263
 264 gboolean mc_time_elapsed (gint64 * timestamp, gint64 delay);
 265
 266 /* --------------------------------------------------------------------------------------------- */
 267 /*** inline functions ****************************************************************************/
 268 /* --------------------------------------------------------------------------------------------- */
 269
 270 static inline gboolean
 271 exist_file (const char *name)
 272 {
 273     return (access (name, R_OK) == 0);
 274 }
 275
 276 /* --------------------------------------------------------------------------------------------- */
 277
 278 static inline gboolean
 279 is_exe (mode_t mode)
 280 {
 281     return ((mode & (S_IXUSR | S_IXGRP | S_IXOTH)) != 0);
 282 }
 283
 284 /* --------------------------------------------------------------------------------------------- */
 285 /**
 286  * Canonicalize path with CANON_PATH_ALL.
 287  *
 288  * @param path path to file
 289  * @param flags canonicalization flags
 290  *
 291  * All modifications of @path are made in place.
 292  * Well formed UNC paths are modified only in the local part.
 293  */
 294
 295 static inline void
 296 canonicalize_pathname (char *path)
 297 {
 298     canonicalize_pathname_custom (path, CANON_PATH_ALL);
 299 }
 300
 301 /* --------------------------------------------------------------------------------------------- */
 302
 303 #endif /* MC_UTIL_H */