colorize.c

   1 /*
   2  * colorize - Read text from standard input stream or file and print
   3  *            it colorized through use of ANSI escape sequences
   4  *
   5  * Copyright (c) 2011-2017 Steven Schubiger
   6  *
   7  * This program is free software: you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation, either version 3 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License
  18  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  19  *
  20  */
  21
  22 #define _DEFAULT_SOURCE
  23 #define _BSD_SOURCE
  24 #define _XOPEN_SOURCE 700
  25 #define _FILE_OFFSET_BITS 64
  26 #include <assert.h>
  27 #include <ctype.h>
  28 #include <errno.h>
  29 #include <getopt.h>
  30 #include <stdarg.h>
  31 #include <stdio.h>
  32 #include <stdlib.h>
  33 #include <string.h>
  34 #include <sys/time.h>
  35 #include <sys/types.h>
  36 #include <sys/stat.h>
  37 #include <time.h>
  38 #include <unistd.h>
  39
  40 #ifndef DEBUG
  41 # define DEBUG 0
  42 #endif
  43
  44 #define str(arg) #arg
  45 #define to_str(arg) str(arg)
  46
  47 #define streq(s1, s2) (strcmp (s1, s2) == 0)
  48 #define strneq(s1, s2, n) (strncmp (s1, s2, n) == 0)
  49
  50 #if !DEBUG
  51 # define xmalloc(size)          malloc_wrap(size)
  52 # define xcalloc(nmemb, size)   calloc_wrap(nmemb, size)
  53 # define xrealloc(ptr, size)    realloc_wrap(ptr, size)
  54 # define xstrdup(str)           strdup_wrap(str,            NULL, 0)
  55 # define str_concat(str1, str2) str_concat_wrap(str1, str2, NULL, 0)
  56 #else
  57 # define xmalloc(size)          malloc_wrap_debug(size,        __FILE__, __LINE__)
  58 # define xcalloc(nmemb, size)   calloc_wrap_debug(nmemb, size, __FILE__, __LINE__)
  59 # define xrealloc(ptr, size)    realloc_wrap_debug(ptr, size,  __FILE__, __LINE__)
  60 # define xstrdup(str)           strdup_wrap(str,               __FILE__, __LINE__)
  61 # define str_concat(str1, str2) str_concat_wrap(str1, str2,    __FILE__, __LINE__)
  62 #endif
  63
  64 #define free_null(ptr) free_wrap((void **)&ptr)
  65
  66 #if defined(BUF_SIZE) && (BUF_SIZE <= 0 || BUF_SIZE > 65536)
  67 # undef BUF_SIZE
  68 #endif
  69 #ifndef BUF_SIZE
  70 # define BUF_SIZE 4096
  71 #endif
  72
  73 #define LF 0x01
  74 #define CR 0x02
  75
  76 #define SKIP_LINE_ENDINGS(flags) ((flags) == (CR|LF) ? 2 : 1)
  77
  78 #define VALID_FILE_TYPE(mode) (S_ISREG (mode) || S_ISLNK (mode) || S_ISFIFO (mode))
  79
  80 #define STACK_VAR(ptr) do {                                   \
  81     stack_var (&vars_list, &stacked_vars, stacked_vars, ptr); \
  82 } while (false)
  83
  84 #define RELEASE_VAR(ptr) do {                             \
  85     release_var (vars_list, stacked_vars, (void **)&ptr); \
  86 } while (false)
  87
  88 #if !DEBUG
  89 # define MEM_ALLOC_FAIL() do {                                         \
  90     fprintf (stderr, "%s: memory allocation failure\n", program_name); \
  91     exit (EXIT_FAILURE);                                               \
  92 } while (false)
  93 #else
  94 # define MEM_ALLOC_FAIL_DEBUG(file, line) do {                                              \
  95     fprintf (stderr, "Memory allocation failure in source file %s, line %u\n", file, line); \
  96     exit (EXIT_FAILURE);                                                                    \
  97 } while (false)
  98 #endif
  99
 100 #define ABORT_TRACE()                                                              \
 101     fprintf (stderr, "Aborting in source file %s, line %u\n", __FILE__, __LINE__); \
 102     abort ();                                                                      \
 103
 104 #define CHECK_COLORS_RANDOM(color1, color2)        \
 105      streq (color_names[color1]->name, "random")   \
 106  && (streq (color_names[color2]->name, "none")     \
 107   || streq (color_names[color2]->name, "default")) \
 108
 109 #define ALLOC_COMPLETE_PART_LINE 8
 110
 111 #if defined(COLOR_SEP_CHAR_COLON)
 112 # define COLOR_SEP_CHAR ':'
 113 #elif defined(COLOR_SEP_CHAR_SLASH)
 114 # define COLOR_SEP_CHAR '/'
 115 #else
 116 # define COLOR_SEP_CHAR '/'
 117 #endif
 118
 119 #if DEBUG
 120 # define DEBUG_FILE "debug.txt"
 121 #endif
 122
 123 #define MAX_ATTRIBUTE_CHARS (6 * 2)
 124
 125 #define PROGRAM_NAME "colorize"
 126
 127 #define VERSION "0.63"
 128
 129 typedef enum { false, true } bool;
 130
 131 struct color_name {
 132     char *name;
 133     char *orig;
 134 };
 135
 136 struct color {
 137     const char *name;
 138     const char *code;
 139 };
 140
 141 static const struct color fg_colors[] = {
 142     { "none",     NULL },
 143     { "black",   "30m" },
 144     { "red",     "31m" },
 145     { "green",   "32m" },
 146     { "yellow",  "33m" },
 147     { "blue",    "34m" },
 148     { "magenta", "35m" },
 149     { "cyan",    "36m" },
 150     { "white",   "37m" },
 151     { "default", "39m" },
 152 };
 153 static const struct color bg_colors[] = {
 154     { "none",     NULL },
 155     { "black",   "40m" },
 156     { "red",     "41m" },
 157     { "green",   "42m" },
 158     { "yellow",  "43m" },
 159     { "blue",    "44m" },
 160     { "magenta", "45m" },
 161     { "cyan",    "46m" },
 162     { "white",   "47m" },
 163     { "default", "49m" },
 164 };
 165
 166 struct bytes_size {
 167     unsigned int size;
 168     char unit;
 169 };
 170
 171 enum {
 172     FMT_GENERIC,
 173     FMT_STRING,
 174     FMT_QUOTE,
 175     FMT_COLOR,
 176     FMT_RANDOM,
 177     FMT_ERROR,
 178     FMT_FILE,
 179     FMT_TYPE
 180 };
 181 static const char *formats[] = {
 182     "%s",                     /* generic */
 183     "%s '%s'",                /* string  */
 184     "%s `%s' %s",             /* quote   */
 185     "%s color '%s' %s",       /* color   */
 186     "%s color '%s' %s '%s'",  /* random  */
 187     "less than %lu bytes %s", /* error   */
 188     "%s: %s",                 /* file    */
 189     "%s: %s: %s",             /* type    */
 190 };
 191
 192 enum { GENERIC, FOREGROUND = 0, BACKGROUND };
 193
 194 static const struct {
 195     const struct color *entries;
 196     unsigned int count;
 197     const char *desc;
 198 } tables[] = {
 199     { fg_colors, sizeof (fg_colors) / sizeof (struct color), "foreground" },
 200     { bg_colors, sizeof (bg_colors) / sizeof (struct color), "background" },
 201 };
 202
 203 enum {
 204     OPT_ATTR = 1,
 205     OPT_CLEAN,
 206     OPT_CLEAN_ALL,
 207     OPT_EXCLUDE_RANDOM,
 208     OPT_OMIT_COLOR_EMPTY,
 209     OPT_HELP,
 210     OPT_VERSION
 211 };
 212 static int opt_type;
 213 static const struct option long_opts[] = {
 214     { "attr",             required_argument, &opt_type, OPT_ATTR             },
 215     { "clean",            no_argument,       &opt_type, OPT_CLEAN            },
 216     { "clean-all",        no_argument,       &opt_type, OPT_CLEAN_ALL        },
 217     { "exclude-random",   required_argument, &opt_type, OPT_EXCLUDE_RANDOM   },
 218     { "omit-color-empty", no_argument,       &opt_type, OPT_OMIT_COLOR_EMPTY },
 219     { "help",             no_argument,       &opt_type, OPT_HELP             },
 220     { "version",          no_argument,       &opt_type, OPT_VERSION          },
 221     {  NULL,              0,                 NULL,      0                    },
 222 };
 223
 224 enum attr_type {
 225     ATTR_BOLD = 0x01,
 226     ATTR_UNDERSCORE = 0x02,
 227     ATTR_BLINK = 0x04,
 228     ATTR_REVERSE = 0x08,
 229     ATTR_CONCEALED = 0x10
 230 };
 231 struct attr {
 232     const char *name;
 233     unsigned int val;
 234     enum attr_type type;
 235 };
 236
 237 static FILE *stream;
 238 #if DEBUG
 239 static FILE *log;
 240 #endif
 241
 242 static unsigned int stacked_vars;
 243 static void **vars_list;
 244
 245 static bool clean;
 246 static bool clean_all;
 247 static bool omit_color_empty;
 248
 249 static char attr[MAX_ATTRIBUTE_CHARS + 1];
 250 static char *exclude;
 251
 252 static const char *program_name;
 253
 254 static void process_opts (int, char **);
 255 static void process_opt_attr (const char *);
 256 static void write_attr (const struct attr *, unsigned int *);
 257 static void print_hint (void);
 258 static void print_help (void);
 259 static void print_version (void);
 260 static void cleanup (void);
 261 static void free_color_names (struct color_name **);
 262 static void process_args (unsigned int, char **, char *, const struct color **, const char **, FILE **);
 263 static void process_file_arg (const char *, const char **, FILE **);
 264 static void skip_path_colors (const char *, const char *, const struct stat *);
 265 static void gather_color_names (const char *, char *, struct color_name **);
 266 static void read_print_stream (const char *, const struct color **, const char *, FILE *);
 267 static void merge_print_line (const char *, const char *, FILE *);
 268 static void complete_part_line (const char *, char **, FILE *);
 269 static bool get_next_char (char *, const char **, FILE *, bool *);
 270 static void save_char (char, char **, size_t *, size_t *);
 271 static void find_color_entries (struct color_name **, const struct color **);
 272 static void find_color_entry (const struct color_name *, unsigned int, const struct color **);
 273 static void print_line (const char *, const struct color **, const char * const, unsigned int, bool);
 274 static void print_clean (const char *);
 275 static bool is_esc (const char *);
 276 static const char *get_end_of_esc (const char *);
 277 static const char *get_end_of_text (const char *);
 278 static void print_text (const char *, size_t);
 279 static bool gather_esc_offsets (const char *, const char **, const char **);
 280 static bool validate_esc_clean_all (const char **);
 281 static bool validate_esc_clean (int, unsigned int, unsigned int *, const char **, bool *);
 282 static bool is_reset (int, unsigned int, const char **);
 283 static bool is_attr (int, unsigned int, unsigned int, const char **);
 284 static bool is_fg_color (int, const char **);
 285 static bool is_bg_color (int, unsigned int, const char **);
 286 #if !DEBUG
 287 static void *malloc_wrap (size_t);
 288 static void *calloc_wrap (size_t, size_t);
 289 static void *realloc_wrap (void *, size_t);
 290 #else
 291 static void *malloc_wrap_debug (size_t, const char *, unsigned int);
 292 static void *calloc_wrap_debug (size_t, size_t, const char *, unsigned int);
 293 static void *realloc_wrap_debug (void *, size_t, const char *, unsigned int);
 294 #endif
 295 static void free_wrap (void **);
 296 static char *strdup_wrap (const char *, const char *, unsigned int);
 297 static char *str_concat_wrap (const char *, const char *, const char *, unsigned int);
 298 static bool get_bytes_size (unsigned long, struct bytes_size *);
 299 static char *get_file_type (mode_t);
 300 static bool has_color_name (const char *, const char *);
 301 static FILE *open_file (const char *, const char *);
 302 static void vfprintf_diag (const char *, ...);
 303 static void vfprintf_fail (const char *, ...);
 304 static void stack_var (void ***, unsigned int *, unsigned int, void *);
 305 static void release_var (void **, unsigned int, void **);
 306
 307 extern int optind;
 308
 309 int
 310 main (int argc, char **argv)
 311 {
 312     unsigned int arg_cnt;
 313
 314     const struct color *colors[2] = {
 315         NULL, /* foreground */
 316         NULL, /* background */
 317     };
 318
 319     const char *file = NULL;
 320
 321     program_name = argv[0];
 322     atexit (cleanup);
 323
 324     setvbuf (stdout, NULL, _IOLBF, 0);
 325
 326 #if DEBUG
 327     log = open_file (DEBUG_FILE, "w");
 328 #endif
 329
 330     attr[0] = '\0';
 331
 332     process_opts (argc, argv);
 333
 334     arg_cnt = argc - optind;
 335
 336     if (clean || clean_all)
 337       {
 338         if (clean && clean_all)
 339           vfprintf_fail (formats[FMT_GENERIC], "--clean and --clean-all switch are mutually exclusive");
 340         if (arg_cnt > 1)
 341           {
 342             const char *format = "%s %s";
 343             const char *message = "switch cannot be used with more than one file";
 344             if (clean)
 345               vfprintf_fail (format, "--clean", message);
 346             else if (clean_all)
 347               vfprintf_fail (format, "--clean-all", message);
 348           }
 349       }
 350     else
 351       {
 352         if (arg_cnt == 0 || arg_cnt > 2)
 353           {
 354             vfprintf_diag ("%u arguments provided, expected 1-2 arguments or clean option", arg_cnt);
 355             print_hint ();
 356             exit (EXIT_FAILURE);
 357           }
 358       }
 359
 360     if (clean || clean_all)
 361       process_file_arg (argv[optind], &file, &stream);
 362     else
 363       process_args (arg_cnt, &argv[optind], &attr[0], colors, &file, &stream);
 364     read_print_stream (&attr[0], colors, file, stream);
 365
 366     RELEASE_VAR (exclude);
 367
 368     exit (EXIT_SUCCESS);
 369 }
 370
 371 #define PRINT_HELP_EXIT() \
 372     print_help ();        \
 373     exit (EXIT_SUCCESS);  \
 374
 375 #define PRINT_VERSION_EXIT() \
 376     print_version ();        \
 377     exit (EXIT_SUCCESS);     \
 378
 379 extern char *optarg;
 380
 381 static void
 382 process_opts (int argc, char **argv)
 383 {
 384     int opt;
 385     while ((opt = getopt_long (argc, argv, "hV", long_opts, NULL)) != -1)
 386       {
 387         switch (opt)
 388           {
 389             case 0: /* long opts */
 390               switch (opt_type)
 391                 {
 392                   case OPT_ATTR:
 393                     process_opt_attr (optarg);
 394                     break;
 395                   case OPT_CLEAN:
 396                     clean = true;
 397                     break;
 398                   case OPT_CLEAN_ALL:
 399                     clean_all = true;
 400                     break;
 401                   case OPT_EXCLUDE_RANDOM: {
 402                     bool valid = false;
 403                     unsigned int i;
 404                     exclude = xstrdup (optarg);
 405                     STACK_VAR (exclude);
 406                     for (i = 1; i < tables[GENERIC].count - 1; i++) /* skip color none and default */
 407                       {
 408                         const struct color *entry = &tables[GENERIC].entries[i];
 409                         if (streq (exclude, entry->name))
 410                           {
 411                             valid = true;
 412                             break;
 413                           }
 414                       }
 415                     if (!valid)
 416                       vfprintf_fail (formats[FMT_GENERIC], "--exclude-random switch must be provided a plain color");
 417                     break;
 418                   }
 419                   case OPT_OMIT_COLOR_EMPTY:
 420                     omit_color_empty = true;
 421                     break;
 422                   case OPT_HELP:
 423                     PRINT_HELP_EXIT ();
 424                   case OPT_VERSION:
 425                     PRINT_VERSION_EXIT ();
 426                   default: /* never reached */
 427                     ABORT_TRACE ();
 428                 }
 429               break;
 430             case 'h':
 431               PRINT_HELP_EXIT ();
 432             case 'V':
 433               PRINT_VERSION_EXIT ();
 434             case '?':
 435               print_hint ();
 436               exit (EXIT_FAILURE);
 437             default: /* never reached */
 438               ABORT_TRACE ();
 439           }
 440       }
 441 }
 442
 443 static void
 444 process_opt_attr (const char *p)
 445 {
 446     /* If attributes are added to this "list", also increase MAX_ATTRIBUTE_CHARS!  */
 447     const struct attr attrs[] = {
 448         { "bold",       1, ATTR_BOLD       },
 449         { "underscore", 4, ATTR_UNDERSCORE },
 450         { "blink",      5, ATTR_BLINK      },
 451         { "reverse",    7, ATTR_REVERSE    },
 452         { "concealed",  8, ATTR_CONCEALED  },
 453     };
 454     unsigned int attr_types = 0;
 455
 456     while (*p)
 457       {
 458         const char *s;
 459         if (!isalnum (*p))
 460           vfprintf_fail (formats[FMT_GENERIC], "--attr switch must be provided a string");
 461         s = p;
 462         while (isalnum (*p))
 463           p++;
 464         if (*p != '\0' && *p != ',')
 465           vfprintf_fail (formats[FMT_GENERIC], "--attr switch must have strings separated by ,");
 466         else
 467           {
 468             bool valid_attr = false;
 469             unsigned int i;
 470             for (i = 0; i < sizeof (attrs) / sizeof (struct attr); i++)
 471               {
 472                 const size_t name_len = strlen (attrs[i].name);
 473                 if ((size_t)(p - s) == name_len && strneq (s, attrs[i].name, name_len))
 474                   {
 475                     write_attr (&attrs[i], &attr_types);
 476                     valid_attr = true;
 477                     break;
 478                   }
 479               }
 480             if (!valid_attr)
 481               {
 482                 char *attr_invalid = xmalloc ((p - s) + 1);
 483                 STACK_VAR (attr_invalid);
 484                 strncpy (attr_invalid, s, p - s);
 485                 attr_invalid[p - s] = '\0';
 486                 vfprintf_fail ("--attr switch attribute '%s' is not valid", attr_invalid);
 487                 RELEASE_VAR (attr_invalid); /* never reached */
 488               }
 489           }
 490         if (*p)
 491           p++;
 492       }
 493 }
 494
 495 static void
 496 write_attr (const struct attr *attr_i, unsigned int *attr_types)
 497 {
 498     const unsigned int val = attr_i->val;
 499     const enum attr_type attr_type = attr_i->type;
 500     const char *attr_name = attr_i->name;
 501
 502     if (*attr_types & attr_type)
 503       vfprintf_fail ("--attr switch has attribute '%s' twice or more", attr_name);
 504     snprintf (attr + strlen (attr), 3, "%u;", val);
 505     *attr_types |= attr_type;
 506 }
 507
 508 static void
 509 print_hint (void)
 510 {
 511     fprintf (stderr, "Type `%s --help' for help screen.\n", program_name);
 512 }
 513
 514 static void
 515 print_help (void)
 516 {
 517     struct opt_data {
 518         const char *name;
 519         const char *short_opt;
 520         const char *arg;
 521     };
 522     const struct opt_data opts_data[] = {
 523         { "attr",           NULL, "=ATTR1,ATTR2,..." },
 524         { "exclude-random", NULL, "=COLOR"           },
 525         { "help",           "h",  NULL               },
 526         { "version",        "V",  NULL               },
 527     };
 528     const struct option *opt = long_opts;
 529     unsigned int i;
 530
 531     printf ("Usage: %s (foreground) OR (foreground)%c(background) OR --clean[-all] [-|file]\n\n", program_name, COLOR_SEP_CHAR);
 532     printf ("\tColors (foreground) (background)\n");
 533     for (i = 0; i < tables[FOREGROUND].count; i++)
 534       {
 535         const struct color *entry = &tables[FOREGROUND].entries[i];
 536         const char *name = entry->name;
 537         const char *code = entry->code;
 538         if (code)
 539           printf ("\t\t{\033[%s#\033[0m} [%c%c]%s%*s%s\n",
 540                    code, toupper (*name), *name, name + 1, 10 - (int)strlen (name), " ", name);
 541         else
 542           printf ("\t\t{-} %s%*s%s\n", name, 13 - (int)strlen (name), " ", name);
 543       }
 544     printf ("\t\t{*} [Rr]%s%*s%s [--exclude-random=<foreground color>]\n", "andom", 10 - (int)strlen ("random"), " ", "random");
 545
 546     printf ("\n\tFirst character of color name in upper case denotes increased intensity,\n");
 547     printf ("\twhereas for lower case colors will be of normal intensity.\n");
 548
 549     printf ("\n\tOptions\n");
 550     for (; opt->name; opt++)
 551       {
 552         const struct opt_data *opt_data = NULL;
 553         unsigned int i;
 554         for (i = 0; i < sizeof (opts_data) / sizeof (struct opt_data); i++)
 555           if (streq (opt->name, opts_data[i].name))
 556             {
 557               opt_data = &opts_data[i];
 558               break;
 559             }
 560         if (opt_data)
 561           {
 562             if (opt_data->short_opt)
 563               printf ("\t\t-%s, --%s\n", opt_data->short_opt, opt->name);
 564             else
 565               printf ("\t\t    --%s%s\n", opt->name, opt_data->arg);
 566           }
 567         else
 568           printf ("\t\t    --%s\n", opt->name);
 569       }
 570     printf ("\n");
 571 }
 572
 573 static void
 574 print_version (void)
 575 {
 576 #ifdef HAVE_VERSION
 577 # include "version.h"
 578 #else
 579     const char *version = NULL;
 580 #endif
 581     const char *version_prefix, *version_string;
 582     const char *c_flags, *ld_flags, *cpp_flags;
 583     const char *const desc_flags_unknown = "unknown";
 584     struct bytes_size bytes_size;
 585     bool debug;
 586 #ifdef CFLAGS
 587     c_flags = to_str (CFLAGS);
 588 #else
 589     c_flags = desc_flags_unknown;
 590 #endif
 591 #ifdef LDFLAGS
 592     ld_flags = to_str (LDFLAGS);
 593 #else
 594     ld_flags = desc_flags_unknown;
 595 #endif
 596 #ifdef CPPFLAGS
 597     cpp_flags = to_str (CPPFLAGS);
 598 #else
 599     cpp_flags = desc_flags_unknown;
 600 #endif
 601 #if DEBUG
 602     debug = true;
 603 #else
 604     debug = false;
 605 #endif
 606     version_prefix = version ? "" : "v";
 607     version_string = version ? version : VERSION;
 608     printf ("%s %s%s (compiled at %s, %s)\n", PROGRAM_NAME, version_prefix, version_string, __DATE__, __TIME__);
 609
 610     printf ("Compiler flags: %s\n", c_flags);
 611     printf ("Linker flags: %s\n", ld_flags);
 612     printf ("Preprocessor flags: %s\n", cpp_flags);
 613     if (get_bytes_size (BUF_SIZE, &bytes_size))
 614       {
 615         if (BUF_SIZE % 1024 == 0)
 616           printf ("Buffer size: %u%c\n", bytes_size.size, bytes_size.unit);
 617         else
 618           printf ("Buffer size: %u%c, %u byte%s\n", bytes_size.size, bytes_size.unit,
 619                    BUF_SIZE % 1024, BUF_SIZE % 1024 > 1 ? "s" : "");
 620       }
 621     else
 622       printf ("Buffer size: %lu byte%s\n", (unsigned long)BUF_SIZE, BUF_SIZE > 1 ? "s" : "");
 623     printf ("Color separator: '%c'\n", COLOR_SEP_CHAR);
 624     printf ("Debugging: %s\n", debug ? "yes" : "no");
 625 }
 626
 627 static void
 628 cleanup (void)
 629 {
 630     if (stream && fileno (stream) != STDIN_FILENO)
 631       fclose (stream);
 632 #if DEBUG
 633     if (log)
 634       fclose (log);
 635 #endif
 636
 637     if (vars_list)
 638       {
 639         unsigned int i;
 640         for (i = 0; i < stacked_vars; i++)
 641           free (vars_list[i]);
 642         free_null (vars_list);
 643       }
 644 }
 645
 646 static void
 647 free_color_names (struct color_name **color_names)
 648 {
 649     unsigned int i;
 650     for (i = 0; color_names[i]; i++)
 651       {
 652         RELEASE_VAR (color_names[i]->name);
 653         RELEASE_VAR (color_names[i]->orig);
 654         RELEASE_VAR (color_names[i]);
 655       }
 656 }
 657
 658 static void
 659 process_args (unsigned int arg_cnt, char **arg_strings, char *attr, const struct color **colors, const char **file, FILE **stream)
 660 {
 661     int ret;
 662     char *p;
 663     struct stat sb;
 664     struct color_name *color_names[3] = { NULL, NULL, NULL };
 665
 666     const char *color_string = arg_cnt >= 1 ? arg_strings[0] : NULL;
 667     const char *file_string  = arg_cnt == 2 ? arg_strings[1] : NULL;
 668
 669     assert (color_string != NULL);
 670
 671     if (streq (color_string, "-"))
 672       {
 673         if (file_string)
 674           vfprintf_fail (formats[FMT_GENERIC], "hyphen cannot be used as color string");
 675         else
 676           vfprintf_fail (formats[FMT_GENERIC], "hyphen must be preceded by color string");
 677       }
 678
 679     ret = lstat (color_string, &sb);
 680
 681     /* Ensure that we don't fail if there's a file with one or more
 682        color names in its path.  */
 683     if (ret == 0) /* success */
 684       skip_path_colors (color_string, file_string, &sb);
 685
 686     if ((p = strchr (color_string, COLOR_SEP_CHAR)))
 687       {
 688         if (p == color_string)
 689           vfprintf_fail (formats[FMT_STRING], "foreground color missing in string", color_string);
 690         else if (p == color_string + strlen (color_string) - 1)
 691           vfprintf_fail (formats[FMT_STRING], "background color missing in string", color_string);
 692         else if (strchr (++p, COLOR_SEP_CHAR))
 693           vfprintf_fail (formats[FMT_STRING], "one color pair allowed only for string", color_string);
 694       }
 695
 696     gather_color_names (color_string, attr, color_names);
 697
 698     assert (color_names[FOREGROUND] != NULL);
 699
 700     if (color_names[BACKGROUND])
 701       {
 702         unsigned int i;
 703         const unsigned int color_sets[2][2] = { { FOREGROUND, BACKGROUND }, { BACKGROUND, FOREGROUND } };
 704         for (i = 0; i < 2; i++)
 705           {
 706             const unsigned int color1 = color_sets[i][0];
 707             const unsigned int color2 = color_sets[i][1];
 708             if (CHECK_COLORS_RANDOM (color1, color2))
 709               vfprintf_fail (formats[FMT_RANDOM], tables[color1].desc, color_names[color1]->orig, "cannot be combined with", color_names[color2]->orig);
 710           }
 711       }
 712
 713     find_color_entries (color_names, colors);
 714     assert (colors[FOREGROUND] != NULL);
 715     free_color_names (color_names);
 716
 717     if (!colors[FOREGROUND]->code && colors[BACKGROUND] && colors[BACKGROUND]->code)
 718       {
 719         struct color_name color_name;
 720         color_name.name = color_name.orig = "default";
 721
 722         find_color_entry (&color_name, FOREGROUND, colors);
 723         assert (colors[FOREGROUND]->code != NULL);
 724       }
 725
 726     process_file_arg (file_string, file, stream);
 727 }
 728
 729 static void
 730 process_file_arg (const char *file_string, const char **file, FILE **stream)
 731 {
 732     if (file_string)
 733       {
 734         if (streq (file_string, "-"))
 735           *stream = stdin;
 736         else
 737           {
 738             const char *file = file_string;
 739             struct stat sb;
 740             int ret;
 741
 742             errno = 0;
 743             ret = stat (file, &sb);
 744
 745             if (ret == -1)
 746               vfprintf_fail (formats[FMT_FILE], file, strerror (errno));
 747
 748             if (!VALID_FILE_TYPE (sb.st_mode))
 749               vfprintf_fail (formats[FMT_TYPE], file, "unrecognized type", get_file_type (sb.st_mode));
 750
 751             *stream = open_file (file, "r");
 752           }
 753         *file = file_string;
 754       }
 755     else
 756       {
 757         *stream = stdin;
 758         *file = "stdin";
 759       }
 760
 761     assert (*stream != NULL);
 762     assert (*file != NULL);
 763 }
 764
 765 static void
 766 skip_path_colors (const char *color_string, const char *file_string, const struct stat *sb)
 767 {
 768     bool have_file;
 769     unsigned int c;
 770     const char *color = color_string;
 771     const mode_t mode = sb->st_mode;
 772
 773     for (c = 1; c <= 2 && *color; c++)
 774       {
 775         bool matched = false;
 776         unsigned int i;
 777         for (i = 0; i < tables[GENERIC].count; i++)
 778           {
 779             const struct color *entry = &tables[GENERIC].entries[i];
 780             if (has_color_name (color, entry->name))
 781               {
 782                 color += strlen (entry->name);
 783                 matched = true;
 784                 break;
 785               }
 786           }
 787         if (!matched && has_color_name (color, "random"))
 788           {
 789             color += strlen ("random");
 790             matched = true;
 791           }
 792         if (matched && *color == COLOR_SEP_CHAR && *(color + 1))
 793           color++;
 794         else
 795           break;
 796       }
 797
 798     have_file = (*color != '\0');
 799
 800     if (have_file)
 801       {
 802         const char *file_existing = color_string;
 803         if (file_string)
 804           vfprintf_fail (formats[FMT_QUOTE], get_file_type (mode), file_existing, "cannot be used as color string");
 805         else
 806           {
 807             if (VALID_FILE_TYPE (mode))
 808               vfprintf_fail (formats[FMT_QUOTE], get_file_type (mode), file_existing, "must be preceded by color string");
 809             else
 810               vfprintf_fail (formats[FMT_QUOTE], get_file_type (mode), file_existing, "is not a valid file type");
 811           }
 812       }
 813 }
 814
 815 static void
 816 gather_color_names (const char *color_string, char *attr, struct color_name **color_names)
 817 {
 818     unsigned int index;
 819     char *color, *p, *str;
 820
 821     str = xstrdup (color_string);
 822     STACK_VAR (str);
 823
 824     for (index = 0, color = str; *color; index++, color = p)
 825       {
 826         char *ch, *sep;
 827
 828         p = NULL;
 829         if ((sep = strchr (color, COLOR_SEP_CHAR)))
 830           {
 831             *sep = '\0';
 832             p = sep + 1;
 833           }
 834         else
 835           p = color + strlen (color);
 836         assert (p != NULL);
 837
 838         for (ch = color; *ch; ch++)
 839           if (!isalpha (*ch))
 840             vfprintf_fail (formats[FMT_COLOR], tables[index].desc, color, "cannot be made of non-alphabetic characters");
 841
 842         for (ch = color + 1; *ch; ch++)
 843           if (!islower (*ch))
 844             vfprintf_fail (formats[FMT_COLOR], tables[index].desc, color, "cannot be in mixed lower/upper case");
 845
 846         if (streq (color, "None"))
 847           vfprintf_fail (formats[FMT_COLOR], tables[index].desc, color, "cannot be bold");
 848
 849         if (isupper (*color))
 850           {
 851             switch (index)
 852               {
 853                 case FOREGROUND:
 854                   snprintf (attr + strlen (attr), 3, "1;");
 855                   break;
 856                 case BACKGROUND:
 857                   vfprintf_fail (formats[FMT_COLOR], tables[BACKGROUND].desc, color, "cannot be bold");
 858                 default: /* never reached */
 859                   ABORT_TRACE ();
 860               }
 861           }
 862
 863         color_names[index] = xcalloc (1, sizeof (struct color_name));
 864         STACK_VAR (color_names[index]);
 865
 866         color_names[index]->orig = xstrdup (color);
 867         STACK_VAR (color_names[index]->orig);
 868
 869         for (ch = color; *ch; ch++)
 870           *ch = tolower (*ch);
 871
 872         color_names[index]->name = xstrdup (color);
 873         STACK_VAR (color_names[index]->name);
 874       }
 875
 876     RELEASE_VAR (str);
 877 }
 878
 879 static void
 880 read_print_stream (const char *attr, const struct color **colors, const char *file, FILE *stream)
 881 {
 882     char buf[BUF_SIZE + 1];
 883     unsigned int flags = 0;
 884
 885     while (!feof (stream))
 886       {
 887         size_t bytes_read;
 888         char *eol;
 889         const char *line;
 890         bytes_read = fread (buf, 1, BUF_SIZE, stream);
 891         if (bytes_read != BUF_SIZE && ferror (stream))
 892           vfprintf_fail (formats[FMT_ERROR], BUF_SIZE, "read");
 893         buf[bytes_read] = '\0';
 894         line = buf;
 895         while ((eol = strpbrk (line, "\n\r")))
 896           {
 897             const bool has_text = (eol > line);
 898             const char *p;
 899             flags &= ~(CR|LF);
 900             if (*eol == '\r')
 901               {
 902                 flags |= CR;
 903                 if (*(eol + 1) == '\n')
 904                   flags |= LF;
 905               }
 906             else if (*eol == '\n')
 907               flags |= LF;
 908             else
 909               vfprintf_fail (formats[FMT_FILE], file, "unrecognized line ending");
 910             p = eol + SKIP_LINE_ENDINGS (flags);
 911             *eol = '\0';
 912             print_line (attr, colors, line, flags,
 913                         omit_color_empty ? has_text : true);
 914             line = p;
 915           }
 916         if (feof (stream))
 917           {
 918             if (*line != '\0')
 919               print_line (attr, colors, line, 0, true);
 920           }
 921         else if (*line != '\0')
 922           {
 923             char *p;
 924             if ((clean || clean_all) && (p = strrchr (line, '\033')))
 925               merge_print_line (line, p, stream);
 926             else
 927               print_line (attr, colors, line, 0, true);
 928           }
 929       }
 930 }
 931
 932 static void
 933 merge_print_line (const char *line, const char *p, FILE *stream)
 934 {
 935     char *buf = NULL;
 936     char *merged_esc = NULL;
 937     const char *esc = "";
 938     const char char_restore = *p;
 939
 940     complete_part_line (p + 1, &buf, stream);
 941
 942     if (buf)
 943       {
 944         /* form escape sequence */
 945         esc = merged_esc = str_concat (p, buf);
 946         /* shorten partial line accordingly */
 947         *(char *)p = '\0';
 948         free (buf);
 949       }
 950
 951 #ifdef TEST_MERGE_PART_LINE
 952     printf ("%s%s", line, esc);
 953     fflush (stdout);
 954     _exit (EXIT_SUCCESS);
 955 #else
 956     print_clean (line);
 957     *(char *)p = char_restore;
 958     print_clean (esc);
 959     free (merged_esc);
 960 #endif
 961 }
 962
 963 static void
 964 complete_part_line (const char *p, char **buf, FILE *stream)
 965 {
 966     bool got_next_char = false, read_from_stream;
 967     char ch;
 968     size_t i = 0, size;
 969
 970     if (get_next_char (&ch, &p, stream, &read_from_stream))
 971       {
 972         if (ch == '[')
 973           {
 974             if (read_from_stream)
 975               save_char (ch, buf, &i, &size);
 976           }
 977         else
 978           {
 979             if (read_from_stream)
 980               ungetc ((int)ch, stream);
 981             return; /* cancel */
 982           }
 983       }
 984     else
 985       return; /* cancel */
 986
 987     while (get_next_char (&ch, &p, stream, &read_from_stream))
 988       {
 989         if (isdigit (ch) || ch == ';')
 990           {
 991             if (read_from_stream)
 992               save_char (ch, buf, &i, &size);
 993           }
 994         else /* got next character */
 995           {
 996             got_next_char = true;
 997             break;
 998           }
 999       }
1000
1001     if (got_next_char)
1002       {
1003         if (ch == 'm')
1004           {
1005             if (read_from_stream)
1006               save_char (ch, buf, &i, &size);
1007           }
1008         else
1009           {
1010             if (read_from_stream)
1011               ungetc ((int)ch, stream);
1012             return; /* cancel */
1013           }
1014       }
1015     else
1016       return; /* cancel */
1017 }
1018
1019 static bool
1020 get_next_char (char *ch, const char **p, FILE *stream, bool *read_from_stream)
1021 {
1022     if (**p == '\0')
1023       {
1024         int c;
1025         if ((c = fgetc (stream)) != EOF)
1026           {
1027             *ch = (char)c;
1028             *read_from_stream = true;
1029             return true;
1030           }
1031         else
1032           {
1033             *read_from_stream = false;
1034             return false;
1035           }
1036       }
1037     else
1038       {
1039         *ch = **p;
1040         (*p)++;
1041         *read_from_stream = false;
1042         return true;
1043       }
1044 }
1045
1046 static void
1047 save_char (char ch, char **buf, size_t *i, size_t *size)
1048 {
1049     if (!*buf)
1050       {
1051         *size = ALLOC_COMPLETE_PART_LINE;
1052         *buf = xmalloc (*size);
1053       }
1054     /* +1: effective occupied size of buffer */
1055     else if ((*i + 1) == *size)
1056       {
1057         *size *= 2;
1058         *buf = xrealloc (*buf, *size);
1059       }
1060     (*buf)[*i] = ch;
1061     (*buf)[*i + 1] = '\0';
1062     (*i)++;
1063 }
1064
1065 static void
1066 find_color_entries (struct color_name **color_names, const struct color **colors)
1067 {
1068     struct timeval tv;
1069     unsigned int index;
1070
1071     /* randomness */
1072     gettimeofday (&tv, NULL);
1073     srand (tv.tv_usec * tv.tv_sec);
1074
1075     for (index = 0; color_names[index]; index++)
1076       {
1077         const char *color_name = color_names[index]->name;
1078
1079         const unsigned int count                = tables[index].count;
1080         const struct color *const color_entries = tables[index].entries;
1081
1082         if (streq (color_name, "random"))
1083           {
1084             bool excludable;
1085             unsigned int i;
1086             do {
1087               excludable = false;
1088               i = rand() % (count - 2) + 1; /* omit color none and default */
1089               switch (index)
1090                 {
1091                   case FOREGROUND:
1092                     /* --exclude-random */
1093                     if (exclude && streq (exclude, color_entries[i].name))
1094                       excludable = true;
1095                     else if (color_names[BACKGROUND] && streq (color_names[BACKGROUND]->name, color_entries[i].name))
1096                       excludable = true;
1097                     break;
1098                   case BACKGROUND:
1099                     if (streq (colors[FOREGROUND]->name, color_entries[i].name))
1100                       excludable = true;
1101                     break;
1102                   default: /* never reached */
1103                     ABORT_TRACE ();
1104                  }
1105             } while (excludable);
1106             colors[index] = (struct color *)&color_entries[i];
1107           }
1108         else
1109           find_color_entry (color_names[index], index, colors);
1110       }
1111 }
1112
1113 static void
1114 find_color_entry (const struct color_name *color_name, unsigned int index, const struct color **colors)
1115 {
1116     bool found = false;
1117     unsigned int i;
1118
1119     const unsigned int count                = tables[index].count;
1120     const struct color *const color_entries = tables[index].entries;
1121
1122     for (i = 0; i < count; i++)
1123       if (streq (color_name->name, color_entries[i].name))
1124         {
1125           colors[index] = (struct color *)&color_entries[i];
1126           found = true;
1127           break;
1128         }
1129     if (!found)
1130       vfprintf_fail (formats[FMT_COLOR], tables[index].desc, color_name->orig, "not recognized");
1131 }
1132
1133 static void
1134 print_line (const char *attr, const struct color **colors, const char *const line, unsigned int flags, bool emit_colors)
1135 {
1136     /* --clean[-all] */
1137     if (clean || clean_all)
1138       print_clean (line);
1139     /* skip for --omit-color-empty? */
1140     else if (emit_colors)
1141       {
1142         /* Foreground color code is guaranteed to be set when background color code is present.  */
1143         if (colors[BACKGROUND] && colors[BACKGROUND]->code)
1144           printf ("\033[%s", colors[BACKGROUND]->code);
1145         if (colors[FOREGROUND]->code)
1146           printf ("\033[%s%s%s\033[0m", attr, colors[FOREGROUND]->code, line);
1147         else
1148           printf (formats[FMT_GENERIC], line);
1149       }
1150     if (flags & CR)
1151       putchar ('\r');
1152     if (flags & LF)
1153       putchar ('\n');
1154 }
1155
1156 static void
1157 print_clean (const char *line)
1158 {
1159     const char *p = line;
1160
1161     if (is_esc (p))
1162       p = get_end_of_esc (p);
1163
1164     while (*p != '\0')
1165       {
1166         const char *text_start = p;
1167         const char *text_end = get_end_of_text (p);
1168         print_text (text_start, text_end - text_start);
1169         p = get_end_of_esc (text_end);
1170       }
1171 }
1172
1173 static bool
1174 is_esc (const char *p)
1175 {
1176     return gather_esc_offsets (p, NULL, NULL);
1177 }
1178
1179 static const char *
1180 get_end_of_esc (const char *p)
1181 {
1182     const char *esc;
1183     const char *end = NULL;
1184     while ((esc = strchr (p, '\033')))
1185       {
1186         if (gather_esc_offsets (esc, NULL, &end))
1187           break;
1188         p = esc + 1;
1189       }
1190     return end ? end + 1 : p + strlen (p);
1191 }
1192
1193 static const char *
1194 get_end_of_text (const char *p)
1195 {
1196     const char *esc;
1197     const char *start = NULL;
1198     while ((esc = strchr (p, '\033')))
1199       {
1200         if (gather_esc_offsets (esc, &start, NULL))
1201           break;
1202         p = esc + 1;
1203       }
1204     return start ? start : p + strlen (p);
1205 }
1206
1207 static void
1208 print_text (const char *p, size_t len)
1209 {
1210     size_t bytes_written;
1211     bytes_written = fwrite (p, 1, len, stdout);
1212     if (bytes_written != len)
1213       vfprintf_fail (formats[FMT_ERROR], (unsigned long)len, "written");
1214 }
1215
1216 static bool
1217 gather_esc_offsets (const char *p, const char **start, const char **end)
1218 {
1219     /* ESC[ */
1220     if (*p == 27 && *(p + 1) == '[')
1221       {
1222         bool valid = false;
1223         const char *const begin = p;
1224         p += 2;
1225         if (clean_all)
1226           valid = validate_esc_clean_all (&p);
1227         else if (clean)
1228           {
1229             bool check_values;
1230             unsigned int prev_iter, iter;
1231             const char *digit;
1232             prev_iter = iter = 0;
1233             do {
1234               check_values = false;
1235               iter++;
1236               if (!isdigit (*p))
1237                 break;
1238               digit = p;
1239               while (isdigit (*p))
1240                 p++;
1241               if (p - digit > 2)
1242                 break;
1243               else /* check range */
1244                 {
1245                   char val[3];
1246                   int value;
1247                   unsigned int i;
1248                   const unsigned int digits = p - digit;
1249                   for (i = 0; i < digits; i++)
1250                     val[i] = *digit++;
1251                   val[i] = '\0';
1252                   value = atoi (val);
1253                   valid = validate_esc_clean (value, iter, &prev_iter, &p, &check_values);
1254                 }
1255             } while (check_values);
1256           }
1257         if (valid)
1258           {
1259             if (start)
1260               *start = begin;
1261             if (end)
1262               *end = p;
1263             return true;
1264           }
1265       }
1266     return false;
1267 }
1268
1269 static bool
1270 validate_esc_clean_all (const char **p)
1271 {
1272     while (isdigit (**p) || **p == ';')
1273       (*p)++;
1274     return (**p == 'm');
1275 }
1276
1277 static bool
1278 validate_esc_clean (int value, unsigned int iter, unsigned int *prev_iter, const char **p, bool *check_values)
1279 {
1280     if (is_reset (value, iter, p))
1281       return true;
1282     else if (is_attr (value, iter, *prev_iter, p))
1283       {
1284         (*p)++;
1285         *check_values = true;
1286         *prev_iter = iter;
1287         return false; /* partial escape sequence, need another valid value */
1288       }
1289     else if (is_fg_color (value, p))
1290       return true;
1291     else if (is_bg_color (value, iter, p))
1292       return true;
1293     else
1294       return false;
1295 }
1296
1297 static bool
1298 is_reset (int value, unsigned int iter, const char **p)
1299 {
1300     return (value == 0 && iter == 1 && **p == 'm');
1301 }
1302
1303 static bool
1304 is_attr (int value, unsigned int iter, unsigned int prev_iter, const char **p)
1305 {
1306     return ((value > 0 && value < 10) && (iter - prev_iter == 1) && **p == ';');
1307 }
1308
1309 static bool
1310 is_fg_color (int value, const char **p)
1311 {
1312     return (((value >= 30 && value <= 37) || value == 39) && **p == 'm');
1313 }
1314
1315 static bool
1316 is_bg_color (int value, unsigned int iter, const char **p)
1317 {
1318     return (((value >= 40 && value <= 47) || value == 49) && iter == 1 && **p == 'm');
1319 }
1320
1321 #if !DEBUG
1322 static void *
1323 malloc_wrap (size_t size)
1324 {
1325     void *p = malloc (size);
1326     if (!p)
1327       MEM_ALLOC_FAIL ();
1328     return p;
1329 }
1330
1331 static void *
1332 calloc_wrap (size_t nmemb, size_t size)
1333 {
1334     void *p = calloc (nmemb, size);
1335     if (!p)
1336       MEM_ALLOC_FAIL ();
1337     return p;
1338 }
1339
1340 static void *
1341 realloc_wrap (void *ptr, size_t size)
1342 {
1343     void *p = realloc (ptr, size);
1344     if (!p)
1345       MEM_ALLOC_FAIL ();
1346     return p;
1347 }
1348 #else
1349 static void *
1350 malloc_wrap_debug (size_t size, const char *file, unsigned int line)
1351 {
1352     void *p = malloc (size);
1353     if (!p)
1354       MEM_ALLOC_FAIL_DEBUG (file, line);
1355     fprintf (log, "%s: malloc'ed %lu bytes [source file %s, line %u]\n", program_name, (unsigned long)size, file, line);
1356     return p;
1357 }
1358
1359 static void *
1360 calloc_wrap_debug (size_t nmemb, size_t size, const char *file, unsigned int line)
1361 {
1362     void *p = calloc (nmemb, size);
1363     if (!p)
1364       MEM_ALLOC_FAIL_DEBUG (file, line);
1365     fprintf (log, "%s: calloc'ed %lu bytes [source file %s, line %u]\n", program_name, (unsigned long)(nmemb * size), file, line);
1366     return p;
1367 }
1368
1369 static void *
1370 realloc_wrap_debug (void *ptr, size_t size, const char *file, unsigned int line)
1371 {
1372     void *p = realloc (ptr, size);
1373     if (!p)
1374       MEM_ALLOC_FAIL_DEBUG (file, line);
1375     fprintf (log, "%s: realloc'ed %lu bytes [source file %s, line %u]\n", program_name, (unsigned long)size, file, line);
1376     return p;
1377 }
1378 #endif /* !DEBUG */
1379
1380 static void
1381 free_wrap (void **ptr)
1382 {
1383     free (*ptr);
1384     *ptr = NULL;
1385 }
1386
1387 #if !DEBUG
1388 # define do_malloc(len, file, line) malloc_wrap(len)
1389 #else
1390 # define do_malloc(len, file, line) malloc_wrap_debug(len, file, line)
1391 #endif
1392
1393 static char *
1394 strdup_wrap (const char *str, const char *file, unsigned int line)
1395 {
1396     const size_t len = strlen (str) + 1;
1397     char *p = do_malloc (len, file, line);
1398     strncpy (p, str, len);
1399     return p;
1400 }
1401
1402 static char *
1403 str_concat_wrap (const char *str1, const char *str2, const char *file, unsigned int line)
1404 {
1405     const size_t len = strlen (str1) + strlen (str2) + 1;
1406     char *p, *str;
1407
1408     p = str = do_malloc (len, file, line);
1409     strncpy (p, str1, strlen (str1));
1410     p += strlen (str1);
1411     strncpy (p, str2, strlen (str2));
1412     p += strlen (str2);
1413     *p = '\0';
1414
1415     return str;
1416 }
1417
1418 static bool
1419 get_bytes_size (unsigned long bytes, struct bytes_size *bytes_size)
1420 {
1421     const char *unit, units[] = { '0', 'K', 'M', 'G', '\0' };
1422     unsigned long size = bytes;
1423     if (bytes < 1024)
1424       return false;
1425     unit = units;
1426     while (size >= 1024 && *(unit + 1))
1427       {
1428         size /= 1024;
1429         unit++;
1430       }
1431     bytes_size->size = (unsigned int)size;
1432     bytes_size->unit = *unit;
1433     return true;
1434 }
1435
1436 static char *
1437 get_file_type (mode_t mode)
1438 {
1439     if (S_ISREG (mode))
1440       return "file";
1441     else if (S_ISDIR (mode))
1442       return "directory";
1443     else if (S_ISCHR (mode))
1444       return "character device";
1445     else if (S_ISBLK (mode))
1446       return "block device";
1447     else if (S_ISFIFO (mode))
1448       return "named pipe";
1449     else if (S_ISLNK (mode))
1450       return "symbolic link";
1451     else if (S_ISSOCK (mode))
1452       return "socket";
1453     else
1454       return "file";
1455 }
1456
1457 static bool
1458 has_color_name (const char *str, const char *name)
1459 {
1460     char *p;
1461
1462     assert (strlen (str) > 0);
1463     assert (strlen (name) > 0);
1464
1465     if (!(*str == *name || *str == toupper (*name)))
1466       return false;
1467     else if (*(name + 1) != '\0'
1468      && !((p = strstr (str + 1, name + 1)) && p == str + 1))
1469       return false;
1470     else
1471       return true;
1472 }
1473
1474 static FILE *
1475 open_file (const char *file, const char *mode)
1476 {
1477     FILE *stream;
1478
1479     errno = 0;
1480     stream = fopen (file, mode);
1481     if (!stream)
1482       vfprintf_fail (formats[FMT_FILE], file, strerror (errno));
1483
1484     return stream;
1485 }
1486
1487 #define DO_VFPRINTF(fmt)                    \
1488     va_list ap;                             \
1489     fprintf (stderr, "%s: ", program_name); \
1490     va_start (ap, fmt);                     \
1491     vfprintf (stderr, fmt, ap);             \
1492     va_end (ap);                            \
1493     fprintf (stderr, "\n");                 \
1494
1495 static void
1496 vfprintf_diag (const char *fmt, ...)
1497 {
1498     DO_VFPRINTF (fmt);
1499 }
1500
1501 static void
1502 vfprintf_fail (const char *fmt, ...)
1503 {
1504     DO_VFPRINTF (fmt);
1505     exit (EXIT_FAILURE);
1506 }
1507
1508 static void
1509 stack_var (void ***list, unsigned int *stacked, unsigned int index, void *ptr)
1510 {
1511     /* nothing to stack */
1512     if (ptr == NULL)
1513       return;
1514     if (!*list)
1515       *list = xmalloc (sizeof (void *));
1516     else
1517       {
1518         unsigned int i;
1519         for (i = 0; i < *stacked; i++)
1520           if (!(*list)[i])
1521             {
1522               (*list)[i] = ptr;
1523               return; /* reused */
1524             }
1525         *list = xrealloc (*list, (*stacked + 1) * sizeof (void *));
1526       }
1527     (*list)[index] = ptr;
1528     (*stacked)++;
1529 }
1530
1531 static void
1532 release_var (void **list, unsigned int stacked, void **ptr)
1533 {
1534     unsigned int i;
1535     /* nothing to release */
1536     if (*ptr == NULL)
1537       return;
1538     for (i = 0; i < stacked; i++)
1539       if (list[i] == *ptr)
1540         {
1541           free (*ptr);
1542           *ptr = NULL;
1543           list[i] = NULL;
1544           return;
1545         }
1546 }