dbus/dbus-sysdeps-util-win.c

   1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
   2 /* dbus-sysdeps-util.c Would be in dbus-sysdeps.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
  25 #include <config.h>
  26
  27 #define STRSAFE_NO_DEPRECATE
  28
  29 #include "dbus-sysdeps.h"
  30 #include "dbus-internals.h"
  31 #include "dbus-protocol.h"
  32 #include "dbus-string.h"
  33 #include "dbus-sysdeps.h"
  34 #include "dbus-sysdeps-win.h"
  35 #include "dbus-sockets-win.h"
  36 #include "dbus-memory.h"
  37 #include "dbus-pipe.h"
  38
  39 #include <stdio.h>
  40 #include <stdlib.h>
  41 #if HAVE_ERRNO_H
  42 #include <errno.h>
  43 #endif
  44 #include <winsock2.h>   // WSA error codes
  45
  46 #ifndef DBUS_WINCE
  47 #include <io.h>
  48 #include <lm.h>
  49 #include <sys/stat.h>
  50 #endif
  51
  52
  53 /**
  54  * Does the chdir, fork, setsid, etc. to become a daemon process.
  55  *
  56  * @param pidfile #NULL, or pidfile to create
  57  * @param print_pid_pipe file descriptor to print daemon's pid to, or -1 for none
  58  * @param error return location for errors
  59  * @param keep_umask #TRUE to keep the original umask
  60  * @returns #FALSE on failure
  61  */
  62 dbus_bool_t
  63 _dbus_become_daemon (const DBusString *pidfile,
  64                      DBusPipe         *print_pid_pipe,
  65                      DBusError        *error,
  66                      dbus_bool_t       keep_umask)
  67 {
  68   dbus_set_error (error, DBUS_ERROR_NOT_SUPPORTED,
  69                   "Cannot daemonize on Windows");
  70   return FALSE;
  71 }
  72
  73 /**
  74  * Creates a file containing the process ID.
  75  *
  76  * @param filename the filename to write to
  77  * @param pid our process ID
  78  * @param error return location for errors
  79  * @returns #FALSE on failure
  80  */
  81 static dbus_bool_t
  82 _dbus_write_pid_file (const DBusString *filename,
  83                       unsigned long     pid,
  84                       DBusError        *error)
  85 {
  86   const char *cfilename;
  87   HANDLE hnd;
  88   char pidstr[20];
  89   int total;
  90   int bytes_to_write;
  91
  92   _DBUS_ASSERT_ERROR_IS_CLEAR (error);
  93
  94   cfilename = _dbus_string_get_const_data (filename);
  95
  96   hnd = CreateFileA (cfilename, GENERIC_WRITE,
  97                      FILE_SHARE_READ | FILE_SHARE_WRITE,
  98                      NULL, CREATE_NEW, FILE_ATTRIBUTE_NORMAL,
  99                      INVALID_HANDLE_VALUE);
 100   if (hnd == INVALID_HANDLE_VALUE)
 101     {
 102       char *emsg = _dbus_win_error_string (GetLastError ());
 103       dbus_set_error (error, _dbus_win_error_from_last_error (),
 104                       "Could not create PID file %s: %s",
 105                       cfilename, emsg);
 106       _dbus_win_free_error_string (emsg);
 107       return FALSE;
 108     }
 109
 110   if (snprintf (pidstr, sizeof (pidstr), "%lu\n", pid) < 0)
 111     {
 112       dbus_set_error (error, _dbus_error_from_system_errno (),
 113                       "Failed to format PID for \"%s\": %s", cfilename,
 114                       _dbus_strerror_from_errno ());
 115       CloseHandle (hnd);
 116       return FALSE;
 117     }
 118
 119   total = 0;
 120   bytes_to_write = strlen (pidstr);;
 121
 122   while (total < bytes_to_write)
 123     {
 124       DWORD bytes_written;
 125       BOOL res;
 126
 127       res = WriteFile (hnd, pidstr + total, bytes_to_write - total,
 128                        &bytes_written, NULL);
 129
 130       if (res == 0 || bytes_written <= 0)
 131         {
 132           char *emsg = _dbus_win_error_string (GetLastError ());
 133           dbus_set_error (error, _dbus_win_error_from_last_error (),
 134                            "Could not write to %s: %s", cfilename, emsg);
 135           _dbus_win_free_error_string (emsg);
 136           CloseHandle (hnd);
 137           return FALSE;
 138         }
 139
 140       total += bytes_written;
 141     }
 142
 143   if (CloseHandle (hnd) == 0)
 144     {
 145       char *emsg = _dbus_win_error_string (GetLastError ());
 146       dbus_set_error (error, _dbus_win_error_from_last_error (),
 147                        "Could not close file %s: %s",
 148                       cfilename, emsg);
 149       _dbus_win_free_error_string (emsg);
 150
 151       return FALSE;
 152     }
 153
 154   return TRUE;
 155 }
 156
 157 /**
 158  * Writes the given pid_to_write to a pidfile (if non-NULL) and/or to a
 159  * pipe (if non-NULL). Does nothing if pidfile and print_pid_pipe are both
 160  * NULL.
 161  *
 162  * @param pidfile the file to write to or #NULL
 163  * @param print_pid_pipe the pipe to write to or #NULL
 164  * @param pid_to_write the pid to write out
 165  * @param error error on failure
 166  * @returns FALSE if error is set
 167  */
 168 dbus_bool_t
 169 _dbus_write_pid_to_file_and_pipe (const DBusString *pidfile,
 170                                   DBusPipe         *print_pid_pipe,
 171                                   dbus_pid_t        pid_to_write,
 172                                   DBusError        *error)
 173 {
 174   if (pidfile)
 175     {
 176       _dbus_verbose ("writing pid file %s\n", _dbus_string_get_const_data (pidfile));
 177       if (!_dbus_write_pid_file (pidfile,
 178                                  pid_to_write,
 179                                  error))
 180         {
 181           _dbus_verbose ("pid file write failed\n");
 182           _DBUS_ASSERT_ERROR_IS_SET(error);
 183           return FALSE;
 184         }
 185     }
 186   else
 187     {
 188       _dbus_verbose ("No pid file requested\n");
 189     }
 190
 191   if (print_pid_pipe != NULL && _dbus_pipe_is_valid (print_pid_pipe))
 192     {
 193       DBusString pid;
 194       int bytes;
 195
 196       _dbus_verbose ("writing our pid to pipe %d\n", print_pid_pipe->fd);
 197
 198       if (!_dbus_string_init (&pid))
 199         {
 200           _DBUS_SET_OOM (error);
 201           return FALSE;
 202         }
 203
 204       if (!_dbus_string_append_int (&pid, pid_to_write) ||
 205           !_dbus_string_append (&pid, "\n"))
 206         {
 207           _dbus_string_free (&pid);
 208           _DBUS_SET_OOM (error);
 209           return FALSE;
 210         }
 211
 212       bytes = _dbus_string_get_length (&pid);
 213       if (_dbus_pipe_write (print_pid_pipe, &pid, 0, bytes, error) != bytes)
 214         {
 215           /* _dbus_pipe_write sets error only on failure, not short write */
 216           if (error != NULL && !dbus_error_is_set(error))
 217             {
 218               dbus_set_error (error, DBUS_ERROR_FAILED,
 219                               "Printing message bus PID: did not write enough bytes\n");
 220             }
 221           _dbus_string_free (&pid);
 222           return FALSE;
 223         }
 224
 225       _dbus_string_free (&pid);
 226     }
 227   else
 228     {
 229       _dbus_verbose ("No pid pipe to write to\n");
 230     }
 231
 232   return TRUE;
 233 }
 234
 235 /**
 236  * Verify that after the fork we can successfully change to this user.
 237  *
 238  * @param user the username given in the daemon configuration
 239  * @returns #TRUE if username is valid
 240  */
 241 dbus_bool_t
 242 _dbus_verify_daemon_user (const char *user)
 243 {
 244   return TRUE;
 245 }
 246
 247 /**
 248  * Changes the user and group the bus is running as.
 249  *
 250  * @param user the user to become
 251  * @param error return location for errors
 252  * @returns #FALSE on failure
 253  */
 254 dbus_bool_t
 255 _dbus_change_to_daemon_user  (const char    *user,
 256                               DBusError     *error)
 257 {
 258   return TRUE;
 259 }
 260
 261 void
 262 _dbus_request_file_descriptor_limit (unsigned int limit)
 263 {
 264 }
 265
 266 void
 267 _dbus_init_system_log (dbus_bool_t is_daemon)
 268 {
 269   /* OutputDebugStringA doesn't need any special initialization, do nothing */
 270 }
 271
 272 /**
 273  * Log a message to the system log file (e.g. syslog on Unix).
 274  *
 275  * @param severity a severity value
 276  * @param msg a printf-style format string
 277  */
 278 void
 279 _dbus_system_log (DBusSystemLogSeverity severity, const char *msg, ...)
 280 {
 281   va_list args;
 282
 283   va_start (args, msg);
 284
 285   _dbus_system_logv (severity, msg, args);
 286
 287   va_end (args);
 288 }
 289
 290 /**
 291  * Log a message to the system log file (e.g. syslog on Unix).
 292  *
 293  * @param severity a severity value
 294  * @param msg a printf-style format string
 295  * @param args arguments for the format string
 296  *
 297  * If the FATAL severity is given, this function will terminate the program
 298  * with an error code.
 299  */
 300 void
 301 _dbus_system_logv (DBusSystemLogSeverity severity, const char *msg, va_list args)
 302 {
 303   char *s = "";
 304   char buf[1024];
 305
 306   switch(severity)
 307    {
 308      case DBUS_SYSTEM_LOG_INFO: s = "info"; break;
 309      case DBUS_SYSTEM_LOG_SECURITY: s = "security"; break;
 310      case DBUS_SYSTEM_LOG_FATAL: s = "fatal"; break;
 311    }
 312
 313   sprintf(buf,"%s%s",s,msg);
 314   vsprintf(buf,buf,args);
 315   OutputDebugStringA(buf);
 316
 317   if (severity == DBUS_SYSTEM_LOG_FATAL)
 318     exit (1);
 319 }
 320
 321 /** Installs a signal handler
 322  *
 323  * @param sig the signal to handle
 324  * @param handler the handler
 325  */
 326 void
 327 _dbus_set_signal_handler (int               sig,
 328                           DBusSignalHandler handler)
 329 {
 330   _dbus_verbose ("_dbus_set_signal_handler() has to be implemented\n");
 331 }
 332
 333 /**
 334  * stat() wrapper.
 335  *
 336  * @param filename the filename to stat
 337  * @param statbuf the stat info to fill in
 338  * @param error return location for error
 339  * @returns #FALSE if error was set
 340  */
 341 dbus_bool_t
 342 _dbus_stat(const DBusString *filename,
 343            DBusStat         *statbuf,
 344            DBusError        *error)
 345 {
 346   const char *filename_c;
 347   WIN32_FILE_ATTRIBUTE_DATA wfad;
 348   char *lastdot;
 349   DWORD rc;
 350
 351   _DBUS_ASSERT_ERROR_IS_CLEAR (error);
 352
 353   filename_c = _dbus_string_get_const_data (filename);
 354
 355   if (!GetFileAttributesExA (filename_c, GetFileExInfoStandard, &wfad))
 356     {
 357       _dbus_win_set_error_from_win_error (error, GetLastError ());
 358       return FALSE;
 359     }
 360
 361   if (wfad.dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY)
 362     statbuf->mode = _S_IFDIR;
 363   else
 364     statbuf->mode = _S_IFREG;
 365
 366   statbuf->mode |= _S_IREAD;
 367   if (wfad.dwFileAttributes & FILE_ATTRIBUTE_READONLY)
 368     statbuf->mode |= _S_IWRITE;
 369
 370   lastdot = strrchr (filename_c, '.');
 371   if (lastdot && stricmp (lastdot, ".exe") == 0)
 372     statbuf->mode |= _S_IEXEC;
 373
 374   statbuf->mode |= (statbuf->mode & 0700) >> 3;
 375   statbuf->mode |= (statbuf->mode & 0700) >> 6;
 376
 377   statbuf->nlink = 1;
 378
 379 #ifdef ENABLE_UID_TO_SID
 380   {
 381     PSID owner_sid, group_sid;
 382     PSECURITY_DESCRIPTOR sd;
 383
 384     sd = NULL;
 385     rc = GetNamedSecurityInfo ((char *) filename_c, SE_FILE_OBJECT,
 386                                OWNER_SECURITY_INFORMATION |
 387                                GROUP_SECURITY_INFORMATION,
 388                                &owner_sid, &group_sid,
 389                                NULL, NULL,
 390                                &sd);
 391     if (rc != ERROR_SUCCESS)
 392       {
 393         _dbus_win_set_error_from_win_error (error, rc);
 394         if (sd != NULL)
 395           LocalFree (sd);
 396         return FALSE;
 397       }
 398
 399     /* FIXME */
 400     statbuf->uid = _dbus_win_sid_to_uid_t (owner_sid);
 401     statbuf->gid = _dbus_win_sid_to_uid_t (group_sid);
 402
 403     LocalFree (sd);
 404   }
 405 #else
 406   statbuf->uid = DBUS_UID_UNSET;
 407   statbuf->gid = DBUS_GID_UNSET;
 408 #endif
 409
 410   statbuf->size = ((dbus_int64_t) wfad.nFileSizeHigh << 32) + wfad.nFileSizeLow;
 411
 412   statbuf->atime =
 413     (((dbus_int64_t) wfad.ftLastAccessTime.dwHighDateTime << 32) +
 414      wfad.ftLastAccessTime.dwLowDateTime) / 10000000 - DBUS_INT64_CONSTANT (116444736000000000);
 415
 416   statbuf->mtime =
 417     (((dbus_int64_t) wfad.ftLastWriteTime.dwHighDateTime << 32) +
 418      wfad.ftLastWriteTime.dwLowDateTime) / 10000000 - DBUS_INT64_CONSTANT (116444736000000000);
 419
 420   statbuf->ctime =
 421     (((dbus_int64_t) wfad.ftCreationTime.dwHighDateTime << 32) +
 422      wfad.ftCreationTime.dwLowDateTime) / 10000000 - DBUS_INT64_CONSTANT (116444736000000000);
 423
 424   return TRUE;
 425 }
 426
 427
 428 /* This file is part of the KDE project
 429 Copyright (C) 2000 Werner Almesberger
 430
 431 libc/sys/linux/sys/dirent.h - Directory entry as returned by readdir
 432
 433 This program is free software; you can redistribute it and/or
 434 modify it under the terms of the GNU Library General Public
 435 License as published by the Free Software Foundation; either
 436 version 2 of the License, or (at your option) any later version.
 437
 438 This program is distributed in the hope that it will be useful,
 439 but WITHOUT ANY WARRANTY; without even the implied warranty of
 440 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 441 Library General Public License for more details.
 442
 443 You should have received a copy of the GNU Library General Public License
 444 along with this program; see the file COPYING.  If not, write to
 445 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
 446 Boston, MA 02110-1301, USA.
 447 */
 448 #define HAVE_NO_D_NAMLEN        /* no struct dirent->d_namlen */
 449 #define HAVE_DD_LOCK            /* have locking mechanism */
 450
 451 #define MAXNAMLEN 255           /* sizeof(struct dirent.d_name)-1 */
 452
 453 #define __dirfd(dir) (dir)->dd_fd
 454
 455 /* struct dirent - same as Unix */
 456 struct dirent
 457   {
 458     long d_ino;                    /* inode (always 1 in WIN32) */
 459     off_t d_off;                /* offset to this dirent */
 460     unsigned short d_reclen;    /* length of d_name */
 461     char d_name[_MAX_FNAME+1];    /* filename (null terminated) */
 462   };
 463
 464 /* typedef DIR - not the same as Unix */
 465 typedef struct
 466   {
 467     HANDLE handle;              /* FindFirst/FindNext handle */
 468     short offset;               /* offset into directory */
 469     short finished;             /* 1 if there are not more files */
 470     WIN32_FIND_DATAA fileinfo;  /* from FindFirst/FindNext */
 471     char *dir;                  /* the dir we are reading */
 472     struct dirent dent;         /* the dirent to return */
 473   }
 474 DIR;
 475
 476 /**********************************************************************
 477 * Implement dirent-style opendir/readdir/closedir on Window 95/NT
 478 *
 479 * Functions defined are opendir(), readdir() and closedir() with the
 480 * same prototypes as the normal dirent.h implementation.
 481 *
 482 * Does not implement telldir(), seekdir(), rewinddir() or scandir().
 483 * The dirent struct is compatible with Unix, except that d_ino is
 484 * always 1 and d_off is made up as we go along.
 485 *
 486 * Error codes are not available with errno but GetLastError.
 487 *
 488 * The DIR typedef is not compatible with Unix.
 489 **********************************************************************/
 490
 491 static DIR * _dbus_opendir(const char *dir)
 492 {
 493   DIR *dp;
 494   char *filespec;
 495   HANDLE handle;
 496   int index;
 497
 498   filespec = malloc(strlen(dir) + 2 + 1);
 499   strcpy(filespec, dir);
 500   index = strlen(filespec) - 1;
 501   if (index >= 0 && (filespec[index] == '/' || filespec[index] == '\\'))
 502     filespec[index] = '\0';
 503   strcat(filespec, "\\*");
 504
 505   dp = (DIR *)malloc(sizeof(DIR));
 506   dp->offset = 0;
 507   dp->finished = 0;
 508   dp->dir = strdup(dir);
 509
 510   handle = FindFirstFileA(filespec, &(dp->fileinfo));
 511   if (handle == INVALID_HANDLE_VALUE)
 512     {
 513       if (GetLastError() == ERROR_NO_MORE_FILES)
 514         dp->finished = 1;
 515       else
 516         return NULL;
 517     }
 518
 519   dp->handle = handle;
 520   free(filespec);
 521
 522   return dp;
 523 }
 524
 525 static struct dirent * _dbus_readdir(DIR *dp)
 526 {
 527   int saved_err = GetLastError();
 528
 529   if (!dp || dp->finished)
 530     return NULL;
 531
 532   if (dp->offset != 0)
 533     {
 534       if (FindNextFileA(dp->handle, &(dp->fileinfo)) == 0)
 535         {
 536           if (GetLastError() == ERROR_NO_MORE_FILES)
 537             {
 538               SetLastError(saved_err);
 539               dp->finished = 1;
 540             }
 541           return NULL;
 542         }
 543     }
 544   dp->offset++;
 545
 546   strncpy(dp->dent.d_name, dp->fileinfo.cFileName, _MAX_FNAME);
 547   dp->dent.d_ino = 1;
 548   dp->dent.d_reclen = strlen(dp->dent.d_name);
 549   dp->dent.d_off = dp->offset;
 550
 551   return &(dp->dent);
 552 }
 553
 554
 555 static int _dbus_closedir(DIR *dp)
 556 {
 557   if (!dp)
 558     return 0;
 559   FindClose(dp->handle);
 560   if (dp->dir)
 561     free(dp->dir);
 562   if (dp)
 563     free(dp);
 564
 565   return 0;
 566 }
 567
 568
 569 /**
 570  * Internals of directory iterator
 571  */
 572 struct DBusDirIter
 573   {
 574     DIR *d; /**< The DIR* from opendir() */
 575
 576   };
 577
 578 /**
 579  * Open a directory to iterate over.
 580  *
 581  * @param filename the directory name
 582  * @param error exception return object or #NULL
 583  * @returns new iterator, or #NULL on error
 584  */
 585 DBusDirIter*
 586 _dbus_directory_open (const DBusString *filename,
 587                       DBusError        *error)
 588 {
 589   DIR *d;
 590   DBusDirIter *iter;
 591   const char *filename_c;
 592
 593   _DBUS_ASSERT_ERROR_IS_CLEAR (error);
 594
 595   filename_c = _dbus_string_get_const_data (filename);
 596
 597   d = _dbus_opendir (filename_c);
 598   if (d == NULL)
 599     {
 600       char *emsg = _dbus_win_error_string (GetLastError ());
 601       dbus_set_error (error, _dbus_win_error_from_last_error (),
 602                       "Failed to read directory \"%s\": %s",
 603                       filename_c, emsg);
 604       _dbus_win_free_error_string (emsg);
 605       return NULL;
 606     }
 607   iter = dbus_new0 (DBusDirIter, 1);
 608   if (iter == NULL)
 609     {
 610       _dbus_closedir (d);
 611       dbus_set_error (error, DBUS_ERROR_NO_MEMORY,
 612                       "Could not allocate memory for directory iterator");
 613       return NULL;
 614     }
 615
 616   iter->d = d;
 617
 618   return iter;
 619 }
 620
 621 /**
 622  * Get next file in the directory. Will not return "." or ".."  on
 623  * UNIX. If an error occurs, the contents of "filename" are
 624  * undefined. The error is never set if the function succeeds.
 625  *
 626  * @todo for thread safety, I think we have to use
 627  * readdir_r(). (GLib has the same issue, should file a bug.)
 628  *
 629  * @param iter the iterator
 630  * @param filename string to be set to the next file in the dir
 631  * @param error return location for error
 632  * @returns #TRUE if filename was filled in with a new filename
 633  */
 634 dbus_bool_t
 635 _dbus_directory_get_next_file (DBusDirIter      *iter,
 636                                DBusString       *filename,
 637                                DBusError        *error)
 638 {
 639   struct dirent *ent;
 640
 641   _DBUS_ASSERT_ERROR_IS_CLEAR (error);
 642
 643 again:
 644   SetLastError (0);
 645   ent = _dbus_readdir (iter->d);
 646   if (ent == NULL)
 647     {
 648       if (GetLastError() != 0)
 649         {
 650           char *emsg = _dbus_win_error_string (GetLastError ());
 651           dbus_set_error (error, _dbus_win_error_from_last_error (),
 652                           "Failed to get next in directory: %s", emsg);
 653           _dbus_win_free_error_string (emsg);
 654         }
 655       return FALSE;
 656     }
 657   else if (ent->d_name[0] == '.' &&
 658            (ent->d_name[1] == '\0' ||
 659             (ent->d_name[1] == '.' && ent->d_name[2] == '\0')))
 660     goto again;
 661   else
 662     {
 663       _dbus_string_set_length (filename, 0);
 664       if (!_dbus_string_append (filename, ent->d_name))
 665         {
 666           dbus_set_error (error, DBUS_ERROR_NO_MEMORY,
 667                           "No memory to read directory entry");
 668           return FALSE;
 669         }
 670       else
 671         return TRUE;
 672     }
 673 }
 674
 675 /**
 676  * Closes a directory iteration.
 677  */
 678 void
 679 _dbus_directory_close (DBusDirIter *iter)
 680 {
 681   _dbus_closedir (iter->d);
 682   dbus_free (iter);
 683 }
 684
 685 /** @} */ /* End of DBusInternalsUtils functions */
 686
 687 /**
 688  * @addtogroup DBusString
 689  *
 690  * @{
 691  */
 692 /**
 693  * Get the directory name from a complete filename
 694  * @param filename the filename
 695  * @param dirname string to append directory name to
 696  * @returns #FALSE if no memory
 697  */
 698 dbus_bool_t
 699 _dbus_string_get_dirname(const DBusString *filename,
 700                          DBusString       *dirname)
 701 {
 702   int sep;
 703
 704   _dbus_assert (filename != dirname);
 705   _dbus_assert (filename != NULL);
 706   _dbus_assert (dirname != NULL);
 707
 708   /* Ignore any separators on the end */
 709   sep = _dbus_string_get_length (filename);
 710   if (sep == 0)
 711     return _dbus_string_append (dirname, "."); /* empty string passed in */
 712
 713   while (sep > 0 &&
 714          (_dbus_string_get_byte (filename, sep - 1) == '/' ||
 715           _dbus_string_get_byte (filename, sep - 1) == '\\'))
 716     --sep;
 717
 718   _dbus_assert (sep >= 0);
 719
 720   if (sep == 0 ||
 721       (sep == 2 &&
 722        _dbus_string_get_byte (filename, 1) == ':' &&
 723        isalpha (_dbus_string_get_byte (filename, 0))))
 724     return _dbus_string_copy_len (filename, 0, sep + 1,
 725                                   dirname, _dbus_string_get_length (dirname));
 726
 727   {
 728     int sep1, sep2;
 729     _dbus_string_find_byte_backward (filename, sep, '/', &sep1);
 730     _dbus_string_find_byte_backward (filename, sep, '\\', &sep2);
 731
 732     sep = MAX (sep1, sep2);
 733   }
 734   if (sep < 0)
 735     return _dbus_string_append (dirname, ".");
 736
 737   while (sep > 0 &&
 738          (_dbus_string_get_byte (filename, sep - 1) == '/' ||
 739           _dbus_string_get_byte (filename, sep - 1) == '\\'))
 740     --sep;
 741
 742   _dbus_assert (sep >= 0);
 743
 744   if ((sep == 0 ||
 745        (sep == 2 &&
 746         _dbus_string_get_byte (filename, 1) == ':' &&
 747         isalpha (_dbus_string_get_byte (filename, 0))))
 748       &&
 749       (_dbus_string_get_byte (filename, sep) == '/' ||
 750        _dbus_string_get_byte (filename, sep) == '\\'))
 751     return _dbus_string_copy_len (filename, 0, sep + 1,
 752                                   dirname, _dbus_string_get_length (dirname));
 753   else
 754     return _dbus_string_copy_len (filename, 0, sep - 0,
 755                                   dirname, _dbus_string_get_length (dirname));
 756 }
 757
 758
 759 /**
 760  * Checks to see if the UNIX user ID matches the UID of
 761  * the process. Should always return #FALSE on Windows.
 762  *
 763  * @param uid the UNIX user ID
 764  * @returns #TRUE if this uid owns the process.
 765  */
 766 dbus_bool_t
 767 _dbus_unix_user_is_process_owner (dbus_uid_t uid)
 768 {
 769   return FALSE;
 770 }
 771
 772 dbus_bool_t _dbus_windows_user_is_process_owner (const char *windows_sid)
 773 {
 774   return TRUE;
 775 }
 776
 777 /*=====================================================================
 778   unix emulation functions - should be removed sometime in the future
 779  =====================================================================*/
 780
 781 /**
 782  * Checks to see if the UNIX user ID is at the console.
 783  * Should always fail on Windows (set the error to
 784  * #DBUS_ERROR_NOT_SUPPORTED).
 785  *
 786  * @param uid UID of person to check
 787  * @param error return location for errors
 788  * @returns #TRUE if the UID is the same as the console user and there are no errors
 789  */
 790 dbus_bool_t
 791 _dbus_unix_user_is_at_console (dbus_uid_t         uid,
 792                                DBusError         *error)
 793 {
 794   dbus_set_error (error, DBUS_ERROR_NOT_SUPPORTED,
 795                   "UNIX user IDs not supported on Windows\n");
 796   return FALSE;
 797 }
 798
 799
 800 /**
 801  * Parse a UNIX group from the bus config file. On Windows, this should
 802  * simply always fail (just return #FALSE).
 803  *
 804  * @param groupname the groupname text
 805  * @param gid_p place to return the gid
 806  * @returns #TRUE on success
 807  */
 808 dbus_bool_t
 809 _dbus_parse_unix_group_from_config (const DBusString  *groupname,
 810                                     dbus_gid_t        *gid_p)
 811 {
 812   return FALSE;
 813 }
 814
 815 /**
 816  * Parse a UNIX user from the bus config file. On Windows, this should
 817  * simply always fail (just return #FALSE).
 818  *
 819  * @param username the username text
 820  * @param uid_p place to return the uid
 821  * @returns #TRUE on success
 822  */
 823 dbus_bool_t
 824 _dbus_parse_unix_user_from_config (const DBusString  *username,
 825                                    dbus_uid_t        *uid_p)
 826 {
 827   return FALSE;
 828 }
 829
 830
 831 /**
 832  * Gets all groups corresponding to the given UNIX user ID. On UNIX,
 833  * just calls _dbus_groups_from_uid(). On Windows, should always
 834  * fail since we don't know any UNIX groups.
 835  *
 836  * @param uid the UID
 837  * @param group_ids return location for array of group IDs
 838  * @param n_group_ids return location for length of returned array
 839  * @returns #TRUE if the UID existed and we got some credentials
 840  */
 841 dbus_bool_t
 842 _dbus_unix_groups_from_uid (dbus_uid_t            uid,
 843                             dbus_gid_t          **group_ids,
 844                             int                  *n_group_ids)
 845 {
 846   return FALSE;
 847 }
 848
 849
 850
 851 /** @} */ /* DBusString stuff */
 852
 853 /************************************************************************
 854
 855  error handling
 856
 857  ************************************************************************/
 858
 859
 860
 861
 862
 863 /* lan manager error codes */
 864 const char*
 865 _dbus_lm_strerror(int error_number)
 866 {
 867 #ifdef DBUS_WINCE
 868   // TODO
 869   return "unknown";
 870 #else
 871   const char *msg;
 872   switch (error_number)
 873     {
 874     case NERR_NetNotStarted:
 875       return "The workstation driver is not installed.";
 876     case NERR_UnknownServer:
 877       return "The server could not be located.";
 878     case NERR_ShareMem:
 879       return "An internal error occurred. The network cannot access a shared memory segment.";
 880     case NERR_NoNetworkResource:
 881       return "A network resource shortage occurred.";
 882     case NERR_RemoteOnly:
 883       return "This operation is not supported on workstations.";
 884     case NERR_DevNotRedirected:
 885       return "The device is not connected.";
 886     case NERR_ServerNotStarted:
 887       return "The Server service is not started.";
 888     case NERR_ItemNotFound:
 889       return "The queue is empty.";
 890     case NERR_UnknownDevDir:
 891       return "The device or directory does not exist.";
 892     case NERR_RedirectedPath:
 893       return "The operation is invalid on a redirected resource.";
 894     case NERR_DuplicateShare:
 895       return "The name has already been shared.";
 896     case NERR_NoRoom:
 897       return "The server is currently out of the requested resource.";
 898     case NERR_TooManyItems:
 899       return "Requested addition of items exceeds the maximum allowed.";
 900     case NERR_InvalidMaxUsers:
 901       return "The Peer service supports only two simultaneous users.";
 902     case NERR_BufTooSmall:
 903       return "The API return buffer is too small.";
 904     case NERR_RemoteErr:
 905       return "A remote API error occurred.";
 906     case NERR_LanmanIniError:
 907       return "An error occurred when opening or reading the configuration file.";
 908     case NERR_NetworkError:
 909       return "A general network error occurred.";
 910     case NERR_WkstaInconsistentState:
 911       return "The Workstation service is in an inconsistent state. Restart the computer before restarting the Workstation service.";
 912     case NERR_WkstaNotStarted:
 913       return "The Workstation service has not been started.";
 914     case NERR_BrowserNotStarted:
 915       return "The requested information is not available.";
 916     case NERR_InternalError:
 917       return "An internal error occurred.";
 918     case NERR_BadTransactConfig:
 919       return "The server is not configured for transactions.";
 920     case NERR_InvalidAPI:
 921       return "The requested API is not supported on the remote server.";
 922     case NERR_BadEventName:
 923       return "The event name is invalid.";
 924     case NERR_DupNameReboot:
 925       return "The computer name already exists on the network. Change it and restart the computer.";
 926     case NERR_CfgCompNotFound:
 927       return "The specified component could not be found in the configuration information.";
 928     case NERR_CfgParamNotFound:
 929       return "The specified parameter could not be found in the configuration information.";
 930     case NERR_LineTooLong:
 931       return "A line in the configuration file is too long.";
 932     case NERR_QNotFound:
 933       return "The printer does not exist.";
 934     case NERR_JobNotFound:
 935       return "The print job does not exist.";
 936     case NERR_DestNotFound:
 937       return "The printer destination cannot be found.";
 938     case NERR_DestExists:
 939       return "The printer destination already exists.";
 940     case NERR_QExists:
 941       return "The printer queue already exists.";
 942     case NERR_QNoRoom:
 943       return "No more printers can be added.";
 944     case NERR_JobNoRoom:
 945       return "No more print jobs can be added.";
 946     case NERR_DestNoRoom:
 947       return "No more printer destinations can be added.";
 948     case NERR_DestIdle:
 949       return "This printer destination is idle and cannot accept control operations.";
 950     case NERR_DestInvalidOp:
 951       return "This printer destination request contains an invalid control function.";
 952     case NERR_ProcNoRespond:
 953       return "The print processor is not responding.";
 954     case NERR_SpoolerNotLoaded:
 955       return "The spooler is not running.";
 956     case NERR_DestInvalidState:
 957       return "This operation cannot be performed on the print destination in its current state.";
 958     case NERR_QInvalidState:
 959       return "This operation cannot be performed on the printer queue in its current state.";
 960     case NERR_JobInvalidState:
 961       return "This operation cannot be performed on the print job in its current state.";
 962     case NERR_SpoolNoMemory:
 963       return "A spooler memory allocation failure occurred.";
 964     case NERR_DriverNotFound:
 965       return "The device driver does not exist.";
 966     case NERR_DataTypeInvalid:
 967       return "The data type is not supported by the print processor.";
 968     case NERR_ProcNotFound:
 969       return "The print processor is not installed.";
 970     case NERR_ServiceTableLocked:
 971       return "The service database is locked.";
 972     case NERR_ServiceTableFull:
 973       return "The service table is full.";
 974     case NERR_ServiceInstalled:
 975       return "The requested service has already been started.";
 976     case NERR_ServiceEntryLocked:
 977       return "The service does not respond to control actions.";
 978     case NERR_ServiceNotInstalled:
 979       return "The service has not been started.";
 980     case NERR_BadServiceName:
 981       return "The service name is invalid.";
 982     case NERR_ServiceCtlTimeout:
 983       return "The service is not responding to the control function.";
 984     case NERR_ServiceCtlBusy:
 985       return "The service control is busy.";
 986     case NERR_BadServiceProgName:
 987       return "The configuration file contains an invalid service program name.";
 988     case NERR_ServiceNotCtrl:
 989       return "The service could not be controlled in its present state.";
 990     case NERR_ServiceKillProc:
 991       return "The service ended abnormally.";
 992     case NERR_ServiceCtlNotValid:
 993       return "The requested pause or stop is not valid for this service.";
 994     case NERR_NotInDispatchTbl:
 995       return "The service control dispatcher could not find the service name in the dispatch table.";
 996     case NERR_BadControlRecv:
 997       return "The service control dispatcher pipe read failed.";
 998     case NERR_ServiceNotStarting:
 999       return "A thread for the new service could not be created.";
1000     case NERR_AlreadyLoggedOn:
1001       return "This workstation is already logged on to the local-area network.";
1002     case NERR_NotLoggedOn:
1003       return "The workstation is not logged on to the local-area network.";
1004     case NERR_BadUsername:
1005       return "The user name or group name parameter is invalid.";
1006     case NERR_BadPassword:
1007       return "The password parameter is invalid.";
1008     case NERR_UnableToAddName_W:
1009       return "@W The logon processor did not add the message alias.";
1010     case NERR_UnableToAddName_F:
1011       return "The logon processor did not add the message alias.";
1012     case NERR_UnableToDelName_W:
1013       return "@W The logoff processor did not delete the message alias.";
1014     case NERR_UnableToDelName_F:
1015       return "The logoff processor did not delete the message alias.";
1016     case NERR_LogonsPaused:
1017       return "Network logons are paused.";
1018     case NERR_LogonServerConflict:
1019       return "A centralized logon-server conflict occurred.";
1020     case NERR_LogonNoUserPath:
1021       return "The server is configured without a valid user path.";
1022     case NERR_LogonScriptError:
1023       return "An error occurred while loading or running the logon script.";
1024     case NERR_StandaloneLogon:
1025       return "The logon server was not specified. Your computer will be logged on as STANDALONE.";
1026     case NERR_LogonServerNotFound:
1027       return "The logon server could not be found.";
1028     case NERR_LogonDomainExists:
1029       return "There is already a logon domain for this computer.";
1030     case NERR_NonValidatedLogon:
1031       return "The logon server could not validate the logon.";
1032     case NERR_ACFNotFound:
1033       return "The security database could not be found.";
1034     case NERR_GroupNotFound:
1035       return "The group name could not be found.";
1036     case NERR_UserNotFound:
1037       return "The user name could not be found.";
1038     case NERR_ResourceNotFound:
1039       return "The resource name could not be found.";
1040     case NERR_GroupExists:
1041       return "The group already exists.";
1042     case NERR_UserExists:
1043       return "The user account already exists.";
1044     case NERR_ResourceExists:
1045       return "The resource permission list already exists.";
1046     case NERR_NotPrimary:
1047       return "This operation is only allowed on the primary domain controller of the domain.";
1048     case NERR_ACFNotLoaded:
1049       return "The security database has not been started.";
1050     case NERR_ACFNoRoom:
1051       return "There are too many names in the user accounts database.";
1052     case NERR_ACFFileIOFail:
1053       return "A disk I/O failure occurred.";
1054     case NERR_ACFTooManyLists:
1055       return "The limit of 64 entries per resource was exceeded.";
1056     case NERR_UserLogon:
1057       return "Deleting a user with a session is not allowed.";
1058     case NERR_ACFNoParent:
1059       return "The parent directory could not be located.";
1060     case NERR_CanNotGrowSegment:
1061       return "Unable to add to the security database session cache segment.";
1062     case NERR_SpeGroupOp:
1063       return "This operation is not allowed on this special group.";
1064     case NERR_NotInCache:
1065       return "This user is not cached in user accounts database session cache.";
1066     case NERR_UserInGroup:
1067       return "The user already belongs to this group.";
1068     case NERR_UserNotInGroup:
1069       return "The user does not belong to this group.";
1070     case NERR_AccountUndefined:
1071       return "This user account is undefined.";
1072     case NERR_AccountExpired:
1073       return "This user account has expired.";
1074     case NERR_InvalidWorkstation:
1075       return "The user is not allowed to log on from this workstation.";
1076     case NERR_InvalidLogonHours:
1077       return "The user is not allowed to log on at this time.";
1078     case NERR_PasswordExpired:
1079       return "The password of this user has expired.";
1080     case NERR_PasswordCantChange:
1081       return "The password of this user cannot change.";
1082     case NERR_PasswordHistConflict:
1083       return "This password cannot be used now.";
1084     case NERR_PasswordTooShort:
1085       return "The password does not meet the password policy requirements. Check the minimum password length, password complexity and password history requirements.";
1086     case NERR_PasswordTooRecent:
1087       return "The password of this user is too recent to change.";
1088     case NERR_InvalidDatabase:
1089       return "The security database is corrupted.";
1090     case NERR_DatabaseUpToDate:
1091       return "No updates are necessary to this replicant network/local security database.";
1092     case NERR_SyncRequired:
1093       return "This replicant database is outdated; synchronization is required.";
1094     case NERR_UseNotFound:
1095       return "The network connection could not be found.";
1096     case NERR_BadAsgType:
1097       return "This asg_type is invalid.";
1098     case NERR_DeviceIsShared:
1099       return "This device is currently being shared.";
1100     case NERR_NoComputerName:
1101       return "The computer name could not be added as a message alias. The name may already exist on the network.";
1102     case NERR_MsgAlreadyStarted:
1103       return "The Messenger service is already started.";
1104     case NERR_MsgInitFailed:
1105       return "The Messenger service failed to start.";
1106     case NERR_NameNotFound:
1107       return "The message alias could not be found on the network.";
1108     case NERR_AlreadyForwarded:
1109       return "This message alias has already been forwarded.";
1110     case NERR_AddForwarded:
1111       return "This message alias has been added but is still forwarded.";
1112     case NERR_AlreadyExists:
1113       return "This message alias already exists locally.";
1114     case NERR_TooManyNames:
1115       return "The maximum number of added message aliases has been exceeded.";
1116     case NERR_DelComputerName:
1117       return "The computer name could not be deleted.";
1118     case NERR_LocalForward:
1119       return "Messages cannot be forwarded back to the same workstation.";
1120     case NERR_GrpMsgProcessor:
1121       return "An error occurred in the domain message processor.";
1122     case NERR_PausedRemote:
1123       return "The message was sent, but the recipient has paused the Messenger service.";
1124     case NERR_BadReceive:
1125       return "The message was sent but not received.";
1126     case NERR_NameInUse:
1127       return "The message alias is currently in use. Try again later.";
1128     case NERR_MsgNotStarted:
1129       return "The Messenger service has not been started.";
1130     case NERR_NotLocalName:
1131       return "The name is not on the local computer.";
1132     case NERR_NoForwardName:
1133       return "The forwarded message alias could not be found on the network.";
1134     case NERR_RemoteFull:
1135       return "The message alias table on the remote station is full.";
1136     case NERR_NameNotForwarded:
1137       return "Messages for this alias are not currently being forwarded.";
1138     case NERR_TruncatedBroadcast:
1139       return "The broadcast message was truncated.";
1140     case NERR_InvalidDevice:
1141       return "This is an invalid device name.";
1142     case NERR_WriteFault:
1143       return "A write fault occurred.";
1144     case NERR_DuplicateName:
1145       return "A duplicate message alias exists on the network.";
1146     case NERR_DeleteLater:
1147       return "@W This message alias will be deleted later.";
1148     case NERR_IncompleteDel:
1149       return "The message alias was not successfully deleted from all networks.";
1150     case NERR_MultipleNets:
1151       return "This operation is not supported on computers with multiple networks.";
1152     case NERR_NetNameNotFound:
1153       return "This shared resource does not exist.";
1154     case NERR_DeviceNotShared:
1155       return "This device is not shared.";
1156     case NERR_ClientNameNotFound:
1157       return "A session does not exist with that computer name.";
1158     case NERR_FileIdNotFound:
1159       return "There is not an open file with that identification number.";
1160     case NERR_ExecFailure:
1161       return "A failure occurred when executing a remote administration command.";
1162     case NERR_TmpFile:
1163       return "A failure occurred when opening a remote temporary file.";
1164     case NERR_TooMuchData:
1165       return "The data returned from a remote administration command has been truncated to 64K.";
1166     case NERR_DeviceShareConflict:
1167       return "This device cannot be shared as both a spooled and a non-spooled resource.";
1168     case NERR_BrowserTableIncomplete:
1169       return "The information in the list of servers may be incorrect.";
1170     case NERR_NotLocalDomain:
1171       return "The computer is not active in this domain.";
1172 #ifdef NERR_IsDfsShare
1173
1174     case NERR_IsDfsShare:
1175       return "The share must be removed from the Distributed File System before it can be deleted.";
1176 #endif
1177
1178     case NERR_DevInvalidOpCode:
1179       return "The operation is invalid for this device.";
1180     case NERR_DevNotFound:
1181       return "This device cannot be shared.";
1182     case NERR_DevNotOpen:
1183       return "This device was not open.";
1184     case NERR_BadQueueDevString:
1185       return "This device name list is invalid.";
1186     case NERR_BadQueuePriority:
1187       return "The queue priority is invalid.";
1188     case NERR_NoCommDevs:
1189       return "There are no shared communication devices.";
1190     case NERR_QueueNotFound:
1191       return "The queue you specified does not exist.";
1192     case NERR_BadDevString:
1193       return "This list of devices is invalid.";
1194     case NERR_BadDev:
1195       return "The requested device is invalid.";
1196     case NERR_InUseBySpooler:
1197       return "This device is already in use by the spooler.";
1198     case NERR_CommDevInUse:
1199       return "This device is already in use as a communication device.";
1200     case NERR_InvalidComputer:
1201       return "This computer name is invalid.";
1202     case NERR_MaxLenExceeded:
1203       return "The string and prefix specified are too long.";
1204     case NERR_BadComponent:
1205       return "This path component is invalid.";
1206     case NERR_CantType:
1207       return "Could not determine the type of input.";
1208     case NERR_TooManyEntries:
1209       return "The buffer for types is not big enough.";
1210     case NERR_ProfileFileTooBig:
1211       return "Profile files cannot exceed 64K.";
1212     case NERR_ProfileOffset:
1213       return "The start offset is out of range.";
1214     case NERR_ProfileCleanup:
1215       return "The system cannot delete current connections to network resources.";
1216     case NERR_ProfileUnknownCmd:
1217       return "The system was unable to parse the command line in this file.";
1218     case NERR_ProfileLoadErr:
1219       return "An error occurred while loading the profile file.";
1220     case NERR_ProfileSaveErr:
1221       return "@W Errors occurred while saving the profile file. The profile was partially saved.";
1222     case NERR_LogOverflow:
1223       return "Log file %1 is full.";
1224     case NERR_LogFileChanged:
1225       return "This log file has changed between reads.";
1226     case NERR_LogFileCorrupt:
1227       return "Log file %1 is corrupt.";
1228     case NERR_SourceIsDir:
1229       return "The source path cannot be a directory.";
1230     case NERR_BadSource:
1231       return "The source path is illegal.";
1232     case NERR_BadDest:
1233       return "The destination path is illegal.";
1234     case NERR_DifferentServers:
1235       return "The source and destination paths are on different servers.";
1236     case NERR_RunSrvPaused:
1237       return "The Run server you requested is paused.";
1238     case NERR_ErrCommRunSrv:
1239       return "An error occurred when communicating with a Run server.";
1240     case NERR_ErrorExecingGhost:
1241       return "An error occurred when starting a background process.";
1242     case NERR_ShareNotFound:
1243       return "The shared resource you are connected to could not be found.";
1244     case NERR_InvalidLana:
1245       return "The LAN adapter number is invalid.";
1246     case NERR_OpenFiles:
1247       return "There are open files on the connection.";
1248     case NERR_ActiveConns:
1249       return "Active connections still exist.";
1250     case NERR_BadPasswordCore:
1251       return "This share name or password is invalid.";
1252     case NERR_DevInUse:
1253       return "The device is being accessed by an active process.";
1254     case NERR_LocalDrive:
1255       return "The drive letter is in use locally.";
1256     case NERR_AlertExists:
1257       return "The specified client is already registered for the specified event.";
1258     case NERR_TooManyAlerts:
1259       return "The alert table is full.";
1260     case NERR_NoSuchAlert:
1261       return "An invalid or nonexistent alert name was raised.";
1262     case NERR_BadRecipient:
1263       return "The alert recipient is invalid.";
1264     case NERR_AcctLimitExceeded:
1265       return "A user's session with this server has been deleted.";
1266     case NERR_InvalidLogSeek:
1267       return "The log file does not contain the requested record number.";
1268     case NERR_BadUasConfig:
1269       return "The user accounts database is not configured correctly.";
1270     case NERR_InvalidUASOp:
1271       return "This operation is not permitted when the Netlogon service is running.";
1272     case NERR_LastAdmin:
1273       return "This operation is not allowed on the last administrative account.";
1274     case NERR_DCNotFound:
1275       return "Could not find domain controller for this domain.";
1276     case NERR_LogonTrackingError:
1277       return "Could not set logon information for this user.";
1278     case NERR_NetlogonNotStarted:
1279       return "The Netlogon service has not been started.";
1280     case NERR_CanNotGrowUASFile:
1281       return "Unable to add to the user accounts database.";
1282     case NERR_TimeDiffAtDC:
1283       return "This server's clock is not synchronized with the primary domain controller's clock.";
1284     case NERR_PasswordMismatch:
1285       return "A password mismatch has been detected.";
1286     case NERR_NoSuchServer:
1287       return "The server identification does not specify a valid server.";
1288     case NERR_NoSuchSession:
1289       return "The session identification does not specify a valid session.";
1290     case NERR_NoSuchConnection:
1291       return "The connection identification does not specify a valid connection.";
1292     case NERR_TooManyServers:
1293       return "There is no space for another entry in the table of available servers.";
1294     case NERR_TooManySessions:
1295       return "The server has reached the maximum number of sessions it supports.";
1296     case NERR_TooManyConnections:
1297       return "The server has reached the maximum number of connections it supports.";
1298     case NERR_TooManyFiles:
1299       return "The server cannot open more files because it has reached its maximum number.";
1300     case NERR_NoAlternateServers:
1301       return "There are no alternate servers registered on this server.";
1302     case NERR_TryDownLevel:
1303       return "Try down-level (remote admin protocol) version of API instead.";
1304     case NERR_UPSDriverNotStarted:
1305       return "The UPS driver could not be accessed by the UPS service.";
1306     case NERR_UPSInvalidConfig:
1307       return "The UPS service is not configured correctly.";
1308     case NERR_UPSInvalidCommPort:
1309       return "The UPS service could not access the specified Comm Port.";
1310     case NERR_UPSSignalAsserted:
1311       return "The UPS indicated a line fail or low battery situation. Service not started.";
1312     case NERR_UPSShutdownFailed:
1313       return "The UPS service failed to perform a system shut down.";
1314     case NERR_BadDosRetCode:
1315       return "The program below returned an MS-DOS error code:";
1316     case NERR_ProgNeedsExtraMem:
1317       return "The program below needs more memory:";
1318     case NERR_BadDosFunction:
1319       return "The program below called an unsupported MS-DOS function:";
1320     case NERR_RemoteBootFailed:
1321       return "The workstation failed to boot.";
1322     case NERR_BadFileCheckSum:
1323       return "The file below is corrupt.";
1324     case NERR_NoRplBootSystem:
1325       return "No loader is specified in the boot-block definition file.";
1326     case NERR_RplLoadrNetBiosErr:
1327       return "NetBIOS returned an error:      The NCB and SMB are dumped above.";
1328     case NERR_RplLoadrDiskErr:
1329       return "A disk I/O error occurred.";
1330     case NERR_ImageParamErr:
1331       return "Image parameter substitution failed.";
1332     case NERR_TooManyImageParams:
1333       return "Too many image parameters cross disk sector boundaries.";
1334     case NERR_NonDosFloppyUsed:
1335       return "The image was not generated from an MS-DOS diskette formatted with /S.";
1336     case NERR_RplBootRestart:
1337       return "Remote boot will be restarted later.";
1338     case NERR_RplSrvrCallFailed:
1339       return "The call to the Remoteboot server failed.";
1340     case NERR_CantConnectRplSrvr:
1341       return "Cannot connect to the Remoteboot server.";
1342     case NERR_CantOpenImageFile:
1343       return "Cannot open image file on the Remoteboot server.";
1344     case NERR_CallingRplSrvr:
1345       return "Connecting to the Remoteboot server...";
1346     case NERR_StartingRplBoot:
1347       return "Connecting to the Remoteboot server...";
1348     case NERR_RplBootServiceTerm:
1349       return "Remote boot service was stopped; check the error log for the cause of the problem.";
1350     case NERR_RplBootStartFailed:
1351       return "Remote boot startup failed; check the error log for the cause of the problem.";
1352     case NERR_RPL_CONNECTED:
1353       return "A second connection to a Remoteboot resource is not allowed.";
1354     case NERR_BrowserConfiguredToNotRun:
1355       return "The browser service was configured with MaintainServerList=No.";
1356     case NERR_RplNoAdaptersStarted:
1357       return "Service failed to start since none of the network adapters started with this service.";
1358     case NERR_RplBadRegistry:
1359       return "Service failed to start due to bad startup information in the registry.";
1360     case NERR_RplBadDatabase:
1361       return "Service failed to start because its database is absent or corrupt.";
1362     case NERR_RplRplfilesShare:
1363       return "Service failed to start because RPLFILES share is absent.";
1364     case NERR_RplNotRplServer:
1365       return "Service failed to start because RPLUSER group is absent.";
1366     case NERR_RplCannotEnum:
1367       return "Cannot enumerate service records.";
1368     case NERR_RplWkstaInfoCorrupted:
1369       return "Workstation record information has been corrupted.";
1370     case NERR_RplWkstaNotFound:
1371       return "Workstation record was not found.";
1372     case NERR_RplWkstaNameUnavailable:
1373       return "Workstation name is in use by some other workstation.";
1374     case NERR_RplProfileInfoCorrupted:
1375       return "Profile record information has been corrupted.";
1376     case NERR_RplProfileNotFound:
1377       return "Profile record was not found.";
1378     case NERR_RplProfileNameUnavailable:
1379       return "Profile name is in use by some other profile.";
1380     case NERR_RplProfileNotEmpty:
1381       return "There are workstations using this profile.";
1382     case NERR_RplConfigInfoCorrupted:
1383       return "Configuration record information has been corrupted.";
1384     case NERR_RplConfigNotFound:
1385       return "Configuration record was not found.";
1386     case NERR_RplAdapterInfoCorrupted:
1387       return "Adapter ID record information has been corrupted.";
1388     case NERR_RplInternal:
1389       return "An internal service error has occurred.";
1390     case NERR_RplVendorInfoCorrupted:
1391       return "Vendor ID record information has been corrupted.";
1392     case NERR_RplBootInfoCorrupted:
1393       return "Boot block record information has been corrupted.";
1394     case NERR_RplWkstaNeedsUserAcct:
1395       return "The user account for this workstation record is missing.";
1396     case NERR_RplNeedsRPLUSERAcct:
1397       return "The RPLUSER local group could not be found.";
1398     case NERR_RplBootNotFound:
1399       return "Boot block record was not found.";
1400     case NERR_RplIncompatibleProfile:
1401       return "Chosen profile is incompatible with this workstation.";
1402     case NERR_RplAdapterNameUnavailable:
1403       return "Chosen network adapter ID is in use by some other workstation.";
1404     case NERR_RplConfigNotEmpty:
1405       return "There are profiles using this configuration.";
1406     case NERR_RplBootInUse:
1407       return "There are workstations, profiles, or configurations using this boot block.";
1408     case NERR_RplBackupDatabase:
1409       return "Service failed to backup Remoteboot database.";
1410     case NERR_RplAdapterNotFound:
1411       return "Adapter record was not found.";
1412     case NERR_RplVendorNotFound:
1413       return "Vendor record was not found.";
1414     case NERR_RplVendorNameUnavailable:
1415       return "Vendor name is in use by some other vendor record.";
1416     case NERR_RplBootNameUnavailable:
1417       return "(boot name, vendor ID) is in use by some other boot block record.";
1418     case NERR_RplConfigNameUnavailable:
1419       return "Configuration name is in use by some other configuration.";
1420     case NERR_DfsInternalCorruption:
1421       return "The internal database maintained by the Dfs service is corrupt.";
1422     case NERR_DfsVolumeDataCorrupt:
1423       return "One of the records in the internal Dfs database is corrupt.";
1424     case NERR_DfsNoSuchVolume:
1425       return "There is no DFS name whose entry path matches the input Entry Path.";
1426     case NERR_DfsVolumeAlreadyExists:
1427       return "A root or link with the given name already exists.";
1428     case NERR_DfsAlreadyShared:
1429       return "The server share specified is already shared in the Dfs.";
1430     case NERR_DfsNoSuchShare:
1431       return "The indicated server share does not support the indicated DFS namespace.";
1432     case NERR_DfsNotALeafVolume:
1433       return "The operation is not valid on this portion of the namespace.";
1434     case NERR_DfsLeafVolume:
1435       return "The operation is not valid on this portion of the namespace.";
1436     case NERR_DfsVolumeHasMultipleServers:
1437       return "The operation is ambiguous because the link has multiple servers.";
1438     case NERR_DfsCantCreateJunctionPoint:
1439       return "Unable to create a link.";
1440     case NERR_DfsServerNotDfsAware:
1441       return "The server is not Dfs Aware.";
1442     case NERR_DfsBadRenamePath:
1443       return "The specified rename target path is invalid.";
1444     case NERR_DfsVolumeIsOffline:
1445       return "The specified DFS link is offline.";
1446     case NERR_DfsNoSuchServer:
1447       return "The specified server is not a server for this link.";
1448     case NERR_DfsCyclicalName:
1449       return "A cycle in the Dfs name was detected.";
1450     case NERR_DfsNotSupportedInServerDfs:
1451       return "The operation is not supported on a server-based Dfs.";
1452     case NERR_DfsDuplicateService:
1453       return "This link is already supported by the specified server-share.";
1454     case NERR_DfsCantRemoveLastServerShare:
1455       return "Can't remove the last server-share supporting this root or link.";
1456     case NERR_DfsVolumeIsInterDfs:
1457       return "The operation is not supported for an Inter-DFS link.";
1458     case NERR_DfsInconsistent:
1459       return "The internal state of the Dfs Service has become inconsistent.";
1460     case NERR_DfsServerUpgraded:
1461       return "The Dfs Service has been installed on the specified server.";
1462     case NERR_DfsDataIsIdentical:
1463       return "The Dfs data being reconciled is identical.";
1464     case NERR_DfsCantRemoveDfsRoot:
1465       return "The DFS root cannot be deleted. Uninstall DFS if required.";
1466     case NERR_DfsChildOrParentInDfs:
1467       return "A child or parent directory of the share is already in a Dfs.";
1468     case NERR_DfsInternalError:
1469       return "Dfs internal error.";
1470       /* the following are not defined in mingw */
1471 #if 0
1472
1473     case NERR_SetupAlreadyJoined:
1474       return "This machine is already joined to a domain.";
1475     case NERR_SetupNotJoined:
1476       return "This machine is not currently joined to a domain.";
1477     case NERR_SetupDomainController:
1478       return "This machine is a domain controller and cannot be unjoined from a domain.";
1479     case NERR_DefaultJoinRequired:
1480       return "The destination domain controller does not support creating machine accounts in OUs.";
1481     case NERR_InvalidWorkgroupName:
1482       return "The specified workgroup name is invalid.";
1483     case NERR_NameUsesIncompatibleCodePage:
1484       return "The specified computer name is incompatible with the default language used on the domain controller.";
1485     case NERR_ComputerAccountNotFound:
1486       return "The specified computer account could not be found.";
1487     case NERR_PersonalSku:
1488       return "This version of Windows cannot be joined to a domain.";
1489     case NERR_PasswordMustChange:
1490       return "The password must change at the next logon.";
1491     case NERR_AccountLockedOut:
1492       return "The account is locked out.";
1493     case NERR_PasswordTooLong:
1494       return "The password is too long.";
1495     case NERR_PasswordNotComplexEnough:
1496       return "The password does not meet the complexity policy.";
1497     case NERR_PasswordFilterError:
1498       return "The password does not meet the requirements of the password filter DLLs.";
1499 #endif
1500
1501     }
1502   msg = strerror (error_number);
1503   if (msg == NULL)
1504     msg = "unknown";
1505
1506   return msg;
1507 #endif //DBUS_WINCE
1508 }
1509
1510 /**
1511  * Get a printable string describing the command used to execute
1512  * the process with pid.  This string should only be used for
1513  * informative purposes such as logging; it may not be trusted.
1514  *
1515  * The command is guaranteed to be printable ASCII and no longer
1516  * than max_len.
1517  *
1518  * @param pid Process id
1519  * @param str Append command to this string
1520  * @param max_len Maximum length of returned command
1521  * @param error return location for errors
1522  * @returns #FALSE on error
1523  */
1524 dbus_bool_t
1525 _dbus_command_for_pid (unsigned long  pid,
1526                        DBusString    *str,
1527                        int            max_len,
1528                        DBusError     *error)
1529 {
1530   // FIXME
1531   return FALSE;
1532 }
1533
1534 /*
1535  * replaces the term DBUS_PREFIX in configure_time_path by the
1536  * current dbus installation directory. On unix this function is a noop
1537  *
1538  * @param configure_time_path
1539  * @return real path
1540  */
1541 const char *
1542 _dbus_replace_install_prefix (const char *configure_time_path)
1543 {
1544 #ifndef DBUS_PREFIX
1545   return configure_time_path;
1546 #else
1547   static char retval[1000];
1548   static char runtime_prefix[1000];
1549   int len = 1000;
1550   int i;
1551
1552   if (!configure_time_path)
1553     return NULL;
1554
1555   if ((!_dbus_get_install_root(runtime_prefix, len) ||
1556        strncmp (configure_time_path, DBUS_PREFIX "/",
1557                 strlen (DBUS_PREFIX) + 1))) {
1558      strcat (retval, configure_time_path);
1559      return retval;
1560   }
1561
1562   strcpy (retval, runtime_prefix);
1563   strcat (retval, configure_time_path + strlen (DBUS_PREFIX) + 1);
1564
1565   /* Somehow, in some situations, backslashes get collapsed in the string.
1566    * Since windows C library accepts both forward and backslashes as
1567    * path separators, convert all backslashes to forward slashes.
1568    */
1569
1570   for(i = 0; retval[i] != '\0'; i++) {
1571     if(retval[i] == '\\')
1572       retval[i] = '/';
1573   }
1574   return retval;
1575 #endif
1576 }
1577
1578 /**
1579  * return the relocated DATADIR
1580  *
1581  * @returns relocated DATADIR static string
1582  */
1583
1584 static const char *
1585 _dbus_windows_get_datadir (void)
1586 {
1587         return _dbus_replace_install_prefix(DBUS_DATADIR);
1588 }
1589
1590 #undef DBUS_DATADIR
1591 #define DBUS_DATADIR _dbus_windows_get_datadir ()
1592
1593
1594 #define DBUS_STANDARD_SESSION_SERVICEDIR "/dbus-1/services"
1595 #define DBUS_STANDARD_SYSTEM_SERVICEDIR "/dbus-1/system-services"
1596
1597 /**
1598  * Returns the standard directories for a session bus to look for service
1599  * activation files
1600  *
1601  * On Windows this should be data directories:
1602  *
1603  * %CommonProgramFiles%/dbus
1604  *
1605  * and
1606  *
1607  * relocated DBUS_DATADIR
1608  *
1609  * @param dirs the directory list we are returning
1610  * @returns #FALSE on OOM
1611  */
1612
1613 dbus_bool_t
1614 _dbus_get_standard_session_servicedirs (DBusList **dirs)
1615 {
1616   const char *common_progs;
1617   DBusString servicedir_path;
1618
1619   if (!_dbus_string_init (&servicedir_path))
1620     return FALSE;
1621
1622 #ifdef DBUS_WINCE
1623   {
1624     /* On Windows CE, we adjust datadir dynamically to installation location.  */
1625     const char *data_dir = _dbus_getenv ("DBUS_DATADIR");
1626
1627     if (data_dir != NULL)
1628       {
1629         if (!_dbus_string_append (&servicedir_path, data_dir))
1630           goto oom;
1631
1632         if (!_dbus_string_append (&servicedir_path, _DBUS_PATH_SEPARATOR))
1633           goto oom;
1634       }
1635   }
1636 #else
1637 /*
1638  the code for accessing services requires absolute base pathes
1639  in case DBUS_DATADIR is relative make it absolute
1640 */
1641 #ifdef DBUS_WIN
1642   {
1643     DBusString p;
1644
1645     _dbus_string_init_const (&p, DBUS_DATADIR);
1646
1647     if (!_dbus_path_is_absolute (&p))
1648       {
1649         char install_root[1000];
1650         if (_dbus_get_install_root (install_root, sizeof(install_root)))
1651           if (!_dbus_string_append (&servicedir_path, install_root))
1652             goto oom;
1653       }
1654   }
1655 #endif
1656   if (!_dbus_string_append (&servicedir_path, DBUS_DATADIR))
1657     goto oom;
1658
1659   if (!_dbus_string_append (&servicedir_path, _DBUS_PATH_SEPARATOR))
1660     goto oom;
1661 #endif
1662
1663   common_progs = _dbus_getenv ("CommonProgramFiles");
1664
1665   if (common_progs != NULL)
1666     {
1667       if (!_dbus_string_append (&servicedir_path, common_progs))
1668         goto oom;
1669
1670       if (!_dbus_string_append (&servicedir_path, _DBUS_PATH_SEPARATOR))
1671         goto oom;
1672     }
1673
1674   if (!_dbus_split_paths_and_append (&servicedir_path,
1675                                DBUS_STANDARD_SESSION_SERVICEDIR,
1676                                dirs))
1677     goto oom;
1678
1679   _dbus_string_free (&servicedir_path);
1680   return TRUE;
1681
1682  oom:
1683   _dbus_string_free (&servicedir_path);
1684   return FALSE;
1685 }
1686
1687 /**
1688  * Returns the standard directories for a system bus to look for service
1689  * activation files
1690  *
1691  * On UNIX this should be the standard xdg freedesktop.org data directories:
1692  *
1693  * XDG_DATA_DIRS=${XDG_DATA_DIRS-/usr/local/share:/usr/share}
1694  *
1695  * and
1696  *
1697  * DBUS_DATADIR
1698  *
1699  * On Windows there is no system bus and this function can return nothing.
1700  *
1701  * @param dirs the directory list we are returning
1702  * @returns #FALSE on OOM
1703  */
1704
1705 dbus_bool_t
1706 _dbus_get_standard_system_servicedirs (DBusList **dirs)
1707 {
1708   *dirs = NULL;
1709   return TRUE;
1710 }
1711
1712 /**
1713  * Append the absolute path of the system.conf file
1714  * (there is no system bus on Windows so this can just
1715  * return FALSE and print a warning or something)
1716  *
1717  * @param str the string to append to
1718  * @returns #FALSE if no memory
1719  */
1720 dbus_bool_t
1721 _dbus_append_system_config_file (DBusString *str)
1722 {
1723   return _dbus_get_config_file_name(str, "system.conf");
1724 }
1725
1726 /**
1727  * Append the absolute path of the session.conf file.
1728  *
1729  * @param str the string to append to
1730  * @returns #FALSE if no memory
1731  */
1732 dbus_bool_t
1733 _dbus_append_session_config_file (DBusString *str)
1734 {
1735   return _dbus_get_config_file_name(str, "session.conf");
1736 }