dbus/dbus-sysdeps-util-unix.c

   1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
   2 /* dbus-sysdeps-util-unix.c Would be in dbus-sysdeps-unix.c, but not used in libdbus
   3  *
   4  * Copyright (C) 2002, 2003, 2004, 2005  Red Hat, Inc.
   5  * Copyright (C) 2003 CodeFactory AB
   6  *
   7  * Licensed under the Academic Free License version 2.1
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 2 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License
  20  * along with this program; if not, write to the Free Software
  21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  22  *
  23  */
  24 #include "dbus-sysdeps.h"
  25 #include "dbus-sysdeps-unix.h"
  26 #include "dbus-internals.h"
  27 #include "dbus-protocol.h"
  28 #include "dbus-string.h"
  29 #define DBUS_USERDB_INCLUDES_PRIVATE 1
  30 #include "dbus-userdb.h"
  31 #include "dbus-test.h"
  32
  33 #include <sys/types.h>
  34 #include <stdlib.h>
  35 #include <string.h>
  36 #include <signal.h>
  37 #include <unistd.h>
  38 #include <stdio.h>
  39 #include <errno.h>
  40 #include <fcntl.h>
  41 #include <sys/stat.h>
  42 #include <grp.h>
  43 #include <sys/socket.h>
  44 #include <dirent.h>
  45 #include <sys/un.h>
  46 #include <syslog.h>
  47
  48 #ifdef HAVE_SYS_SYSLIMITS_H
  49 #include <sys/syslimits.h>
  50 #endif
  51
  52 #ifndef O_BINARY
  53 #define O_BINARY 0
  54 #endif
  55
  56 /**
  57  * @addtogroup DBusInternalsUtils
  58  * @{
  59  */
  60
  61
  62 /**
  63  * Does the chdir, fork, setsid, etc. to become a daemon process.
  64  *
  65  * @param pidfile #NULL, or pidfile to create
  66  * @param print_pid_pipe pipe to print daemon's pid to, or -1 for none
  67  * @param error return location for errors
  68  * @param keep_umask #TRUE to keep the original umask
  69  * @returns #FALSE on failure
  70  */
  71 dbus_bool_t
  72 _dbus_become_daemon (const DBusString *pidfile,
  73                      DBusPipe         *print_pid_pipe,
  74                      DBusError        *error,
  75                      dbus_bool_t       keep_umask)
  76 {
  77   const char *s;
  78   pid_t child_pid;
  79   int dev_null_fd;
  80
  81   _dbus_verbose ("Becoming a daemon...\n");
  82
  83   _dbus_verbose ("chdir to /\n");
  84   if (chdir ("/") < 0)
  85     {
  86       dbus_set_error (error, DBUS_ERROR_FAILED,
  87                       "Could not chdir() to root directory");
  88       return FALSE;
  89     }
  90
  91   _dbus_verbose ("forking...\n");
  92   switch ((child_pid = fork ()))
  93     {
  94     case -1:
  95       _dbus_verbose ("fork failed\n");
  96       dbus_set_error (error, _dbus_error_from_errno (errno),
  97                       "Failed to fork daemon: %s", _dbus_strerror (errno));
  98       return FALSE;
  99       break;
 100
 101     case 0:
 102       _dbus_verbose ("in child, closing std file descriptors\n");
 103
 104       /* silently ignore failures here, if someone
 105        * doesn't have /dev/null we may as well try
 106        * to continue anyhow
 107        */
 108
 109       dev_null_fd = open ("/dev/null", O_RDWR);
 110       if (dev_null_fd >= 0)
 111         {
 112           dup2 (dev_null_fd, 0);
 113           dup2 (dev_null_fd, 1);
 114
 115           s = _dbus_getenv ("DBUS_DEBUG_OUTPUT");
 116           if (s == NULL || *s == '\0')
 117             dup2 (dev_null_fd, 2);
 118           else
 119             _dbus_verbose ("keeping stderr open due to DBUS_DEBUG_OUTPUT\n");
 120         }
 121
 122       if (!keep_umask)
 123         {
 124           /* Get a predictable umask */
 125           _dbus_verbose ("setting umask\n");
 126           umask (022);
 127         }
 128
 129       _dbus_verbose ("calling setsid()\n");
 130       if (setsid () == -1)
 131         _dbus_assert_not_reached ("setsid() failed");
 132
 133       break;
 134
 135     default:
 136       if (!_dbus_write_pid_to_file_and_pipe (pidfile, print_pid_pipe,
 137                                              child_pid, error))
 138         {
 139           _dbus_verbose ("pid file or pipe write failed: %s\n",
 140                          error->message);
 141           kill (child_pid, SIGTERM);
 142           return FALSE;
 143         }
 144
 145       _dbus_verbose ("parent exiting\n");
 146       _exit (0);
 147       break;
 148     }
 149
 150   return TRUE;
 151 }
 152
 153
 154 /**
 155  * Creates a file containing the process ID.
 156  *
 157  * @param filename the filename to write to
 158  * @param pid our process ID
 159  * @param error return location for errors
 160  * @returns #FALSE on failure
 161  */
 162 static dbus_bool_t
 163 _dbus_write_pid_file (const DBusString *filename,
 164                       unsigned long     pid,
 165                       DBusError        *error)
 166 {
 167   const char *cfilename;
 168   int fd;
 169   FILE *f;
 170
 171   cfilename = _dbus_string_get_const_data (filename);
 172
 173   fd = open (cfilename, O_WRONLY|O_CREAT|O_EXCL|O_BINARY, 0644);
 174
 175   if (fd < 0)
 176     {
 177       dbus_set_error (error, _dbus_error_from_errno (errno),
 178                       "Failed to open \"%s\": %s", cfilename,
 179                       _dbus_strerror (errno));
 180       return FALSE;
 181     }
 182
 183   if ((f = fdopen (fd, "w")) == NULL)
 184     {
 185       dbus_set_error (error, _dbus_error_from_errno (errno),
 186                       "Failed to fdopen fd %d: %s", fd, _dbus_strerror (errno));
 187       _dbus_close (fd, NULL);
 188       return FALSE;
 189     }
 190
 191   if (fprintf (f, "%lu\n", pid) < 0)
 192     {
 193       dbus_set_error (error, _dbus_error_from_errno (errno),
 194                       "Failed to write to \"%s\": %s", cfilename,
 195                       _dbus_strerror (errno));
 196
 197       fclose (f);
 198       return FALSE;
 199     }
 200
 201   if (fclose (f) == EOF)
 202     {
 203       dbus_set_error (error, _dbus_error_from_errno (errno),
 204                       "Failed to close \"%s\": %s", cfilename,
 205                       _dbus_strerror (errno));
 206       return FALSE;
 207     }
 208
 209   return TRUE;
 210 }
 211
 212 /**
 213  * Writes the given pid_to_write to a pidfile (if non-NULL) and/or to a
 214  * pipe (if non-NULL). Does nothing if pidfile and print_pid_pipe are both
 215  * NULL.
 216  *
 217  * @param pidfile the file to write to or #NULL
 218  * @param print_pid_pipe the pipe to write to or #NULL
 219  * @param pid_to_write the pid to write out
 220  * @param error error on failure
 221  * @returns FALSE if error is set
 222  */
 223 dbus_bool_t
 224 _dbus_write_pid_to_file_and_pipe (const DBusString *pidfile,
 225                                   DBusPipe         *print_pid_pipe,
 226                                   dbus_pid_t        pid_to_write,
 227                                   DBusError        *error)
 228 {
 229   if (pidfile)
 230     {
 231       _dbus_verbose ("writing pid file %s\n", _dbus_string_get_const_data (pidfile));
 232       if (!_dbus_write_pid_file (pidfile,
 233                                  pid_to_write,
 234                                  error))
 235         {
 236           _dbus_verbose ("pid file write failed\n");
 237           _DBUS_ASSERT_ERROR_IS_SET(error);
 238           return FALSE;
 239         }
 240     }
 241   else
 242     {
 243       _dbus_verbose ("No pid file requested\n");
 244     }
 245
 246   if (print_pid_pipe != NULL && _dbus_pipe_is_valid (print_pid_pipe))
 247     {
 248       DBusString pid;
 249       int bytes;
 250
 251       _dbus_verbose ("writing our pid to pipe %d\n", print_pid_pipe->fd_or_handle);
 252
 253       if (!_dbus_string_init (&pid))
 254         {
 255           _DBUS_SET_OOM (error);
 256           return FALSE;
 257         }
 258
 259       if (!_dbus_string_append_int (&pid, pid_to_write) ||
 260           !_dbus_string_append (&pid, "\n"))
 261         {
 262           _dbus_string_free (&pid);
 263           _DBUS_SET_OOM (error);
 264           return FALSE;
 265         }
 266
 267       bytes = _dbus_string_get_length (&pid);
 268       if (_dbus_pipe_write (print_pid_pipe, &pid, 0, bytes, error) != bytes)
 269         {
 270           /* _dbus_pipe_write sets error only on failure, not short write */
 271           if (error != NULL && !dbus_error_is_set(error))
 272             {
 273               dbus_set_error (error, DBUS_ERROR_FAILED,
 274                               "Printing message bus PID: did not write enough bytes\n");
 275             }
 276           _dbus_string_free (&pid);
 277           return FALSE;
 278         }
 279
 280       _dbus_string_free (&pid);
 281     }
 282   else
 283     {
 284       _dbus_verbose ("No pid pipe to write to\n");
 285     }
 286
 287   return TRUE;
 288 }
 289
 290 /**
 291  * Verify that after the fork we can successfully change to this user.
 292  *
 293  * @param user the username given in the daemon configuration
 294  * @returns #TRUE if username is valid
 295  */
 296 dbus_bool_t
 297 _dbus_verify_daemon_user (const char *user)
 298 {
 299   DBusString u;
 300
 301   _dbus_string_init_const (&u, user);
 302
 303   return _dbus_get_user_id_and_primary_group (&u, NULL, NULL);
 304 }
 305
 306
 307 /* The HAVE_LIBAUDIT case lives in selinux.c */
 308 #ifndef HAVE_LIBAUDIT
 309 /**
 310  * Changes the user and group the bus is running as.
 311  *
 312  * @param user the user to become
 313  * @param error return location for errors
 314  * @returns #FALSE on failure
 315  */
 316 dbus_bool_t
 317 _dbus_change_to_daemon_user  (const char    *user,
 318                               DBusError     *error)
 319 {
 320   dbus_uid_t uid;
 321   dbus_gid_t gid;
 322   DBusString u;
 323
 324   _dbus_string_init_const (&u, user);
 325
 326   if (!_dbus_get_user_id_and_primary_group (&u, &uid, &gid))
 327     {
 328       dbus_set_error (error, DBUS_ERROR_FAILED,
 329                       "User '%s' does not appear to exist?",
 330                       user);
 331       return FALSE;
 332     }
 333
 334   /* setgroups() only works if we are a privileged process,
 335    * so we don't return error on failure; the only possible
 336    * failure is that we don't have perms to do it.
 337    *
 338    * not sure this is right, maybe if setuid()
 339    * is going to work then setgroups() should also work.
 340    */
 341   if (setgroups (0, NULL) < 0)
 342     _dbus_warn ("Failed to drop supplementary groups: %s\n",
 343                 _dbus_strerror (errno));
 344
 345   /* Set GID first, or the setuid may remove our permission
 346    * to change the GID
 347    */
 348   if (setgid (gid) < 0)
 349     {
 350       dbus_set_error (error, _dbus_error_from_errno (errno),
 351                       "Failed to set GID to %lu: %s", gid,
 352                       _dbus_strerror (errno));
 353       return FALSE;
 354     }
 355
 356   if (setuid (uid) < 0)
 357     {
 358       dbus_set_error (error, _dbus_error_from_errno (errno),
 359                       "Failed to set UID to %lu: %s", uid,
 360                       _dbus_strerror (errno));
 361       return FALSE;
 362     }
 363
 364   return TRUE;
 365 }
 366 #endif /* !HAVE_LIBAUDIT */
 367
 368 void
 369 _dbus_init_system_log (void)
 370 {
 371   openlog ("dbus", LOG_PID, LOG_DAEMON);
 372 }
 373 /**
 374  * Log a message to the system log file (e.g. syslog on Unix).
 375  *
 376  * @param severity a severity value
 377  * @param msg a printf-style format string
 378  * @param args arguments for the format string
 379  *
 380  */
 381 void
 382 _dbus_system_log (DBusSystemLogSeverity severity, const char *msg, ...)
 383 {
 384   va_list args;
 385
 386   va_start (args, msg);
 387
 388   _dbus_system_logv (severity, msg, args);
 389
 390   va_end (args);
 391 }
 392
 393 /**
 394  * Log a message to the system log file (e.g. syslog on Unix).
 395  *
 396  * @param severity a severity value
 397  * @param msg a printf-style format string
 398  * @param args arguments for the format string
 399  *
 400  * If the FATAL severity is given, this function will terminate the program
 401  * with an error code.
 402  */
 403 void
 404 _dbus_system_logv (DBusSystemLogSeverity severity, const char *msg, va_list args)
 405 {
 406   int flags;
 407   switch (severity)
 408     {
 409       case DBUS_SYSTEM_LOG_INFO:
 410         flags =  LOG_DAEMON | LOG_NOTICE;
 411         break;
 412       case DBUS_SYSTEM_LOG_SECURITY:
 413         flags = LOG_AUTH | LOG_NOTICE;
 414         break;
 415       case DBUS_SYSTEM_LOG_FATAL:
 416         flags = LOG_DAEMON|LOG_CRIT;
 417       default:
 418         return;
 419     }
 420
 421   vsyslog (flags, msg, args);
 422
 423   if (severity == DBUS_SYSTEM_LOG_FATAL)
 424     exit (1);
 425 }
 426
 427 /** Installs a UNIX signal handler
 428  *
 429  * @param sig the signal to handle
 430  * @param handler the handler
 431  */
 432 void
 433 _dbus_set_signal_handler (int               sig,
 434                           DBusSignalHandler handler)
 435 {
 436   struct sigaction act;
 437   sigset_t empty_mask;
 438
 439   sigemptyset (&empty_mask);
 440   act.sa_handler = handler;
 441   act.sa_mask    = empty_mask;
 442   act.sa_flags   = 0;
 443   sigaction (sig,  &act, NULL);
 444 }
 445
 446 /** Checks if a file exists
 447 *
 448 * @param file full path to the file
 449 * @returns #TRUE if file exists
 450 */
 451 dbus_bool_t
 452 _dbus_file_exists (const char *file)
 453 {
 454   return (access (file, F_OK) == 0);
 455 }
 456
 457 /** Checks if user is at the console
 458 *
 459 * @param username user to check
 460 * @param error return location for errors
 461 * @returns #TRUE is the user is at the consolei and there are no errors
 462 */
 463 dbus_bool_t
 464 _dbus_user_at_console (const char *username,
 465                        DBusError  *error)
 466 {
 467
 468   DBusString f;
 469   dbus_bool_t result;
 470
 471   result = FALSE;
 472   if (!_dbus_string_init (&f))
 473     {
 474       _DBUS_SET_OOM (error);
 475       return FALSE;
 476     }
 477
 478   if (!_dbus_string_append (&f, DBUS_CONSOLE_AUTH_DIR))
 479     {
 480       _DBUS_SET_OOM (error);
 481       goto out;
 482     }
 483
 484
 485   if (!_dbus_string_append (&f, username))
 486     {
 487       _DBUS_SET_OOM (error);
 488       goto out;
 489     }
 490
 491   result = _dbus_file_exists (_dbus_string_get_const_data (&f));
 492
 493  out:
 494   _dbus_string_free (&f);
 495
 496   return result;
 497 }
 498
 499
 500 /**
 501  * Checks whether the filename is an absolute path
 502  *
 503  * @param filename the filename
 504  * @returns #TRUE if an absolute path
 505  */
 506 dbus_bool_t
 507 _dbus_path_is_absolute (const DBusString *filename)
 508 {
 509   if (_dbus_string_get_length (filename) > 0)
 510     return _dbus_string_get_byte (filename, 0) == '/';
 511   else
 512     return FALSE;
 513 }
 514
 515 /**
 516  * stat() wrapper.
 517  *
 518  * @param filename the filename to stat
 519  * @param statbuf the stat info to fill in
 520  * @param error return location for error
 521  * @returns #FALSE if error was set
 522  */
 523 dbus_bool_t
 524 _dbus_stat (const DBusString *filename,
 525             DBusStat         *statbuf,
 526             DBusError        *error)
 527 {
 528   const char *filename_c;
 529   struct stat sb;
 530
 531   _DBUS_ASSERT_ERROR_IS_CLEAR (error);
 532
 533   filename_c = _dbus_string_get_const_data (filename);
 534
 535   if (stat (filename_c, &sb) < 0)
 536     {
 537       dbus_set_error (error, _dbus_error_from_errno (errno),
 538                       "%s", _dbus_strerror (errno));
 539       return FALSE;
 540     }
 541
 542   statbuf->mode = sb.st_mode;
 543   statbuf->nlink = sb.st_nlink;
 544   statbuf->uid = sb.st_uid;
 545   statbuf->gid = sb.st_gid;
 546   statbuf->size = sb.st_size;
 547   statbuf->atime = sb.st_atime;
 548   statbuf->mtime = sb.st_mtime;
 549   statbuf->ctime = sb.st_ctime;
 550
 551   return TRUE;
 552 }
 553
 554
 555 /**
 556  * Internals of directory iterator
 557  */
 558 struct DBusDirIter
 559 {
 560   DIR *d; /**< The DIR* from opendir() */
 561
 562 };
 563
 564 /**
 565  * Open a directory to iterate over.
 566  *
 567  * @param filename the directory name
 568  * @param error exception return object or #NULL
 569  * @returns new iterator, or #NULL on error
 570  */
 571 DBusDirIter*
 572 _dbus_directory_open (const DBusString *filename,
 573                       DBusError        *error)
 574 {
 575   DIR *d;
 576   DBusDirIter *iter;
 577   const char *filename_c;
 578
 579   _DBUS_ASSERT_ERROR_IS_CLEAR (error);
 580
 581   filename_c = _dbus_string_get_const_data (filename);
 582
 583   d = opendir (filename_c);
 584   if (d == NULL)
 585     {
 586       dbus_set_error (error, _dbus_error_from_errno (errno),
 587                       "Failed to read directory \"%s\": %s",
 588                       filename_c,
 589                       _dbus_strerror (errno));
 590       return NULL;
 591     }
 592   iter = dbus_new0 (DBusDirIter, 1);
 593   if (iter == NULL)
 594     {
 595       closedir (d);
 596       dbus_set_error (error, DBUS_ERROR_NO_MEMORY,
 597                       "Could not allocate memory for directory iterator");
 598       return NULL;
 599     }
 600
 601   iter->d = d;
 602
 603   return iter;
 604 }
 605
 606 /* Calculate the required buffer size (in bytes) for directory
 607  * entries read from the given directory handle.  Return -1 if this
 608  * this cannot be done.
 609  *
 610  * If you use autoconf, include fpathconf and dirfd in your
 611  * AC_CHECK_FUNCS list.  Otherwise use some other method to detect
 612  * and use them where available.
 613  */
 614 static dbus_bool_t
 615 dirent_buf_size(DIR * dirp, size_t *size)
 616 {
 617  long name_max;
 618 #   if defined(HAVE_FPATHCONF) && defined(_PC_NAME_MAX)
 619 #      if defined(HAVE_DIRFD)
 620           name_max = fpathconf(dirfd(dirp), _PC_NAME_MAX);
 621 #      elif defined(HAVE_DDFD)
 622           name_max = fpathconf(dirp->dd_fd, _PC_NAME_MAX);
 623 #      else
 624           name_max = fpathconf(dirp->__dd_fd, _PC_NAME_MAX);
 625 #      endif /* HAVE_DIRFD */
 626      if (name_max == -1)
 627 #           if defined(NAME_MAX)
 628              name_max = NAME_MAX;
 629 #           else
 630              return FALSE;
 631 #           endif
 632 #   elif defined(MAXNAMELEN)
 633      name_max = MAXNAMELEN;
 634 #   else
 635 #       if defined(NAME_MAX)
 636          name_max = NAME_MAX;
 637 #       else
 638 #           error "buffer size for readdir_r cannot be determined"
 639 #       endif
 640 #   endif
 641   if (size)
 642     *size = (size_t)offsetof(struct dirent, d_name) + name_max + 1;
 643   else
 644     return FALSE;
 645
 646   return TRUE;
 647 }
 648
 649 /**
 650  * Get next file in the directory. Will not return "." or ".."  on
 651  * UNIX. If an error occurs, the contents of "filename" are
 652  * undefined. The error is never set if the function succeeds.
 653  *
 654  * @param iter the iterator
 655  * @param filename string to be set to the next file in the dir
 656  * @param error return location for error
 657  * @returns #TRUE if filename was filled in with a new filename
 658  */
 659 dbus_bool_t
 660 _dbus_directory_get_next_file (DBusDirIter      *iter,
 661                                DBusString       *filename,
 662                                DBusError        *error)
 663 {
 664   struct dirent *d, *ent;
 665   size_t buf_size;
 666   int err;
 667
 668   _DBUS_ASSERT_ERROR_IS_CLEAR (error);
 669
 670   if (!dirent_buf_size (iter->d, &buf_size))
 671     {
 672       dbus_set_error (error, DBUS_ERROR_FAILED,
 673                       "Can't calculate buffer size when reading directory");
 674       return FALSE;
 675     }
 676
 677   d = (struct dirent *)dbus_malloc (buf_size);
 678   if (!d)
 679     {
 680       dbus_set_error (error, DBUS_ERROR_NO_MEMORY,
 681                       "No memory to read directory entry");
 682       return FALSE;
 683     }
 684
 685  again:
 686   err = readdir_r (iter->d, d, &ent);
 687   if (err || !ent)
 688     {
 689       if (err != 0)
 690         dbus_set_error (error,
 691                         _dbus_error_from_errno (err),
 692                         "%s", _dbus_strerror (err));
 693
 694       dbus_free (d);
 695       return FALSE;
 696     }
 697   else if (ent->d_name[0] == '.' &&
 698            (ent->d_name[1] == '\0' ||
 699             (ent->d_name[1] == '.' && ent->d_name[2] == '\0')))
 700     goto again;
 701   else
 702     {
 703       _dbus_string_set_length (filename, 0);
 704       if (!_dbus_string_append (filename, ent->d_name))
 705         {
 706           dbus_set_error (error, DBUS_ERROR_NO_MEMORY,
 707                           "No memory to read directory entry");
 708           dbus_free (d);
 709           return FALSE;
 710         }
 711       else
 712         {
 713           dbus_free (d);
 714           return TRUE;
 715         }
 716     }
 717 }
 718
 719 /**
 720  * Closes a directory iteration.
 721  */
 722 void
 723 _dbus_directory_close (DBusDirIter *iter)
 724 {
 725   closedir (iter->d);
 726   dbus_free (iter);
 727 }
 728
 729 static dbus_bool_t
 730 fill_user_info_from_group (struct group  *g,
 731                            DBusGroupInfo *info,
 732                            DBusError     *error)
 733 {
 734   _dbus_assert (g->gr_name != NULL);
 735
 736   info->gid = g->gr_gid;
 737   info->groupname = _dbus_strdup (g->gr_name);
 738
 739   /* info->members = dbus_strdupv (g->gr_mem) */
 740
 741   if (info->groupname == NULL)
 742     {
 743       dbus_set_error (error, DBUS_ERROR_NO_MEMORY, NULL);
 744       return FALSE;
 745     }
 746
 747   return TRUE;
 748 }
 749
 750 static dbus_bool_t
 751 fill_group_info (DBusGroupInfo    *info,
 752                  dbus_gid_t        gid,
 753                  const DBusString *groupname,
 754                  DBusError        *error)
 755 {
 756   const char *group_c_str;
 757
 758   _dbus_assert (groupname != NULL || gid != DBUS_GID_UNSET);
 759   _dbus_assert (groupname == NULL || gid == DBUS_GID_UNSET);
 760
 761   if (groupname)
 762     group_c_str = _dbus_string_get_const_data (groupname);
 763   else
 764     group_c_str = NULL;
 765
 766   /* For now assuming that the getgrnam() and getgrgid() flavors
 767    * always correspond to the pwnam flavors, if not we have
 768    * to add more configure checks.
 769    */
 770
 771 #if defined (HAVE_POSIX_GETPWNAM_R) || defined (HAVE_NONPOSIX_GETPWNAM_R)
 772   {
 773     struct group *g;
 774     int result;
 775     size_t buflen;
 776     char *buf;
 777     struct group g_str;
 778     dbus_bool_t b;
 779
 780     /* retrieve maximum needed size for buf */
 781     buflen = sysconf (_SC_GETGR_R_SIZE_MAX);
 782
 783     /* sysconf actually returns a long, but everything else expects size_t,
 784      * so just recast here.
 785      * https://bugs.freedesktop.org/show_bug.cgi?id=17061
 786      */
 787     if ((long) buflen <= 0)
 788       buflen = 1024;
 789
 790     result = -1;
 791     while (1)
 792       {
 793         buf = dbus_malloc (buflen);
 794         if (buf == NULL)
 795           {
 796             dbus_set_error (error, DBUS_ERROR_NO_MEMORY, NULL);
 797             return FALSE;
 798           }
 799
 800         g = NULL;
 801 #ifdef HAVE_POSIX_GETPWNAM_R
 802         if (group_c_str)
 803           result = getgrnam_r (group_c_str, &g_str, buf, buflen,
 804                                &g);
 805         else
 806           result = getgrgid_r (gid, &g_str, buf, buflen,
 807                                &g);
 808 #else
 809         g = getgrnam_r (group_c_str, &g_str, buf, buflen);
 810         result = 0;
 811 #endif /* !HAVE_POSIX_GETPWNAM_R */
 812         /* Try a bigger buffer if ERANGE was returned:
 813            https://bugs.freedesktop.org/show_bug.cgi?id=16727
 814         */
 815         if (result == ERANGE && buflen < 512 * 1024)
 816           {
 817             dbus_free (buf);
 818             buflen *= 2;
 819           }
 820         else
 821           {
 822             break;
 823           }
 824       }
 825
 826     if (result == 0 && g == &g_str)
 827       {
 828         b = fill_user_info_from_group (g, info, error);
 829         dbus_free (buf);
 830         return b;
 831       }
 832     else
 833       {
 834         dbus_set_error (error, _dbus_error_from_errno (errno),
 835                         "Group %s unknown or failed to look it up\n",
 836                         group_c_str ? group_c_str : "???");
 837         dbus_free (buf);
 838         return FALSE;
 839       }
 840   }
 841 #else /* ! HAVE_GETPWNAM_R */
 842   {
 843     /* I guess we're screwed on thread safety here */
 844     struct group *g;
 845
 846     g = getgrnam (group_c_str);
 847
 848     if (g != NULL)
 849       {
 850         return fill_user_info_from_group (g, info, error);
 851       }
 852     else
 853       {
 854         dbus_set_error (error, _dbus_error_from_errno (errno),
 855                         "Group %s unknown or failed to look it up\n",
 856                         group_c_str ? group_c_str : "???");
 857         return FALSE;
 858       }
 859   }
 860 #endif  /* ! HAVE_GETPWNAM_R */
 861 }
 862
 863 /**
 864  * Initializes the given DBusGroupInfo struct
 865  * with information about the given group name.
 866  *
 867  * @param info the group info struct
 868  * @param groupname name of group
 869  * @param error the error return
 870  * @returns #FALSE if error is set
 871  */
 872 dbus_bool_t
 873 _dbus_group_info_fill (DBusGroupInfo    *info,
 874                        const DBusString *groupname,
 875                        DBusError        *error)
 876 {
 877   return fill_group_info (info, DBUS_GID_UNSET,
 878                           groupname, error);
 879
 880 }
 881
 882 /**
 883  * Initializes the given DBusGroupInfo struct
 884  * with information about the given group ID.
 885  *
 886  * @param info the group info struct
 887  * @param gid group ID
 888  * @param error the error return
 889  * @returns #FALSE if error is set
 890  */
 891 dbus_bool_t
 892 _dbus_group_info_fill_gid (DBusGroupInfo *info,
 893                            dbus_gid_t     gid,
 894                            DBusError     *error)
 895 {
 896   return fill_group_info (info, gid, NULL, error);
 897 }
 898
 899 /**
 900  * Parse a UNIX user from the bus config file. On Windows, this should
 901  * simply always fail (just return #FALSE).
 902  *
 903  * @param username the username text
 904  * @param uid_p place to return the uid
 905  * @returns #TRUE on success
 906  */
 907 dbus_bool_t
 908 _dbus_parse_unix_user_from_config (const DBusString  *username,
 909                                    dbus_uid_t        *uid_p)
 910 {
 911   return _dbus_get_user_id (username, uid_p);
 912
 913 }
 914
 915 /**
 916  * Parse a UNIX group from the bus config file. On Windows, this should
 917  * simply always fail (just return #FALSE).
 918  *
 919  * @param groupname the groupname text
 920  * @param gid_p place to return the gid
 921  * @returns #TRUE on success
 922  */
 923 dbus_bool_t
 924 _dbus_parse_unix_group_from_config (const DBusString  *groupname,
 925                                     dbus_gid_t        *gid_p)
 926 {
 927   return _dbus_get_group_id (groupname, gid_p);
 928 }
 929
 930 /**
 931  * Gets all groups corresponding to the given UNIX user ID. On UNIX,
 932  * just calls _dbus_groups_from_uid(). On Windows, should always
 933  * fail since we don't know any UNIX groups.
 934  *
 935  * @param uid the UID
 936  * @param group_ids return location for array of group IDs
 937  * @param n_group_ids return location for length of returned array
 938  * @returns #TRUE if the UID existed and we got some credentials
 939  */
 940 dbus_bool_t
 941 _dbus_unix_groups_from_uid (dbus_uid_t            uid,
 942                             dbus_gid_t          **group_ids,
 943                             int                  *n_group_ids)
 944 {
 945   return _dbus_groups_from_uid (uid, group_ids, n_group_ids);
 946 }
 947
 948 /**
 949  * Checks to see if the UNIX user ID is at the console.
 950  * Should always fail on Windows (set the error to
 951  * #DBUS_ERROR_NOT_SUPPORTED).
 952  *
 953  * @param uid UID of person to check
 954  * @param error return location for errors
 955  * @returns #TRUE if the UID is the same as the console user and there are no errors
 956  */
 957 dbus_bool_t
 958 _dbus_unix_user_is_at_console (dbus_uid_t         uid,
 959                                DBusError         *error)
 960 {
 961   return _dbus_is_console_user (uid, error);
 962
 963 }
 964
 965 /**
 966  * Checks to see if the UNIX user ID matches the UID of
 967  * the process. Should always return #FALSE on Windows.
 968  *
 969  * @param uid the UNIX user ID
 970  * @returns #TRUE if this uid owns the process.
 971  */
 972 dbus_bool_t
 973 _dbus_unix_user_is_process_owner (dbus_uid_t uid)
 974 {
 975   return uid == _dbus_geteuid ();
 976 }
 977
 978 /**
 979  * Checks to see if the Windows user SID matches the owner of
 980  * the process. Should always return #FALSE on UNIX.
 981  *
 982  * @param windows_sid the Windows user SID
 983  * @returns #TRUE if this user owns the process.
 984  */
 985 dbus_bool_t
 986 _dbus_windows_user_is_process_owner (const char *windows_sid)
 987 {
 988   return FALSE;
 989 }
 990
 991 /** @} */ /* End of DBusInternalsUtils functions */
 992
 993 /**
 994  * @addtogroup DBusString
 995  *
 996  * @{
 997  */
 998 /**
 999  * Get the directory name from a complete filename
1000  * @param filename the filename
1001  * @param dirname string to append directory name to
1002  * @returns #FALSE if no memory
1003  */
1004 dbus_bool_t
1005 _dbus_string_get_dirname  (const DBusString *filename,
1006                            DBusString       *dirname)
1007 {
1008   int sep;
1009
1010   _dbus_assert (filename != dirname);
1011   _dbus_assert (filename != NULL);
1012   _dbus_assert (dirname != NULL);
1013
1014   /* Ignore any separators on the end */
1015   sep = _dbus_string_get_length (filename);
1016   if (sep == 0)
1017     return _dbus_string_append (dirname, "."); /* empty string passed in */
1018
1019   while (sep > 0 && _dbus_string_get_byte (filename, sep - 1) == '/')
1020     --sep;
1021
1022   _dbus_assert (sep >= 0);
1023
1024   if (sep == 0)
1025     return _dbus_string_append (dirname, "/");
1026
1027   /* Now find the previous separator */
1028   _dbus_string_find_byte_backward (filename, sep, '/', &sep);
1029   if (sep < 0)
1030     return _dbus_string_append (dirname, ".");
1031
1032   /* skip multiple separators */
1033   while (sep > 0 && _dbus_string_get_byte (filename, sep - 1) == '/')
1034     --sep;
1035
1036   _dbus_assert (sep >= 0);
1037
1038   if (sep == 0 &&
1039       _dbus_string_get_byte (filename, 0) == '/')
1040     return _dbus_string_append (dirname, "/");
1041   else
1042     return _dbus_string_copy_len (filename, 0, sep - 0,
1043                                   dirname, _dbus_string_get_length (dirname));
1044 }
1045 /** @} */ /* DBusString stuff */
1046
1047 static void
1048 string_squash_nonprintable (DBusString *str)
1049 {
1050   unsigned char *buf;
1051   int i, len;
1052
1053   buf = _dbus_string_get_data (str);
1054   len = _dbus_string_get_length (str);
1055
1056   for (i = 0; i < len; i++)
1057     {
1058           unsigned char c = (unsigned char) buf[i];
1059       if (c == '\0')
1060         c = ' ';
1061       else if (c < 0x20 || c > 127)
1062         c = '?';
1063     }
1064 }
1065
1066 /**
1067  * Get a printable string describing the command used to execute
1068  * the process with pid.  This string should only be used for
1069  * informative purposes such as logging; it may not be trusted.
1070  *
1071  * The command is guaranteed to be printable ASCII and no longer
1072  * than max_len.
1073  *
1074  * @param pid Process id
1075  * @param str Append command to this string
1076  * @param max_len Maximum length of returned command
1077  * @param error return location for errors
1078  * @returns #FALSE on error
1079  */
1080 dbus_bool_t
1081 _dbus_command_for_pid (unsigned long  pid,
1082                        DBusString    *str,
1083                        int            max_len,
1084                        DBusError     *error)
1085 {
1086   /* This is all Linux-specific for now */
1087   DBusString path;
1088   DBusString cmdline;
1089   int fd;
1090
1091   if (!_dbus_string_init (&path))
1092     {
1093       _DBUS_SET_OOM (error);
1094       return FALSE;
1095     }
1096
1097   if (!_dbus_string_init (&cmdline))
1098     {
1099       _DBUS_SET_OOM (error);
1100       _dbus_string_free (&path);
1101       return FALSE;
1102     }
1103
1104   if (!_dbus_string_append_printf (&path, "/proc/%ld/cmdline", pid))
1105     goto oom;
1106
1107   fd = open (_dbus_string_get_const_data (&path), O_RDONLY);
1108   if (fd < 0)
1109     {
1110       dbus_set_error (error,
1111                       _dbus_error_from_errno (errno),
1112                       "Failed to open \"%s\": %s",
1113                       _dbus_string_get_const_data (&path),
1114                       _dbus_strerror (errno));
1115       goto fail;
1116     }
1117
1118   if (!_dbus_read (fd, &cmdline, max_len))
1119     {
1120       dbus_set_error (error,
1121                       _dbus_error_from_errno (errno),
1122                       "Failed to read from \"%s\": %s",
1123                       _dbus_string_get_const_data (&path),
1124                       _dbus_strerror (errno));
1125       goto fail;
1126     }
1127
1128   if (!_dbus_close (fd, error))
1129     goto fail;
1130
1131   string_squash_nonprintable (&cmdline);
1132
1133   if (!_dbus_string_copy (&cmdline, 0, str, _dbus_string_get_length (str)))
1134     goto oom;
1135
1136   _dbus_string_free (&cmdline);
1137   _dbus_string_free (&path);
1138   return TRUE;
1139 oom:
1140   _DBUS_SET_OOM (error);
1141 fail:
1142   _dbus_string_free (&cmdline);
1143   _dbus_string_free (&path);
1144   return FALSE;
1145 }