uidtontsid(2)                                             uidtontsid(2)

  uidtontsid()

  NAME

    uidtontsid(), uidtontsid_r() - retrieve user's Windows security ID

  SYNOPSIS

    #include 

    char * uidtontsid(uid_t uid)
    int  uidtontsid_r(uid_t uid, char *buf, int bufsize)

  DESCRIPTION

    The uidtontsid(2) function retrieves the Windows security ID of the user
    specified by uid, and returns a pointer to a static buffer that contains
    the security ID as an ASCII string.

    The reentrant uidtontsid_r(2) function retrieves the Windows security ID
    of the user specified by uid and stores the ID in the location identified
    by buf, the length of which is specified by bufsize. The buffer must be at
    least SID_NAME_MAX (defined in ) in size.

    Windows security IDs are unique throughout time and space; a POSIX user ID
    under Windows is only unique within a trusted domain network.

  RETURN VALUES

    On success, uidtontsid(2) returns a pointer to a static buffer. On
    failure, it returns NULL and sets errno to indicate the cause of the
    error.

    Upon successful completion, uidtontsid_r(2) returns 0; otherwise, it
    returns an error number to indicate the error.

  ERRORS

    Both functions can set the following error:

    [EINVAL]
        The uid is invalid.

    The uidtontsid_r(2) function can fail for the following reason:

    ERANGE
        The size of the buffer (bufsize) provided is smaller than the result
        to be returned.

  SEE ALSO

  USAGE NOTES

    The uidtontsid_r function is thread safe. The uidtontsid function is not
    thread safe.

    None of these functions are async-signal safe.