src/xrdb.c

   1 /* Deal with the X Resource Manager.
   2    Copyright (C) 1990, 1993-1994, 2000-2018 Free Software Foundation,
   3    Inc.
   4
   5 Author: Joseph Arceneaux
   6 Created: 4/90
   7
   8 This file is part of GNU Emacs.
   9
  10 GNU Emacs is free software: you can redistribute it and/or modify
  11 it under the terms of the GNU General Public License as published by
  12 the Free Software Foundation, either version 3 of the License, or (at
  13 your option) any later version.
  14
  15 GNU Emacs is distributed in the hope that it will be useful,
  16 but WITHOUT ANY WARRANTY; without even the implied warranty of
  17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18 GNU General Public License for more details.
  19
  20 You should have received a copy of the GNU General Public License
  21 along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.  */
  22
  23 #include <config.h>
  24
  25 #include <unistd.h>
  26 #include <errno.h>
  27 #include <epaths.h>
  28 #include <stdlib.h>
  29 #include <stdio.h>
  30
  31 #include "lisp.h"
  32
  33 /* This may include sys/types.h, and that somehow loses
  34    if this is not done before the other system files.  */
  35 #include "xterm.h"
  36
  37 #include <X11/Xlib.h>
  38 #include <X11/Xatom.h>
  39 #include <X11/X.h>
  40 #include <X11/Xutil.h>
  41 #include <X11/Xresource.h>
  42 #ifdef HAVE_PWD_H
  43 #include <pwd.h>
  44 #endif
  45
  46 /* X file search path processing.  */
  47
  48
  49 /* The string which gets substituted for the %C escape in XFILESEARCHPATH
  50    and friends, or zero if none was specified.  */
  51 static char *x_customization_string;
  52
  53
  54 /* Return the value of the emacs.customization (Emacs.Customization)
  55    resource, for later use in search path decoding.  If we find no
  56    such resource, return zero.  */
  57 static char *
  58 x_get_customization_string (XrmDatabase db, const char *name,
  59                             const char *class)
  60 {
  61   char *full_name = alloca (strlen (name) + sizeof "customization" + 3);
  62   char *full_class = alloca (strlen (class) + sizeof "Customization" + 3);
  63   char *result;
  64
  65   sprintf (full_name,  "%s.%s", name,  "customization");
  66   sprintf (full_class, "%s.%s", class, "Customization");
  67
  68   result = x_get_string_resource (db, full_name, full_class);
  69   return result ? xstrdup (result) : NULL;
  70 }
  71
  72 /* Expand all the Xt-style %-escapes in STRING, whose length is given
  73    by STRING_LEN.  Here are the escapes we're supposed to recognize:
  74
  75         %N      The value of the application's class name
  76         %T      The value of the type parameter ("app-defaults" in this
  77                 context)
  78         %S      The value of the suffix parameter ("" in this context)
  79         %L      The language string associated with the specified display
  80                 (We use the "LANG" environment variable here, if it's set.)
  81         %l      The language part of the display's language string
  82                 (We treat this just like %L.  If someone can tell us what
  83                  we're really supposed to do, dandy.)
  84         %t      The territory part of the display's language string
  85                 (This never gets used.)
  86         %c      The codeset part of the display's language string
  87                 (This never gets used either.)
  88         %C      The customization string retrieved from the resource
  89                 database associated with display.
  90                 (This is x_customization_string.)
  91
  92    Return the resource database if its file was read successfully, and
  93    refers to %L only when the LANG environment variable is set, or
  94    otherwise provided by X.
  95
  96    ESCAPED_SUFFIX is postpended to STRING if it is non-zero.
  97    %-escapes in ESCAPED_SUFFIX are expanded.
  98
  99    Return NULL otherwise.  */
 100
 101 static XrmDatabase
 102 magic_db (const char *string, ptrdiff_t string_len, const char *class,
 103           const char *escaped_suffix)
 104 {
 105   XrmDatabase db;
 106   char *lang = getenv ("LANG");
 107
 108   ptrdiff_t path_size = 100;
 109   char *path = xmalloc (path_size);
 110   ptrdiff_t path_len = 0;
 111
 112   const char *p = string;
 113
 114   while (p < string + string_len)
 115     {
 116       /* The chunk we're about to stick on the end of result.  */
 117       const char *next = p;
 118       ptrdiff_t next_len = 1;
 119
 120       if (*p == '%')
 121         {
 122           p++;
 123
 124           if (p >= string + string_len)
 125             next_len = 0;
 126           else
 127             switch (*p)
 128               {
 129               case '%':
 130                 next = "%";
 131                 next_len = 1;
 132                 break;
 133
 134               case 'C':
 135                 if (x_customization_string)
 136                   {
 137                     next = x_customization_string;
 138                     next_len = strlen (next);
 139                   }
 140                 else
 141                   next_len = 0;
 142                 break;
 143
 144               case 'N':
 145                 next = class;
 146                 next_len = strlen (class);
 147                 break;
 148
 149               case 'T':
 150                 next = "app-defaults";
 151                 next_len = strlen (next);
 152                 break;
 153
 154               default:
 155               case 'S':
 156                 next_len = 0;
 157                 break;
 158
 159               case 'L':
 160               case 'l':
 161                 if (! lang)
 162                   {
 163                     xfree (path);
 164                     return NULL;
 165                   }
 166
 167                 next = lang;
 168                 next_len = strlen (next);
 169                 break;
 170
 171               case 't':
 172               case 'c':
 173                 xfree (path);
 174                 return NULL;
 175               }
 176         }
 177
 178       /* Do we have room for this component followed by a '\0'?  */
 179       if (path_size - path_len <= next_len)
 180         path = xpalloc (path, &path_size, path_len - path_size + next_len + 1,
 181                         -1, sizeof *path);
 182
 183       memcpy (path + path_len, next, next_len);
 184       path_len += next_len;
 185
 186       p++;
 187
 188       /* If we've reached the end of the string, append ESCAPED_SUFFIX.  */
 189       if (p >= string + string_len && escaped_suffix)
 190         {
 191           string = escaped_suffix;
 192           string_len = strlen (string);
 193           p = string;
 194           escaped_suffix = NULL;
 195         }
 196     }
 197
 198   path[path_len] = '\0';
 199   db = XrmGetFileDatabase (path);
 200   xfree (path);
 201   return db;
 202 }
 203
 204
 205 static char *
 206 gethomedir (void)
 207 {
 208   struct passwd *pw;
 209   char *ptr;
 210   char *copy;
 211
 212   if ((ptr = getenv ("HOME")) == NULL)
 213     {
 214       if ((ptr = getenv ("LOGNAME")) != NULL
 215           || (ptr = getenv ("USER")) != NULL)
 216         pw = getpwnam (ptr);
 217       else
 218         pw = getpwuid (getuid ());
 219
 220       if (pw)
 221         ptr = pw->pw_dir;
 222     }
 223
 224   if (ptr == NULL)
 225     return xstrdup ("/");
 226
 227   ptrdiff_t len = strlen (ptr);
 228   copy = xmalloc (len + 2);
 229   strcpy (copy + len, "/");
 230   return memcpy (copy, ptr, len);
 231 }
 232
 233
 234 /* Find the first element of SEARCH_PATH which exists and is readable,
 235    after expanding the %-escapes.  Return 0 if we didn't find any, and
 236    the path name of the one we found otherwise.  */
 237
 238 static XrmDatabase
 239 search_magic_path (const char *search_path, const char *class,
 240                    const char *escaped_suffix)
 241 {
 242   const char *s, *p;
 243
 244   for (s = search_path; *s; s = p)
 245     {
 246       for (p = s; *p && *p != ':'; p++)
 247         ;
 248
 249       if (p > s)
 250         {
 251           XrmDatabase db = magic_db (s, p - s, class, escaped_suffix);
 252           if (db)
 253             return db;
 254         }
 255       else if (*p == ':')
 256         {
 257           static char const ns[] = "%N%S";
 258           XrmDatabase db = magic_db (ns, strlen (ns), class, escaped_suffix);
 259           if (db)
 260             return db;
 261         }
 262
 263       if (*p == ':')
 264         p++;
 265     }
 266
 267   return 0;
 268 }
 269 \f
 270 /* Producing databases for individual sources.  */
 271
 272 static XrmDatabase
 273 get_system_app (const char *class)
 274 {
 275   const char *path;
 276
 277   path = getenv ("XFILESEARCHPATH");
 278   if (! path) path = PATH_X_DEFAULTS;
 279
 280   return search_magic_path (path, class, 0);
 281 }
 282
 283
 284 static XrmDatabase
 285 get_fallback (Display *display)
 286 {
 287   return NULL;
 288 }
 289
 290
 291 static XrmDatabase
 292 get_user_app (const char *class)
 293 {
 294   XrmDatabase db = 0;
 295   const char *path;
 296
 297   /* Check for XUSERFILESEARCHPATH.  It is a path of complete file
 298      names, not directories.  */
 299   path = getenv ("XUSERFILESEARCHPATH");
 300   if (path)
 301     db = search_magic_path (path, class, 0);
 302
 303   if (! db)
 304     {
 305       /* Check for APPLRESDIR; it is a path of directories.  In each,
 306          we have to search for LANG/CLASS and then CLASS.  */
 307       path = getenv ("XAPPLRESDIR");
 308       if (path)
 309         {
 310           db = search_magic_path (path, class, "/%L/%N");
 311           if (!db)
 312             db = search_magic_path (path, class, "/%N");
 313         }
 314     }
 315
 316   if (! db)
 317     {
 318       /* Check in the home directory.  This is a bit of a hack; let's
 319          hope one's home directory doesn't contain any %-escapes.  */
 320       char *home = gethomedir ();
 321       db = search_magic_path (home, class, "%L/%N");
 322       if (! db)
 323         db = search_magic_path (home, class, "%N");
 324       xfree (home);
 325     }
 326
 327   return db;
 328 }
 329
 330 static char const xdefaults[] = ".Xdefaults";
 331
 332 static XrmDatabase
 333 get_user_db (Display *display)
 334 {
 335   XrmDatabase db;
 336   char *xdefs;
 337
 338 #ifdef PBaseSize                /* Cheap way to test for X11R4 or later.  */
 339   xdefs = XResourceManagerString (display);
 340 #else
 341   xdefs = display->xdefaults;
 342 #endif
 343
 344   if (xdefs != NULL)
 345     db = XrmGetStringDatabase (xdefs);
 346   else
 347     {
 348       /* Use ~/.Xdefaults.  */
 349       char *home = gethomedir ();
 350       ptrdiff_t homelen = strlen (home);
 351       char *filename = xrealloc (home, homelen + sizeof xdefaults);
 352       strcpy (filename + homelen, xdefaults);
 353       db = XrmGetFileDatabase (filename);
 354       xfree (filename);
 355     }
 356
 357 #ifdef HAVE_XSCREENRESOURCESTRING
 358   /* Get the screen-specific resources too.  */
 359   xdefs = XScreenResourceString (DefaultScreenOfDisplay (display));
 360   if (xdefs != NULL)
 361     {
 362       XrmMergeDatabases (XrmGetStringDatabase (xdefs), &db);
 363       XFree (xdefs);
 364     }
 365 #endif
 366
 367   return db;
 368 }
 369
 370 static XrmDatabase
 371 get_environ_db (void)
 372 {
 373   XrmDatabase db;
 374   char *p = getenv ("XENVIRONMENT");
 375   char *filename = 0;
 376
 377   if (!p)
 378     {
 379       Lisp_Object system_name = Fsystem_name ();
 380       if (STRINGP (system_name))
 381         {
 382           /* Use ~/.Xdefaults-HOSTNAME.  */
 383           char *home = gethomedir ();
 384           ptrdiff_t homelen = strlen (home);
 385           ptrdiff_t filenamesize = (homelen + sizeof xdefaults
 386                                     + 1 + SBYTES (system_name));
 387           p = filename = xrealloc (home, filenamesize);
 388           lispstpcpy (stpcpy (stpcpy (filename + homelen, xdefaults), "-"),
 389                       system_name);
 390         }
 391     }
 392
 393   db = XrmGetFileDatabase (p);
 394
 395   xfree (filename);
 396
 397   return db;
 398 }
 399 \f
 400 /* External interface.  */
 401
 402 /* Types of values that we can find in a database */
 403
 404 #define XrmStringType "String"  /* String representation */
 405 static XrmRepresentation x_rm_string;   /* Quark representation */
 406
 407 /* Load X resources based on the display and a possible -xrm option. */
 408
 409 XrmDatabase
 410 x_load_resources (Display *display, const char *xrm_string,
 411                   const char *myname, const char *myclass)
 412 {
 413   XrmDatabase user_database;
 414   XrmDatabase rdb;
 415   XrmDatabase db;
 416   char line[256];
 417
 418 #if defined USE_MOTIF || !defined HAVE_XFT || !defined USE_LUCID
 419   const char *helv = "-*-helvetica-medium-r-*--*-120-*-*-*-*-iso8859-1";
 420 #endif
 421
 422 #ifdef USE_MOTIF
 423   const char *courier = "-*-courier-medium-r-*-*-*-120-*-*-*-*-iso8859-1";
 424 #endif
 425
 426   x_rm_string = XrmStringToQuark (XrmStringType);
 427 #ifndef USE_X_TOOLKIT
 428   /* pmr@osf.org says this shouldn't be done if USE_X_TOOLKIT.
 429      I suspect it's because the toolkit version does this elsewhere.  */
 430   XrmInitialize ();
 431 #endif
 432   rdb = XrmGetStringDatabase ("");
 433
 434   /* Add some font defaults.  If the font `helv' doesn't exist, widgets
 435      will use some other default font.  */
 436 #ifdef USE_MOTIF
 437
 438   sprintf (line, "%s.pane.background: grey75", myclass);
 439   XrmPutLineResource (&rdb, line);
 440   sprintf (line, "%s*fontList: %s", myclass, helv);
 441   XrmPutLineResource (&rdb, line);
 442   sprintf (line, "%s*menu*background: grey75", myclass);
 443   XrmPutLineResource (&rdb, line);
 444   sprintf (line, "%s*menubar*background: grey75", myclass);
 445   XrmPutLineResource (&rdb, line);
 446   sprintf (line, "%s*verticalScrollBar.background: grey75", myclass);
 447   XrmPutLineResource (&rdb, line);
 448   sprintf (line, "%s*verticalScrollBar.troughColor: grey75", myclass);
 449   XrmPutLineResource (&rdb, line);
 450   sprintf (line, "%s*horizontalScrollBar.background: grey75", myclass);
 451   XrmPutLineResource (&rdb, line);
 452   sprintf (line, "%s*horizontalScrollBar.troughColor: grey75", myclass);
 453   XrmPutLineResource (&rdb, line);
 454   sprintf (line, "%s.dialog*.background: grey75", myclass);
 455   XrmPutLineResource (&rdb, line);
 456   sprintf (line, "%s*fsb.Text.background: white", myclass);
 457   XrmPutLineResource (&rdb, line);
 458   sprintf (line, "%s*fsb.FilterText.background: white", myclass);
 459   XrmPutLineResource (&rdb, line);
 460   sprintf (line, "%s*fsb*DirList.background: white", myclass);
 461   XrmPutLineResource (&rdb, line);
 462   sprintf (line, "%s*fsb*ItemsList.background: white", myclass);
 463   XrmPutLineResource (&rdb, line);
 464   sprintf (line, "%s*fsb*background: grey75", myclass);
 465   XrmPutLineResource (&rdb, line);
 466   sprintf (line, "%s*fsb.Text.fontList: %s", myclass, courier);
 467   XrmPutLineResource (&rdb, line);
 468   sprintf (line, "%s*fsb.FilterText.fontList: %s", myclass, courier);
 469   XrmPutLineResource (&rdb, line);
 470   sprintf (line, "%s*fsb*ItemsList.fontList: %s", myclass, courier);
 471   XrmPutLineResource (&rdb, line);
 472   sprintf (line, "%s*fsb*DirList.fontList: %s", myclass, courier);
 473   XrmPutLineResource (&rdb, line);
 474
 475   /* Set double click time of list boxes in the file selection
 476      dialog from `double-click-time'.  */
 477   if (INTEGERP (Vdouble_click_time) && XINT (Vdouble_click_time) > 0)
 478     {
 479       sprintf (line, "%s*fsb*DirList.doubleClickInterval: %"pI"d",
 480                myclass, XFASTINT (Vdouble_click_time));
 481       XrmPutLineResource (&rdb, line);
 482       sprintf (line, "%s*fsb*ItemsList.doubleClickInterval: %"pI"d",
 483                myclass, XFASTINT (Vdouble_click_time));
 484       XrmPutLineResource (&rdb, line);
 485     }
 486
 487 #else /* not USE_MOTIF */
 488
 489   sprintf (line, "Emacs.dialog*.background: grey75");
 490   XrmPutLineResource (&rdb, line);
 491 #if !defined (HAVE_XFT) || !defined (USE_LUCID)
 492   sprintf (line, "Emacs.dialog*.font: %s", helv);
 493   XrmPutLineResource (&rdb, line);
 494   sprintf (line, "*XlwMenu*font: %s", helv);
 495   XrmPutLineResource (&rdb, line);
 496 #endif
 497   sprintf (line, "*XlwMenu*background: grey75");
 498   XrmPutLineResource (&rdb, line);
 499   sprintf (line, "Emacs*verticalScrollBar.background: grey75");
 500   XrmPutLineResource (&rdb, line);
 501   sprintf (line, "Emacs*horizontalScrollBar.background: grey75");
 502   XrmPutLineResource (&rdb, line);
 503
 504 #endif /* not USE_MOTIF */
 505
 506   user_database = get_user_db (display);
 507
 508   /* Figure out what the "customization string" is, so we can use it
 509      to decode paths.  */
 510   xfree (x_customization_string);
 511   x_customization_string
 512     = x_get_customization_string (user_database, myname, myclass);
 513
 514   /* Get application system defaults */
 515   db = get_system_app (myclass);
 516   if (db != NULL)
 517     XrmMergeDatabases (db, &rdb);
 518
 519   /* Get Fallback resources */
 520   db = get_fallback (display);
 521   if (db != NULL)
 522     XrmMergeDatabases (db, &rdb);
 523
 524   /* Get application user defaults */
 525   db = get_user_app (myclass);
 526   if (db != NULL)
 527     XrmMergeDatabases (db, &rdb);
 528
 529   /* get User defaults */
 530   if (user_database != NULL)
 531     XrmMergeDatabases (user_database, &rdb);
 532
 533   /* Get Environment defaults. */
 534   db = get_environ_db ();
 535   if (db != NULL)
 536     XrmMergeDatabases (db, &rdb);
 537
 538   /* Last, merge in any specification from the command line. */
 539   if (xrm_string != NULL)
 540     {
 541       db = XrmGetStringDatabase (xrm_string);
 542       if (db != NULL)
 543         XrmMergeDatabases (db, &rdb);
 544     }
 545
 546   return rdb;
 547 }
 548
 549
 550 /* Retrieve the value of the resource specified by NAME with class CLASS
 551    and of type TYPE from database RDB.  The value is returned in RET_VALUE. */
 552
 553 static int
 554 x_get_resource (XrmDatabase rdb, const char *name, const char *class,
 555                 XrmRepresentation expected_type, XrmValue *ret_value)
 556 {
 557   XrmValue value;
 558   XrmName namelist[100];
 559   XrmClass classlist[100];
 560   XrmRepresentation type;
 561
 562   XrmStringToNameList (name, namelist);
 563   XrmStringToClassList (class, classlist);
 564
 565   if (XrmQGetResource (rdb, namelist, classlist, &type, &value) == True
 566       && (type == expected_type))
 567     {
 568       if (type == x_rm_string)
 569         ret_value->addr = (char *) value.addr;
 570       else
 571         memcpy (ret_value->addr, value.addr, ret_value->size);
 572
 573       return value.size;
 574     }
 575
 576   return 0;
 577 }
 578
 579 /* Retrieve the string resource specified by NAME with CLASS from
 580    database RDB. */
 581
 582 char *
 583 x_get_string_resource (XrmDatabase rdb, const char *name, const char *class)
 584 {
 585   XrmValue value;
 586
 587   if (inhibit_x_resources)
 588     /* --quick was passed, so this is a no-op.  */
 589     return NULL;
 590
 591   if (x_get_resource (rdb, name, class, x_rm_string, &value))
 592     return (char *) value.addr;
 593
 594   return 0;
 595 }
 596 \f
 597 /* Stand-alone test facilities.  */
 598
 599 #ifdef TESTRM
 600
 601 typedef char **List;
 602 #define arg_listify(len, list) (list)
 603 #define car(list) (*(list))
 604 #define cdr(list) (list + 1)
 605 #define NIL(list) (! *(list))
 606 #define free_arglist(list)
 607
 608 static List
 609 member (char *elt, List list)
 610 {
 611   List p;
 612
 613   for (p = list; ! NIL (p); p = cdr (p))
 614     if (! strcmp (elt, car (p)))
 615       return p;
 616
 617   return p;
 618 }
 619
 620 static void
 621 fatal (char *msg, char *prog)
 622 {
 623   fprintf (stderr, msg, prog);
 624   exit (1);
 625 }
 626
 627 int
 628 main (int argc, char **argv)
 629 {
 630   Display *display;
 631   char *displayname, *resource_string, *class, *name;
 632   XrmDatabase xdb;
 633   List arg_list, lp;
 634
 635   arg_list = arg_listify (argc, argv);
 636
 637   lp = member ("-d", arg_list);
 638   if (!NIL (lp))
 639     displayname = car (cdr (lp));
 640   else
 641     displayname = "localhost:0.0";
 642
 643   lp = member ("-xrm", arg_list);
 644   resource_string = NIL (lp) ? 0 : car (cdr (lp));
 645
 646   lp = member ("-c", arg_list);
 647   if (! NIL (lp))
 648     class = car (cdr (lp));
 649   else
 650     class = "Emacs";
 651
 652   lp = member ("-n", arg_list);
 653   if (! NIL (lp))
 654     name = car (cdr (lp));
 655   else
 656     name = "emacs";
 657
 658   free_arglist (arg_list);
 659
 660   if (!(display = XOpenDisplay (displayname)))
 661     fatal ("Can't open display '%s'\n", XDisplayName (displayname));
 662
 663   xdb = x_load_resources (display, resource_string, name, class);
 664
 665   /* In a real program, you'd want to also do this: */
 666   display->db = xdb;
 667
 668   while (true)
 669     {
 670       char query_name[90];
 671       char query_class[90];
 672
 673       printf ("Name: ");
 674       gets (query_name);
 675
 676       if (strlen (query_name))
 677         {
 678           char *value;
 679
 680           printf ("Class: ");
 681           gets (query_class);
 682
 683           value = x_get_string_resource (xdb, query_name, query_class);
 684
 685           if (value != NULL)
 686             printf ("\t%s(%s):  %s\n\n", query_name, query_class, value);
 687           else
 688             printf ("\tNo Value.\n\n");
 689         }
 690       else
 691         break;
 692     }
 693   printf ("\tExit.\n\n");
 694
 695   XCloseDisplay (display);
 696
 697   return 0;
 698 }
 699 #endif /* TESTRM */