lib/util.c

   1 /*
   2    Various utilities
   3
   4    Copyright (C) 1994-2024
   5    Free Software Foundation, Inc.
   6
   7    Written by:
   8    Miguel de Icaza, 1994, 1995, 1996
   9    Janne Kukonlehto, 1994, 1995, 1996
  10    Dugan Porter, 1994, 1995, 1996
  11    Jakub Jelinek, 1994, 1995, 1996
  12    Mauricio Plaza, 1994, 1995, 1996
  13    Slava Zanko <slavazanko@gmail.com>, 2013
  14
  15    This file is part of the Midnight Commander.
  16
  17    The Midnight Commander is free software: you can redistribute it
  18    and/or modify it under the terms of the GNU General Public License as
  19    published by the Free Software Foundation, either version 3 of the License,
  20    or (at your option) any later version.
  21
  22    The Midnight Commander is distributed in the hope that it will be useful,
  23    but WITHOUT ANY WARRANTY; without even the implied warranty of
  24    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  25    GNU General Public License for more details.
  26
  27    You should have received a copy of the GNU General Public License
  28    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  29  */
  30
  31 /** \file lib/util.c
  32  *  \brief Source: various utilities
  33  */
  34
  35 #include <config.h>
  36
  37 #include <ctype.h>
  38 #include <stddef.h>             /* ptrdiff_t */
  39 #include <limits.h>
  40 #include <stdarg.h>
  41 #include <stdio.h>
  42 #include <stdlib.h>
  43 #include <string.h>
  44 #include <sys/types.h>
  45 #include <sys/stat.h>
  46 #include <unistd.h>
  47
  48 #include "lib/global.h"
  49 #include "lib/mcconfig.h"
  50 #include "lib/fileloc.h"
  51 #include "lib/vfs/vfs.h"
  52 #include "lib/strutil.h"
  53 #include "lib/util.h"
  54
  55 /*** global variables ****************************************************************************/
  56
  57 /*** file scope macro definitions ****************************************************************/
  58
  59 #define ismode(n,m) ((n & m) == m)
  60
  61 /* Number of attempts to create a temporary file */
  62 #ifndef TMP_MAX
  63 #define TMP_MAX 16384
  64 #endif /* !TMP_MAX */
  65
  66 #define TMP_SUFFIX ".tmp"
  67
  68 #define ASCII_A (0x40 + 1)
  69 #define ASCII_Z (0x40 + 26)
  70 #define ASCII_a (0x60 + 1)
  71 #define ASCII_z (0x60 + 26)
  72
  73 /*** file scope type declarations ****************************************************************/
  74
  75 /*** forward declarations (file scope functions) *************************************************/
  76
  77 /*** file scope variables ************************************************************************/
  78
  79 /* --------------------------------------------------------------------------------------------- */
  80 /*** file scope functions ************************************************************************/
  81 /* --------------------------------------------------------------------------------------------- */
  82
  83 #ifndef HAVE_CHARSET
  84 static inline int
  85 is_7bit_printable (unsigned char c)
  86 {
  87     return (c > 31 && c < 127);
  88 }
  89 #endif
  90
  91 /* --------------------------------------------------------------------------------------------- */
  92
  93 static inline int
  94 is_iso_printable (unsigned char c)
  95 {
  96     return ((c > 31 && c < 127) || c >= 160);
  97 }
  98
  99 /* --------------------------------------------------------------------------------------------- */
 100
 101 static inline int
 102 is_8bit_printable (unsigned char c)
 103 {
 104     /* "Full 8 bits output" doesn't work on xterm */
 105     if (mc_global.tty.xterm_flag)
 106         return is_iso_printable (c);
 107
 108     return (c > 31 && c != 127 && c != 155);
 109 }
 110
 111 /* --------------------------------------------------------------------------------------------- */
 112
 113 static char *
 114 resolve_symlinks (const vfs_path_t *vpath)
 115 {
 116     char *p, *p2;
 117     char *buf, *buf2, *q, *r, c;
 118     struct stat mybuf;
 119
 120     if (vpath->relative)
 121         return NULL;
 122
 123     p = p2 = g_strdup (vfs_path_as_str (vpath));
 124     r = buf = g_malloc (MC_MAXPATHLEN);
 125     buf2 = g_malloc (MC_MAXPATHLEN);
 126     *r++ = PATH_SEP;
 127     *r = '\0';
 128
 129     do
 130     {
 131         q = strchr (p + 1, PATH_SEP);
 132         if (q == NULL)
 133         {
 134             q = strchr (p + 1, '\0');
 135             if (q == p + 1)
 136                 break;
 137         }
 138         c = *q;
 139         *q = '\0';
 140         if (mc_lstat (vpath, &mybuf) < 0)
 141         {
 142             MC_PTR_FREE (buf);
 143             goto ret;
 144         }
 145         if (!S_ISLNK (mybuf.st_mode))
 146             strcpy (r, p + 1);
 147         else
 148         {
 149             int len;
 150
 151             len = mc_readlink (vpath, buf2, MC_MAXPATHLEN - 1);
 152             if (len < 0)
 153             {
 154                 MC_PTR_FREE (buf);
 155                 goto ret;
 156             }
 157             buf2[len] = '\0';
 158             if (IS_PATH_SEP (*buf2))
 159                 strcpy (buf, buf2);
 160             else
 161                 strcpy (r, buf2);
 162         }
 163         canonicalize_pathname (buf);
 164         r = strchr (buf, '\0');
 165         if (*r == '\0' || !IS_PATH_SEP (r[-1]))
 166             /* FIXME: this condition is always true because r points to the EOL */
 167         {
 168             *r++ = PATH_SEP;
 169             *r = '\0';
 170         }
 171         *q = c;
 172         p = q;
 173     }
 174     while (c != '\0');
 175
 176     if (*buf == '\0')
 177         strcpy (buf, PATH_SEP_STR);
 178     else if (IS_PATH_SEP (r[-1]) && r != buf + 1)
 179         r[-1] = '\0';
 180
 181   ret:
 182     g_free (buf2);
 183     g_free (p2);
 184     return buf;
 185 }
 186
 187 /* --------------------------------------------------------------------------------------------- */
 188
 189 static gboolean
 190 mc_util_write_backup_content (const char *from_file_name, const char *to_file_name)
 191 {
 192     FILE *backup_fd;
 193     char *contents;
 194     gsize length;
 195     gboolean ret1 = TRUE;
 196
 197     if (!g_file_get_contents (from_file_name, &contents, &length, NULL))
 198         return FALSE;
 199
 200     backup_fd = fopen (to_file_name, "w");
 201     if (backup_fd == NULL)
 202     {
 203         g_free (contents);
 204         return FALSE;
 205     }
 206
 207     if (fwrite ((const void *) contents, 1, length, backup_fd) != length)
 208         ret1 = FALSE;
 209
 210     {
 211         int ret2;
 212
 213         /* cppcheck-suppress redundantAssignment */
 214         ret2 = fflush (backup_fd);
 215         /* cppcheck-suppress redundantAssignment */
 216         ret2 = fclose (backup_fd);
 217         (void) ret2;
 218     }
 219
 220     g_free (contents);
 221     return ret1;
 222 }
 223
 224 /* --------------------------------------------------------------------------------------------- */
 225 /*** public functions ****************************************************************************/
 226 /* --------------------------------------------------------------------------------------------- */
 227
 228 int
 229 is_printable (int c)
 230 {
 231     c &= 0xff;
 232
 233 #ifdef HAVE_CHARSET
 234     /* "Display bits" is ignored, since the user controls the output
 235        by setting the output codepage */
 236     return is_8bit_printable (c);
 237 #else
 238     if (!mc_global.eight_bit_clean)
 239         return is_7bit_printable (c);
 240
 241     if (mc_global.full_eight_bits)
 242         return is_8bit_printable (c);
 243
 244     return is_iso_printable (c);
 245 #endif /* !HAVE_CHARSET */
 246 }
 247
 248 /* --------------------------------------------------------------------------------------------- */
 249 /**
 250  * Quote the filename for the purpose of inserting it into the command
 251  * line.  If quote_percent is TRUE, replace "%" with "%%" - the percent is
 252  * processed by the mc command line.
 253  */
 254 char *
 255 name_quote (const char *s, gboolean quote_percent)
 256 {
 257     GString *ret;
 258
 259     if (s == NULL || *s == '\0')
 260         return NULL;
 261
 262     ret = g_string_sized_new (64);
 263
 264     if (*s == '-')
 265         g_string_append (ret, "." PATH_SEP_STR);
 266
 267     for (; *s != '\0'; s++)
 268     {
 269         switch (*s)
 270         {
 271         case '%':
 272             if (quote_percent)
 273                 g_string_append_c (ret, '%');
 274             break;
 275         case '\'':
 276         case '\\':
 277         case '\r':
 278         case '\n':
 279         case '\t':
 280         case '"':
 281         case ';':
 282         case ' ':
 283         case '?':
 284         case '|':
 285         case '[':
 286         case ']':
 287         case '{':
 288         case '}':
 289         case '<':
 290         case '>':
 291         case '`':
 292         case '!':
 293         case '$':
 294         case '&':
 295         case '*':
 296         case '(':
 297         case ')':
 298             g_string_append_c (ret, '\\');
 299             break;
 300         case '~':
 301         case '#':
 302             if (ret->len == 0)
 303                 g_string_append_c (ret, '\\');
 304             break;
 305         default:
 306             break;
 307         }
 308         g_string_append_c (ret, *s);
 309     }
 310
 311     return g_string_free (ret, ret->len == 0);
 312 }
 313
 314 /* --------------------------------------------------------------------------------------------- */
 315
 316 char *
 317 fake_name_quote (const char *s, gboolean quote_percent)
 318 {
 319     (void) quote_percent;
 320
 321     return (s == NULL || *s == '\0' ? NULL : g_strdup (s));
 322 }
 323
 324 /* --------------------------------------------------------------------------------------------- */
 325 /**
 326  * path_trunc() is the same as str_trunc() but
 327  * it deletes possible password from path for security
 328  * reasons.
 329  */
 330
 331 const char *
 332 path_trunc (const char *path, size_t trunc_len)
 333 {
 334     vfs_path_t *vpath;
 335     const char *ret;
 336
 337     vpath = vfs_path_from_str_flags (path, VPF_STRIP_PASSWORD);
 338     ret = str_trunc (vfs_path_as_str (vpath), trunc_len);
 339     vfs_path_free (vpath, TRUE);
 340
 341     return ret;
 342 }
 343
 344 /* --------------------------------------------------------------------------------------------- */
 345
 346 const char *
 347 size_trunc (uintmax_t size, gboolean use_si)
 348 {
 349     static char x[BUF_TINY];
 350     uintmax_t divisor = 1;
 351     const char *xtra = _("B");
 352
 353     if (size > 999999999UL)
 354     {
 355         divisor = use_si ? 1000 : 1024;
 356         xtra = use_si ? _("kB") : _("KiB");
 357
 358         if (size / divisor > 999999999UL)
 359         {
 360             divisor = use_si ? (1000 * 1000) : (1024 * 1024);
 361             xtra = use_si ? _("MB") : _("MiB");
 362
 363             if (size / divisor > 999999999UL)
 364             {
 365                 divisor = use_si ? (1000 * 1000 * 1000) : (1024 * 1024 * 1024);
 366                 xtra = use_si ? _("GB") : _("GiB");
 367             }
 368         }
 369     }
 370     g_snprintf (x, sizeof (x), "%.0f %s", 1.0 * size / divisor, xtra);
 371     return x;
 372 }
 373
 374 /* --------------------------------------------------------------------------------------------- */
 375
 376 const char *
 377 size_trunc_sep (uintmax_t size, gboolean use_si)
 378 {
 379     static char x[60];
 380     int count;
 381     const char *p, *y;
 382     char *d;
 383
 384     p = y = size_trunc (size, use_si);
 385     p += strlen (p) - 1;
 386     d = x + sizeof (x) - 1;
 387     *d-- = '\0';
 388     /* @size format is "size unit", i.e. "[digits][space][letters]".
 389        Copy all characters after digits. */
 390     while (p >= y && !g_ascii_isdigit (*p))
 391         *d-- = *p--;
 392     for (count = 0; p >= y; count++)
 393     {
 394         if (count == 3)
 395         {
 396             *d-- = ',';
 397             count = 0;
 398         }
 399         *d-- = *p--;
 400     }
 401     d++;
 402     if (*d == ',')
 403         d++;
 404     return d;
 405 }
 406
 407 /* --------------------------------------------------------------------------------------------- */
 408 /**
 409  * Print file SIZE to BUFFER, but don't exceed LEN characters,
 410  * not including trailing 0. BUFFER should be at least LEN+1 long.
 411  * This function is called for every file on panels, so avoid
 412  * floating point by any means.
 413  *
 414  * Units: size units (filesystem sizes are 1K blocks)
 415  *    0=bytes, 1=Kbytes, 2=Mbytes, etc.
 416  */
 417
 418 void
 419 size_trunc_len (char *buffer, unsigned int len, uintmax_t size, int units, gboolean use_si)
 420 {
 421     /* Avoid taking power for every file.  */
 422     /* *INDENT-OFF* */
 423     static const uintmax_t power10[] = {
 424     /* we hope that size of uintmax_t is 4 bytes at least */
 425         1ULL,
 426         10ULL,
 427         100ULL,
 428         1000ULL,
 429         10000ULL,
 430         100000ULL,
 431         1000000ULL,
 432         10000000ULL,
 433         100000000ULL,
 434         1000000000ULL
 435     /* maximum value of uintmax_t (in case of 4 bytes) is
 436         4294967295
 437      */
 438 #if SIZEOF_UINTMAX_T == 8
 439                      ,
 440         10000000000ULL,
 441         100000000000ULL,
 442         1000000000000ULL,
 443         10000000000000ULL,
 444         100000000000000ULL,
 445         1000000000000000ULL,
 446         10000000000000000ULL,
 447         100000000000000000ULL,
 448         1000000000000000000ULL,
 449         10000000000000000000ULL
 450     /* maximum value of uintmax_t (in case of 8 bytes) is
 451         18447644073710439615
 452      */
 453 #endif
 454     };
 455
 456     static const char *const suffix[] =
 457         { "", "K", "M", "G", "T", "P", "E", "Z", "Y", "R", "Q", NULL };
 458     static const char *const suffix_lc[] =
 459         { "", "k", "m", "g", "t", "p", "e", "z", "y", "r", "q", NULL };
 460     /* *INDENT-ON* */
 461
 462     const char *const *sfx = use_si ? suffix_lc : suffix;
 463     int j = 0;
 464
 465     if (len == 0)
 466         len = 9;
 467 #if SIZEOF_UINTMAX_T == 8
 468     /* 20 decimal digits are required to represent 8 bytes */
 469     else if (len > 19)
 470         len = 19;
 471 #else
 472     /* 10 decimal digits are required to represent 4 bytes */
 473     else if (len > 9)
 474         len = 9;
 475 #endif
 476
 477     /*
 478      * recalculate from 1024 base to 1000 base if units>0
 479      * We can't just multiply by 1024 - that might cause overflow
 480      * if uintmax_t type is too small
 481      */
 482     if (use_si)
 483         for (j = 0; j < units; j++)
 484         {
 485             uintmax_t size_remain;
 486
 487             size_remain = ((size % 125) * 1024) / 1000; /* size mod 125, recalculated */
 488             size /= 125;        /* 128/125 = 1024/1000 */
 489             size *= 128;        /* This will convert size from multiple of 1024 to multiple of 1000 */
 490             size += size_remain;        /* Re-add remainder lost by division/multiplication */
 491         }
 492
 493     for (j = units; sfx[j] != NULL; j++)
 494     {
 495         if (size == 0)
 496         {
 497             if (j == units)
 498             {
 499                 /* Empty files will print "0" even with minimal width.  */
 500                 g_snprintf (buffer, len + 1, "%s", "0");
 501             }
 502             else
 503             {
 504                 /* Use "~K" or just "K" if len is 1.  Use "B" for bytes.  */
 505                 g_snprintf (buffer, len + 1, (len > 1) ? "~%s" : "%s", (j > 1) ? sfx[j - 1] : "B");
 506             }
 507             break;
 508         }
 509
 510         if (size < power10[len - (j > 0 ? 1 : 0)])
 511         {
 512             g_snprintf (buffer, len + 1, "%" PRIuMAX "%s", size, sfx[j]);
 513             break;
 514         }
 515
 516         /* Powers of 1000 or 1024, with rounding.  */
 517         if (use_si)
 518             size = (size + 500) / 1000;
 519         else
 520             size = (size + 512) >> 10;
 521     }
 522 }
 523
 524 /* --------------------------------------------------------------------------------------------- */
 525
 526 const char *
 527 string_perm (mode_t mode_bits)
 528 {
 529     static char mode[11];
 530
 531     strcpy (mode, "----------");
 532     if (S_ISDIR (mode_bits))
 533         mode[0] = 'd';
 534     if (S_ISCHR (mode_bits))
 535         mode[0] = 'c';
 536     if (S_ISBLK (mode_bits))
 537         mode[0] = 'b';
 538     if (S_ISLNK (mode_bits))
 539         mode[0] = 'l';
 540     if (S_ISFIFO (mode_bits))
 541         mode[0] = 'p';
 542     if (S_ISNAM (mode_bits))
 543         mode[0] = 'n';
 544     if (S_ISSOCK (mode_bits))
 545         mode[0] = 's';
 546     if (S_ISDOOR (mode_bits))
 547         mode[0] = 'D';
 548     if (ismode (mode_bits, S_IXOTH))
 549         mode[9] = 'x';
 550     if (ismode (mode_bits, S_IWOTH))
 551         mode[8] = 'w';
 552     if (ismode (mode_bits, S_IROTH))
 553         mode[7] = 'r';
 554     if (ismode (mode_bits, S_IXGRP))
 555         mode[6] = 'x';
 556     if (ismode (mode_bits, S_IWGRP))
 557         mode[5] = 'w';
 558     if (ismode (mode_bits, S_IRGRP))
 559         mode[4] = 'r';
 560     if (ismode (mode_bits, S_IXUSR))
 561         mode[3] = 'x';
 562     if (ismode (mode_bits, S_IWUSR))
 563         mode[2] = 'w';
 564     if (ismode (mode_bits, S_IRUSR))
 565         mode[1] = 'r';
 566 #ifdef S_ISUID
 567     if (ismode (mode_bits, S_ISUID))
 568         mode[3] = (mode[3] == 'x') ? 's' : 'S';
 569 #endif /* S_ISUID */
 570 #ifdef S_ISGID
 571     if (ismode (mode_bits, S_ISGID))
 572         mode[6] = (mode[6] == 'x') ? 's' : 'S';
 573 #endif /* S_ISGID */
 574 #ifdef S_ISVTX
 575     if (ismode (mode_bits, S_ISVTX))
 576         mode[9] = (mode[9] == 'x') ? 't' : 'T';
 577 #endif /* S_ISVTX */
 578     return mode;
 579 }
 580
 581 /* --------------------------------------------------------------------------------------------- */
 582
 583 const char *
 584 extension (const char *filename)
 585 {
 586     const char *d;
 587
 588     d = strrchr (filename, '.');
 589
 590     return d != NULL ? d + 1 : "";
 591 }
 592
 593 /* --------------------------------------------------------------------------------------------- */
 594
 595 char *
 596 load_mc_home_file (const char *from, const char *filename, char **allocated_filename,
 597                    size_t *length)
 598 {
 599     char *hintfile_base, *hintfile;
 600     char *lang;
 601     char *data;
 602
 603     hintfile_base = g_build_filename (from, filename, (char *) NULL);
 604     lang = guess_message_value ();
 605
 606     hintfile = g_strconcat (hintfile_base, ".", lang, (char *) NULL);
 607     if (!g_file_get_contents (hintfile, &data, length, NULL))
 608     {
 609         /* Fall back to the two-letter language code */
 610         if (lang[0] != '\0' && lang[1] != '\0')
 611             lang[2] = '\0';
 612         g_free (hintfile);
 613         hintfile = g_strconcat (hintfile_base, ".", lang, (char *) NULL);
 614         if (!g_file_get_contents (hintfile, &data, length, NULL))
 615         {
 616             g_free (hintfile);
 617             hintfile = hintfile_base;
 618             g_file_get_contents (hintfile_base, &data, length, NULL);
 619         }
 620     }
 621
 622     g_free (lang);
 623
 624     if (hintfile != hintfile_base)
 625         g_free (hintfile_base);
 626
 627     if (allocated_filename != NULL)
 628         *allocated_filename = hintfile;
 629     else
 630         g_free (hintfile);
 631
 632     return data;
 633 }
 634
 635 /* --------------------------------------------------------------------------------------------- */
 636
 637 const char *
 638 extract_line (const char *s, const char *top)
 639 {
 640     static char tmp_line[BUF_MEDIUM];
 641     char *t = tmp_line;
 642
 643     while (*s != '\0' && *s != '\n' && (size_t) (t - tmp_line) < sizeof (tmp_line) - 1 && s < top)
 644         *t++ = *s++;
 645     *t = '\0';
 646     return tmp_line;
 647 }
 648
 649 /* --------------------------------------------------------------------------------------------- */
 650 /**
 651  * The basename routine
 652  */
 653
 654 const char *
 655 x_basename (const char *s)
 656 {
 657     const char *url_delim, *path_sep;
 658
 659     url_delim = g_strrstr (s, VFS_PATH_URL_DELIMITER);
 660     path_sep = strrchr (s, PATH_SEP);
 661
 662     if (path_sep == NULL)
 663         return s;
 664
 665     if (url_delim == NULL
 666         || url_delim < path_sep - strlen (VFS_PATH_URL_DELIMITER)
 667         || url_delim - s + strlen (VFS_PATH_URL_DELIMITER) < strlen (s))
 668     {
 669         /* avoid trailing PATH_SEP, if present */
 670         if (!IS_PATH_SEP (s[strlen (s) - 1]))
 671             return path_sep + 1;
 672
 673         while (--path_sep > s && !IS_PATH_SEP (*path_sep))
 674             ;
 675         return (path_sep != s) ? path_sep + 1 : s;
 676     }
 677
 678     while (--url_delim > s && !IS_PATH_SEP (*url_delim))
 679         ;
 680     while (--url_delim > s && !IS_PATH_SEP (*url_delim))
 681         ;
 682
 683     return url_delim == s ? s : url_delim + 1;
 684 }
 685
 686 /* --------------------------------------------------------------------------------------------- */
 687
 688 const char *
 689 unix_error_string (int error_num)
 690 {
 691     static char buffer[BUF_LARGE];
 692     gchar *strerror_currentlocale;
 693
 694     strerror_currentlocale = g_locale_from_utf8 (g_strerror (error_num), -1, NULL, NULL, NULL);
 695     g_snprintf (buffer, sizeof (buffer), "%s (%d)", strerror_currentlocale, error_num);
 696     g_free (strerror_currentlocale);
 697
 698     return buffer;
 699 }
 700
 701 /* --------------------------------------------------------------------------------------------- */
 702
 703 const char *
 704 skip_separators (const char *s)
 705 {
 706     const char *su = s;
 707
 708     for (; *su != '\0'; str_cnext_char (&su))
 709         if (!whitespace (*su) && *su != ',')
 710             break;
 711
 712     return su;
 713 }
 714
 715 /* --------------------------------------------------------------------------------------------- */
 716
 717 const char *
 718 skip_numbers (const char *s)
 719 {
 720     const char *su = s;
 721
 722     for (; *su != '\0'; str_cnext_char (&su))
 723         if (!str_isdigit (su))
 724             break;
 725
 726     return su;
 727 }
 728
 729 /* --------------------------------------------------------------------------------------------- */
 730 /**
 731  * Remove all control sequences from the argument string.  We define
 732  * "control sequence", in a sort of pidgin BNF, as follows:
 733  *
 734  * control-seq = Esc non-'['
 735  *             | Esc '[' (0 or more digits or ';' or ':' or '?') (any other char)
 736  *
 737  * The 256-color and true-color escape sequences should allow either ';' or ':' inside as separator,
 738  * actually, ':' is the more correct according to ECMA-48.
 739  * Some terminal emulators (e.g. xterm, gnome-terminal) support this.
 740  *
 741  * Non-printable characters are also removed.
 742  */
 743
 744 char *
 745 strip_ctrl_codes (char *s)
 746 {
 747     char *w;                    /* Current position where the stripped data is written */
 748     char *r;                    /* Current position where the original data is read */
 749
 750     if (s == NULL)
 751         return NULL;
 752
 753     for (w = s, r = s; *r != '\0';)
 754     {
 755         if (*r == ESC_CHAR)
 756         {
 757             /* Skip the control sequence's arguments */ ;
 758             /* '(' need to avoid strange 'B' letter in *Suse (if mc runs under root user) */
 759             if (*(++r) == '[' || *r == '(')
 760             {
 761                 /* strchr() matches trailing binary 0 */
 762                 while (*(++r) != '\0' && strchr ("0123456789;:?", *r) != NULL)
 763                     ;
 764             }
 765             else if (*r == ']')
 766             {
 767                 /*
 768                  * Skip xterm's OSC (Operating System Command)
 769                  * http://www.xfree86.org/current/ctlseqs.html
 770                  * OSC P s ; P t ST
 771                  * OSC P s ; P t BEL
 772                  */
 773                 char *new_r;
 774
 775                 for (new_r = r; *new_r != '\0'; new_r++)
 776                 {
 777                     switch (*new_r)
 778                     {
 779                         /* BEL */
 780                     case '\a':
 781                         r = new_r;
 782                         goto osc_out;
 783                     case ESC_CHAR:
 784                         /* ST */
 785                         if (new_r[1] == '\\')
 786                         {
 787                             r = new_r + 1;
 788                             goto osc_out;
 789                         }
 790                         break;
 791                     default:
 792                         break;
 793                     }
 794                 }
 795               osc_out:
 796                 ;
 797             }
 798
 799             /*
 800              * Now we are at the last character of the sequence.
 801              * Skip it unless it's binary 0.
 802              */
 803             if (*r != '\0')
 804                 r++;
 805         }
 806         else
 807         {
 808             char *n;
 809
 810             n = str_get_next_char (r);
 811             if (str_isprint (r))
 812             {
 813                 memmove (w, r, n - r);
 814                 w += n - r;
 815             }
 816             r = n;
 817         }
 818     }
 819
 820     *w = '\0';
 821     return s;
 822 }
 823
 824 /* --------------------------------------------------------------------------------------------- */
 825
 826 enum compression_type
 827 get_compression_type (int fd, const char *name)
 828 {
 829     unsigned char magic[16];
 830     size_t str_len;
 831
 832     /* Read the magic signature */
 833     if (mc_read (fd, (char *) magic, 4) != 4)
 834         return COMPRESSION_NONE;
 835
 836     /* GZIP_MAGIC and OLD_GZIP_MAGIC */
 837     if (magic[0] == 0x1F && (magic[1] == 0x8B || magic[1] == 0x9E))
 838         return COMPRESSION_GZIP;
 839
 840     /* PKZIP_MAGIC */
 841     if (magic[0] == 'P' && magic[1] == 'K' && magic[2] == 0x03 && magic[3] == 0x04)
 842     {
 843         /* Read compression type */
 844         mc_lseek (fd, 8, SEEK_SET);
 845         if (mc_read (fd, (char *) magic, 2) != 2)
 846             return COMPRESSION_NONE;
 847
 848         if ((magic[0] != 8 && magic[0] != 0) || magic[1] != 0)
 849             return COMPRESSION_NONE;
 850
 851         return COMPRESSION_ZIP;
 852     }
 853
 854     /* PACK_MAGIC and LZH_MAGIC and compress magic */
 855     if (magic[0] == 0x1F && (magic[1] == 0x1E || magic[1] == 0xA0 || magic[1] == 0x9D))
 856         /* Compatible with gzip */
 857         return COMPRESSION_GZIP;
 858
 859     /* BZIP and BZIP2 files */
 860     if ((magic[0] == 'B') && (magic[1] == 'Z') && (magic[3] >= '1') && (magic[3] <= '9'))
 861         switch (magic[2])
 862         {
 863         case '0':
 864             return COMPRESSION_BZIP;
 865         case 'h':
 866             return COMPRESSION_BZIP2;
 867         default:
 868             break;
 869         }
 870
 871     /* LZ4 format - v1.5.0 - 0x184D2204 (little endian) */
 872     if (magic[0] == 0x04 && magic[1] == 0x22 && magic[2] == 0x4d && magic[3] == 0x18)
 873         return COMPRESSION_LZ4;
 874
 875     if (mc_read (fd, (char *) magic + 4, 2) != 2)
 876         return COMPRESSION_NONE;
 877
 878     /* LZIP files */
 879     if (magic[0] == 'L'
 880         && magic[1] == 'Z'
 881         && magic[2] == 'I' && magic[3] == 'P' && (magic[4] == 0x00 || magic[4] == 0x01))
 882         return COMPRESSION_LZIP;
 883
 884     /* Support for LZMA (only utils format with magic in header).
 885      * This is the default format of LZMA utils 4.32.1 and later. */
 886     if (magic[0] == 0xFF
 887         && magic[1] == 'L'
 888         && magic[2] == 'Z' && magic[3] == 'M' && magic[4] == 'A' && magic[5] == 0x00)
 889         return COMPRESSION_LZMA;
 890
 891     /* LZO format - \x89\x4c\x5a\x4f\x00\x0d\x0a\x1a\x0a    lzop compressed data */
 892     if (magic[0] == 0x89 && magic[1] == 0x4c &&
 893         magic[2] == 0x5a && magic[3] == 0x4f && magic[4] == 0x00 && magic[5] == 0x0d)
 894         return COMPRESSION_LZO;
 895
 896     /* XZ compression magic */
 897     if (magic[0] == 0xFD
 898         && magic[1] == 0x37
 899         && magic[2] == 0x7A && magic[3] == 0x58 && magic[4] == 0x5A && magic[5] == 0x00)
 900         return COMPRESSION_XZ;
 901
 902     if (magic[0] == 0x28 && magic[1] == 0xB5 && magic[2] == 0x2F && magic[3] == 0xFD)
 903         return COMPRESSION_ZSTD;
 904
 905     str_len = strlen (name);
 906     /* HACK: we must believe to extension of LZMA file :) ... */
 907     if ((str_len > 5 && strcmp (&name[str_len - 5], ".lzma") == 0) ||
 908         (str_len > 4 && strcmp (&name[str_len - 4], ".tlz") == 0))
 909         return COMPRESSION_LZMA;
 910
 911     return COMPRESSION_NONE;
 912 }
 913
 914 /* --------------------------------------------------------------------------------------------- */
 915
 916 const char *
 917 decompress_extension (int type)
 918 {
 919     switch (type)
 920     {
 921     case COMPRESSION_ZIP:
 922         return "/uz" VFS_PATH_URL_DELIMITER;
 923     case COMPRESSION_GZIP:
 924         return "/ugz" VFS_PATH_URL_DELIMITER;
 925     case COMPRESSION_BZIP:
 926         return "/ubz" VFS_PATH_URL_DELIMITER;
 927     case COMPRESSION_BZIP2:
 928         return "/ubz2" VFS_PATH_URL_DELIMITER;
 929     case COMPRESSION_LZIP:
 930         return "/ulz" VFS_PATH_URL_DELIMITER;
 931     case COMPRESSION_LZ4:
 932         return "/ulz4" VFS_PATH_URL_DELIMITER;
 933     case COMPRESSION_LZMA:
 934         return "/ulzma" VFS_PATH_URL_DELIMITER;
 935     case COMPRESSION_LZO:
 936         return "/ulzo" VFS_PATH_URL_DELIMITER;
 937     case COMPRESSION_XZ:
 938         return "/uxz" VFS_PATH_URL_DELIMITER;
 939     case COMPRESSION_ZSTD:
 940         return "/uzst" VFS_PATH_URL_DELIMITER;
 941     default:
 942         break;
 943     }
 944     /* Should never reach this place */
 945     fprintf (stderr, "Fatal: decompress_extension called with an unknown argument\n");
 946     return 0;
 947 }
 948
 949 /* --------------------------------------------------------------------------------------------- */
 950
 951 void
 952 wipe_password (char *passwd)
 953 {
 954     if (passwd != NULL)
 955     {
 956         char *p;
 957
 958         for (p = passwd; *p != '\0'; p++)
 959             *p = '\0';
 960         g_free (passwd);
 961     }
 962 }
 963
 964 /* --------------------------------------------------------------------------------------------- */
 965 /**
 966  * Convert "\E" -> esc character and ^x to control-x key and ^^ to ^ key
 967  *
 968  * @param p pointer to string
 969  *
 970  * @return newly allocated string
 971  */
 972
 973 char *
 974 convert_controls (const char *p)
 975 {
 976     char *valcopy;
 977     char *q;
 978
 979     valcopy = g_strdup (p);
 980
 981     /* Parse the escape special character */
 982     for (q = valcopy; *p != '\0';)
 983         switch (*p)
 984         {
 985         case '\\':
 986             p++;
 987
 988             if (*p == 'e' || *p == 'E')
 989             {
 990                 p++;
 991                 *q++ = ESC_CHAR;
 992             }
 993             break;
 994
 995         case '^':
 996             p++;
 997             if (*p == '^')
 998                 *q++ = *p++;
 999             else
1000             {
1001                 char c;
1002
1003                 c = *p | 0x20;
1004                 if (c >= 'a' && c <= 'z')
1005                 {
1006                     *q++ = c - 'a' + 1;
1007                     p++;
1008                 }
1009                 else if (*p != '\0')
1010                     p++;
1011             }
1012             break;
1013
1014         default:
1015             *q++ = *p++;
1016         }
1017
1018     *q = '\0';
1019     return valcopy;
1020 }
1021
1022 /* --------------------------------------------------------------------------------------------- */
1023 /**
1024  * Finds out a relative path from first to second, i.e. goes as many ..
1025  * as needed up in first and then goes down using second
1026  */
1027
1028 char *
1029 diff_two_paths (const vfs_path_t *vpath1, const vfs_path_t *vpath2)
1030 {
1031     int j, prevlen = -1, currlen;
1032     char *my_first = NULL, *my_second = NULL;
1033     char *buf = NULL;
1034
1035     my_first = resolve_symlinks (vpath1);
1036     if (my_first == NULL)
1037         goto ret;
1038
1039     my_second = resolve_symlinks (vpath2);
1040     if (my_second == NULL)
1041         goto ret;
1042
1043     for (j = 0; j < 2; j++)
1044     {
1045         char *p, *q;
1046         int i;
1047
1048         p = my_first;
1049         q = my_second;
1050
1051         while (TRUE)
1052         {
1053             char *r, *s;
1054             ptrdiff_t len;
1055
1056             r = strchr (p, PATH_SEP);
1057             if (r == NULL)
1058                 break;
1059             s = strchr (q, PATH_SEP);
1060             if (s == NULL)
1061                 break;
1062
1063             len = r - p;
1064             if (len != (s - q) || strncmp (p, q, (size_t) len) != 0)
1065                 break;
1066
1067             p = r + 1;
1068             q = s + 1;
1069         }
1070         p--;
1071         for (i = 0; (p = strchr (p + 1, PATH_SEP)) != NULL; i++)
1072             ;
1073         currlen = (i + 1) * 3 + strlen (q) + 1;
1074         if (j != 0)
1075         {
1076             if (currlen < prevlen)
1077                 g_free (buf);
1078             else
1079                 goto ret;
1080         }
1081         p = buf = g_malloc (currlen);
1082         prevlen = currlen;
1083         for (; i >= 0; i--, p += 3)
1084             strcpy (p, "../");
1085         strcpy (p, q);
1086     }
1087
1088   ret:
1089     g_free (my_first);
1090     g_free (my_second);
1091     return buf;
1092 }
1093
1094 /* --------------------------------------------------------------------------------------------- */
1095 /**
1096  * Append text to GList, remove all entries with the same text
1097  */
1098
1099 GList *
1100 list_append_unique (GList *list, char *text)
1101 {
1102     GList *lc_link;
1103
1104     /*
1105      * Go to the last position and traverse the list backwards
1106      * starting from the second last entry to make sure that we
1107      * are not removing the current link.
1108      */
1109     list = g_list_append (list, text);
1110     list = g_list_last (list);
1111     lc_link = g_list_previous (list);
1112
1113     while (lc_link != NULL)
1114     {
1115         GList *newlink;
1116
1117         newlink = g_list_previous (lc_link);
1118         if (strcmp ((char *) lc_link->data, text) == 0)
1119         {
1120             GList *tmp;
1121
1122             g_free (lc_link->data);
1123             tmp = g_list_remove_link (list, lc_link);
1124             (void) tmp;
1125             g_list_free_1 (lc_link);
1126         }
1127         lc_link = newlink;
1128     }
1129
1130     return list;
1131 }
1132
1133 /* --------------------------------------------------------------------------------------------- */
1134 /**
1135  * Read and restore position for the given filename.
1136  * If there is no stored data, return line 1 and col 0.
1137  */
1138
1139 void
1140 load_file_position (const vfs_path_t *filename_vpath, long *line, long *column, off_t *offset,
1141                     GArray **bookmarks)
1142 {
1143     char *fn;
1144     FILE *f;
1145     char buf[MC_MAXPATHLEN + 100];
1146     const size_t len = vfs_path_len (filename_vpath);
1147
1148     /* defaults */
1149     *line = 1;
1150     *column = 0;
1151     *offset = 0;
1152
1153     /* open file with positions */
1154     fn = mc_config_get_full_path (MC_FILEPOS_FILE);
1155     f = fopen (fn, "r");
1156     g_free (fn);
1157     if (f == NULL)
1158         return;
1159
1160     /* prepare array for serialized bookmarks */
1161     if (bookmarks != NULL)
1162         *bookmarks = g_array_sized_new (FALSE, FALSE, sizeof (size_t), MAX_SAVED_BOOKMARKS);
1163
1164     while (fgets (buf, sizeof (buf), f) != NULL)
1165     {
1166         const char *p;
1167         gchar **pos_tokens;
1168
1169         /* check if the filename matches the beginning of string */
1170         if (strncmp (buf, vfs_path_as_str (filename_vpath), len) != 0)
1171             continue;
1172
1173         /* followed by single space */
1174         if (buf[len] != ' ')
1175             continue;
1176
1177         /* and string without spaces */
1178         p = &buf[len + 1];
1179         if (strchr (p, ' ') != NULL)
1180             continue;
1181
1182         pos_tokens = g_strsplit (p, ";", 3 + MAX_SAVED_BOOKMARKS);
1183         if (pos_tokens[0] == NULL)
1184         {
1185             *line = 1;
1186             *column = 0;
1187             *offset = 0;
1188         }
1189         else
1190         {
1191             *line = strtol (pos_tokens[0], NULL, 10);
1192             if (pos_tokens[1] == NULL)
1193             {
1194                 *column = 0;
1195                 *offset = 0;
1196             }
1197             else
1198             {
1199                 *column = strtol (pos_tokens[1], NULL, 10);
1200                 if (pos_tokens[2] == NULL)
1201                     *offset = 0;
1202                 else if (bookmarks != NULL)
1203                 {
1204                     size_t i;
1205
1206                     *offset = (off_t) g_ascii_strtoll (pos_tokens[2], NULL, 10);
1207
1208                     for (i = 0; i < MAX_SAVED_BOOKMARKS && pos_tokens[3 + i] != NULL; i++)
1209                     {
1210                         size_t val;
1211
1212                         val = strtoul (pos_tokens[3 + i], NULL, 10);
1213                         g_array_append_val (*bookmarks, val);
1214                     }
1215                 }
1216             }
1217         }
1218
1219         g_strfreev (pos_tokens);
1220     }
1221
1222     fclose (f);
1223 }
1224
1225 /* --------------------------------------------------------------------------------------------- */
1226 /**
1227  * Save position for the given file
1228  */
1229
1230 void
1231 save_file_position (const vfs_path_t *filename_vpath, long line, long column, off_t offset,
1232                     GArray *bookmarks)
1233 {
1234     static size_t filepos_max_saved_entries = 0;
1235     char *fn, *tmp_fn;
1236     FILE *f, *tmp_f;
1237     char buf[MC_MAXPATHLEN + 100];
1238     size_t i;
1239     const size_t len = vfs_path_len (filename_vpath);
1240     gboolean src_error = FALSE;
1241
1242     if (filepos_max_saved_entries == 0)
1243         filepos_max_saved_entries = mc_config_get_int (mc_global.main_config, CONFIG_APP_SECTION,
1244                                                        "filepos_max_saved_entries", 1024);
1245
1246     fn = mc_config_get_full_path (MC_FILEPOS_FILE);
1247     if (fn == NULL)
1248         goto early_error;
1249
1250     mc_util_make_backup_if_possible (fn, TMP_SUFFIX);
1251
1252     /* open file */
1253     f = fopen (fn, "w");
1254     if (f == NULL)
1255         goto open_target_error;
1256
1257     tmp_fn = g_strdup_printf ("%s" TMP_SUFFIX, fn);
1258     tmp_f = fopen (tmp_fn, "r");
1259     if (tmp_f == NULL)
1260     {
1261         src_error = TRUE;
1262         goto open_source_error;
1263     }
1264
1265     /* put the new record */
1266     if (line != 1 || column != 0 || bookmarks != NULL)
1267     {
1268         if (fprintf
1269             (f, "%s %ld;%ld;%" PRIuMAX, vfs_path_as_str (filename_vpath), line, column,
1270              (uintmax_t) offset) < 0)
1271             goto write_position_error;
1272         if (bookmarks != NULL)
1273             for (i = 0; i < bookmarks->len && i < MAX_SAVED_BOOKMARKS; i++)
1274                 if (fprintf (f, ";%zu", g_array_index (bookmarks, size_t, i)) < 0)
1275                       goto write_position_error;
1276
1277         if (fprintf (f, "\n") < 0)
1278             goto write_position_error;
1279     }
1280
1281     i = 1;
1282     while (fgets (buf, sizeof (buf), tmp_f) != NULL)
1283     {
1284         if (buf[len] == ' ' && strncmp (buf, vfs_path_as_str (filename_vpath), len) == 0
1285             && strchr (&buf[len + 1], ' ') == NULL)
1286             continue;
1287
1288         fprintf (f, "%s", buf);
1289         if (++i > filepos_max_saved_entries)
1290             break;
1291     }
1292
1293   write_position_error:
1294     fclose (tmp_f);
1295   open_source_error:
1296     g_free (tmp_fn);
1297     fclose (f);
1298     if (src_error)
1299         mc_util_restore_from_backup_if_possible (fn, TMP_SUFFIX);
1300     else
1301         mc_util_unlink_backup_if_possible (fn, TMP_SUFFIX);
1302   open_target_error:
1303     g_free (fn);
1304   early_error:
1305     if (bookmarks != NULL)
1306         g_array_free (bookmarks, TRUE);
1307 }
1308
1309 /* --------------------------------------------------------------------------------------------- */
1310
1311 extern int
1312 ascii_alpha_to_cntrl (int ch)
1313 {
1314     if ((ch >= ASCII_A && ch <= ASCII_Z) || (ch >= ASCII_a && ch <= ASCII_z))
1315         ch &= 0x1f;
1316
1317     return ch;
1318 }
1319
1320 /* --------------------------------------------------------------------------------------------- */
1321
1322 const char *
1323 Q_ (const char *s)
1324 {
1325     const char *result, *sep;
1326
1327     result = _(s);
1328     sep = strchr (result, '|');
1329
1330     return sep != NULL ? sep + 1 : result;
1331 }
1332
1333 /* --------------------------------------------------------------------------------------------- */
1334
1335 gboolean
1336 mc_util_make_backup_if_possible (const char *file_name, const char *backup_suffix)
1337 {
1338     struct stat stat_buf;
1339     char *backup_path;
1340     gboolean ret;
1341
1342     if (!exist_file (file_name))
1343         return FALSE;
1344
1345     backup_path = g_strdup_printf ("%s%s", file_name, backup_suffix);
1346     if (backup_path == NULL)
1347         return FALSE;
1348
1349     ret = mc_util_write_backup_content (file_name, backup_path);
1350     if (ret)
1351     {
1352         /* Backup file will have same ownership with main file. */
1353         if (stat (file_name, &stat_buf) == 0)
1354             chmod (backup_path, stat_buf.st_mode);
1355         else
1356             chmod (backup_path, S_IRUSR | S_IWUSR);
1357     }
1358
1359     g_free (backup_path);
1360
1361     return ret;
1362 }
1363
1364 /* --------------------------------------------------------------------------------------------- */
1365
1366 gboolean
1367 mc_util_restore_from_backup_if_possible (const char *file_name, const char *backup_suffix)
1368 {
1369     gboolean ret;
1370     char *backup_path;
1371
1372     backup_path = g_strdup_printf ("%s%s", file_name, backup_suffix);
1373     if (backup_path == NULL)
1374         return FALSE;
1375
1376     ret = mc_util_write_backup_content (backup_path, file_name);
1377     g_free (backup_path);
1378
1379     return ret;
1380 }
1381
1382 /* --------------------------------------------------------------------------------------------- */
1383
1384 gboolean
1385 mc_util_unlink_backup_if_possible (const char *file_name, const char *backup_suffix)
1386 {
1387     char *backup_path;
1388
1389     backup_path = g_strdup_printf ("%s%s", file_name, backup_suffix);
1390     if (backup_path == NULL)
1391         return FALSE;
1392
1393     if (exist_file (backup_path))
1394     {
1395         vfs_path_t *vpath;
1396
1397         vpath = vfs_path_from_str (backup_path);
1398         mc_unlink (vpath);
1399         vfs_path_free (vpath, TRUE);
1400     }
1401
1402     g_free (backup_path);
1403     return TRUE;
1404 }
1405
1406 /* --------------------------------------------------------------------------------------------- */
1407 /**
1408  * partly taken from dcigettext.c, returns "" for default locale
1409  * value should be freed by calling function g_free()
1410  */
1411
1412 char *
1413 guess_message_value (void)
1414 {
1415     static const char *const var[] = {
1416         /* Setting of LC_ALL overwrites all other.  */
1417         /* Do not use LANGUAGE for check user locale and drowing hints */
1418         "LC_ALL",
1419         /* Next comes the name of the desired category.  */
1420         "LC_MESSAGES",
1421         /* Last possibility is the LANG environment variable.  */
1422         "LANG",
1423         /* NULL exit loops */
1424         NULL
1425     };
1426
1427     size_t i;
1428     const char *locale = NULL;
1429
1430     for (i = 0; var[i] != NULL; i++)
1431     {
1432         locale = getenv (var[i]);
1433         if (locale != NULL && locale[0] != '\0')
1434             break;
1435     }
1436
1437     if (locale == NULL)
1438         locale = "";
1439
1440     return g_strdup (locale);
1441 }
1442
1443 /* --------------------------------------------------------------------------------------------- */
1444
1445 /**
1446  * The "profile root" is the tree under which all of MC's user data &
1447  * settings are stored.
1448  *
1449  * It defaults to the user's home dir. The user may override this default
1450  * with the environment variable $MC_PROFILE_ROOT.
1451  */
1452 const char *
1453 mc_get_profile_root (void)
1454 {
1455     static const char *profile_root = NULL;
1456
1457     if (profile_root == NULL)
1458     {
1459         profile_root = g_getenv ("MC_PROFILE_ROOT");
1460         if (profile_root == NULL || *profile_root == '\0')
1461             profile_root = mc_config_get_home_dir ();
1462     }
1463
1464     return profile_root;
1465 }
1466
1467 /* --------------------------------------------------------------------------------------------- */
1468 /**
1469  * Propagate error in simple way.
1470  *
1471  * @param dest error return location
1472  * @param code error code
1473  * @param format printf()-style format for error message
1474  * @param ... parameters for message format
1475  */
1476
1477 void
1478 mc_propagate_error (GError **dest, int code, const char *format, ...)
1479 {
1480     if (dest != NULL && *dest == NULL)
1481     {
1482         GError *tmp_error;
1483         va_list args;
1484
1485         va_start (args, format);
1486         tmp_error = g_error_new_valist (MC_ERROR, code, format, args);
1487         va_end (args);
1488
1489         g_propagate_error (dest, tmp_error);
1490     }
1491 }
1492
1493 /* --------------------------------------------------------------------------------------------- */
1494 /**
1495  * Replace existing error in simple way.
1496  *
1497  * @param dest error return location
1498  * @param code error code
1499  * @param format printf()-style format for error message
1500  * @param ... parameters for message format
1501  */
1502
1503 void
1504 mc_replace_error (GError **dest, int code, const char *format, ...)
1505 {
1506     if (dest != NULL)
1507     {
1508         GError *tmp_error;
1509         va_list args;
1510
1511         va_start (args, format);
1512         tmp_error = g_error_new_valist (MC_ERROR, code, format, args);
1513         va_end (args);
1514
1515         g_error_free (*dest);
1516         *dest = NULL;
1517         g_propagate_error (dest, tmp_error);
1518     }
1519 }
1520
1521 /* --------------------------------------------------------------------------------------------- */
1522
1523 /**
1524  * Returns if the given duration has elapsed since the given timestamp,
1525  * and if it has then updates the timestamp.
1526  *
1527  * @param timestamp the last timestamp in microseconds, updated if the given time elapsed
1528  * @param delay amount of time in microseconds
1529
1530  * @return TRUE if clock skew detected, FALSE otherwise
1531  */
1532 gboolean
1533 mc_time_elapsed (gint64 *timestamp, gint64 delay)
1534 {
1535     gint64 now;
1536
1537     now = g_get_monotonic_time ();
1538
1539     if (now >= *timestamp && now < *timestamp + delay)
1540         return FALSE;
1541
1542     *timestamp = now;
1543     return TRUE;
1544 }
1545
1546 /* --------------------------------------------------------------------------------------------- */