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_fd 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 */
62dbus_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  return TRUE;
69}
70
71/**
72 * Creates a file containing the process ID.
73 *
74 * @param filename the filename to write to
75 * @param pid our process ID
76 * @param error return location for errors
77 * @returns #FALSE on failure
78 */
79static dbus_bool_t
80_dbus_write_pid_file (const DBusString *filename,
81                      unsigned long     pid,
82                      DBusError        *error)
83{
84  const char *cfilename;
85  HANDLE hnd;
86  char pidstr[20];
87  int total;
88  int bytes_to_write;
89
90  _DBUS_ASSERT_ERROR_IS_CLEAR (error);
91
92  cfilename = _dbus_string_get_const_data (filename);
93
94  hnd = CreateFileA (cfilename, GENERIC_WRITE,
95                     FILE_SHARE_READ | FILE_SHARE_WRITE,
96                     NULL, CREATE_NEW, FILE_ATTRIBUTE_NORMAL,
97                     INVALID_HANDLE_VALUE);
98  if (hnd == INVALID_HANDLE_VALUE)
99    {
100      char *emsg = _dbus_win_error_string (GetLastError ());
101      dbus_set_error (error, _dbus_win_error_from_last_error (),
102                      "Could not create PID file %s: %s",
103                      cfilename, emsg);
104      _dbus_win_free_error_string (emsg);
105      return FALSE;
106    }
107
108  if (snprintf (pidstr, sizeof (pidstr), "%lu\n", pid) < 0)
109    {
110      dbus_set_error (error, _dbus_error_from_system_errno (),
111                      "Failed to format PID for \"%s\": %s", cfilename,
112                      _dbus_strerror_from_errno ());
113      CloseHandle (hnd);
114      return FALSE;
115    }
116
117  total = 0;
118  bytes_to_write = strlen (pidstr);;
119
120  while (total < bytes_to_write)
121    {
122      DWORD bytes_written;
123      BOOL res;
124
125      res = WriteFile (hnd, pidstr + total, bytes_to_write - total,
126                       &bytes_written, NULL);
127
128      if (res == 0 || bytes_written <= 0)
129        {
130          char *emsg = _dbus_win_error_string (GetLastError ());
131          dbus_set_error (error, _dbus_win_error_from_last_error (),
132                           "Could not write to %s: %s", cfilename, emsg);
133          _dbus_win_free_error_string (emsg);
134          CloseHandle (hnd);
135          return FALSE;
136        }
137
138      total += bytes_written;
139    }
140
141  if (CloseHandle (hnd) == 0)
142    {
143      char *emsg = _dbus_win_error_string (GetLastError ());
144      dbus_set_error (error, _dbus_win_error_from_last_error (),
145                       "Could not close file %s: %s",
146                      cfilename, emsg);
147      _dbus_win_free_error_string (emsg);
148
149      return FALSE;
150    }
151
152  return TRUE;
153}
154
155/**
156 * Writes the given pid_to_write to a pidfile (if non-NULL) and/or to a
157 * pipe (if non-NULL). Does nothing if pidfile and print_pid_pipe are both
158 * NULL.
159 *
160 * @param pidfile the file to write to or #NULL
161 * @param print_pid_pipe the pipe to write to or #NULL
162 * @param pid_to_write the pid to write out
163 * @param error error on failure
164 * @returns FALSE if error is set
165 */
166dbus_bool_t
167_dbus_write_pid_to_file_and_pipe (const DBusString *pidfile,
168                                  DBusPipe         *print_pid_pipe,
169                                  dbus_pid_t        pid_to_write,
170                                  DBusError        *error)
171{
172  if (pidfile)
173    {
174      _dbus_verbose ("writing pid file %s\n", _dbus_string_get_const_data (pidfile));
175      if (!_dbus_write_pid_file (pidfile,
176                                 pid_to_write,
177                                 error))
178        {
179          _dbus_verbose ("pid file write failed\n");
180          _DBUS_ASSERT_ERROR_IS_SET(error);
181          return FALSE;
182        }
183    }
184  else
185    {
186      _dbus_verbose ("No pid file requested\n");
187    }
188
189  if (print_pid_pipe != NULL && _dbus_pipe_is_valid (print_pid_pipe))
190    {
191      DBusString pid;
192      int bytes;
193
194      _dbus_verbose ("writing our pid to pipe %d\n", print_pid_pipe->fd);
195
196      if (!_dbus_string_init (&pid))
197        {
198          _DBUS_SET_OOM (error);
199          return FALSE;
200        }
201
202      if (!_dbus_string_append_int (&pid, pid_to_write) ||
203          !_dbus_string_append (&pid, "\n"))
204        {
205          _dbus_string_free (&pid);
206          _DBUS_SET_OOM (error);
207          return FALSE;
208        }
209
210      bytes = _dbus_string_get_length (&pid);
211      if (_dbus_pipe_write (print_pid_pipe, &pid, 0, bytes, error) != bytes)
212        {
213          /* _dbus_pipe_write sets error only on failure, not short write */
214          if (error != NULL && !dbus_error_is_set(error))
215            {
216              dbus_set_error (error, DBUS_ERROR_FAILED,
217                              "Printing message bus PID: did not write enough bytes\n");
218            }
219          _dbus_string_free (&pid);
220          return FALSE;
221        }
222
223      _dbus_string_free (&pid);
224    }
225  else
226    {
227      _dbus_verbose ("No pid pipe to write to\n");
228    }
229
230  return TRUE;
231}
232
233/**
234 * Verify that after the fork we can successfully change to this user.
235 *
236 * @param user the username given in the daemon configuration
237 * @returns #TRUE if username is valid
238 */
239dbus_bool_t
240_dbus_verify_daemon_user (const char *user)
241{
242  return TRUE;
243}
244
245/**
246 * Changes the user and group the bus is running as.
247 *
248 * @param user the user to become
249 * @param error return location for errors
250 * @returns #FALSE on failure
251 */
252dbus_bool_t
253_dbus_change_to_daemon_user  (const char    *user,
254                              DBusError     *error)
255{
256  return TRUE;
257}
258
259void
260_dbus_request_file_descriptor_limit (unsigned int limit)
261{
262}
263
264void
265_dbus_init_system_log (void)
266{
267  /* OutputDebugStringA doesn't need any special initialization, do nothing */
268}
269
270/**
271 * Log a message to the system log file (e.g. syslog on Unix).
272 *
273 * @param severity a severity value
274 * @param msg a printf-style format string
275 * @param args arguments for the format string
276 *
277 */
278void
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 */
300void
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 */
326void
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 */
341dbus_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
429Copyright (C) 2000 Werner Almesberger
430
431libc/sys/linux/sys/dirent.h - Directory entry as returned by readdir
432
433This program is free software; you can redistribute it and/or
434modify it under the terms of the GNU Library General Public
435License as published by the Free Software Foundation; either
436version 2 of the License, or (at your option) any later version.
437
438This program is distributed in the hope that it will be useful,
439but WITHOUT ANY WARRANTY; without even the implied warranty of
440MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
441Library General Public License for more details.
442
443You should have received a copy of the GNU Library General Public License
444along with this program; see the file COPYING.  If not, write to
445the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
446Boston, 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 */
456struct 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 */
465typedef 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  }
474DIR;
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
491static 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
525static 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
555static 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 */
572struct 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 */
585DBusDirIter*
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 */
634dbus_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
643again:
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 */
678void
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 */
698dbus_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 */
766dbus_bool_t
767_dbus_unix_user_is_process_owner (dbus_uid_t uid)
768{
769  return FALSE;
770}
771
772dbus_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 */
790dbus_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 */
808dbus_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 */
823dbus_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 */
841dbus_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 */
864const 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 */
1524dbus_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