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