include/wvuid.h

   1 /* -*- Mode: C++ -*-
   2  * Worldvisions Weaver Software:
   3  *   Copyright (C) 1997-2002 Net Integration Technologies, Inc.
   4  *
   5  * Portable standins for getuid() and friends.
   6  */
   7 #ifndef __WVUID_H
   8 #define __WVUID_H
   9
  10 #include "wvstring.h"
  11
  12 #if WIN32
  13   typedef WvString wvuid_t;
  14   #define WVUID_INVALID (WvString::null)
  15 #else // not WIN32
  16   #include <pwd.h>
  17   typedef uid_t wvuid_t;
  18   #define WVUID_INVALID ((wvuid_t)(-1))
  19 #endif
  20
  21 /**
  22  * Convert a uid object into a human-readable username.
  23  * Returns WvString::null if the uid isn't findable or doesn't exist.
  24  */
  25 WvString wv_username_from_uid(wvuid_t uid);
  26
  27 /**
  28  * Convert a human-readable username into a machine-usable uid.
  29  * Returns WVUID_INVALID if the username isn't findable or doesn't exist.
  30  */
  31 wvuid_t wv_uid_from_username(WvString username);
  32
  33 /**
  34  * Return the machine-usable uid corresponding to the current session user.
  35  *
  36  * Corresponds to getuid() in Unix; parallels for functions
  37  * like getgid() and geteuid() are not currently available.
  38  *
  39  * In Unix, this should never fail.  In Windows, there is no guarantee that
  40  * it will work.  It returns WVUID_INVALID on failure.
  41  */
  42 wvuid_t wvgetuid();
  43
  44
  45 #endif // __WVUID_H