GETLCID(2) BSD System Calls Manual GETLCID(2)

NAME
     ggeettllcciidd - get login context

SYNOPSIS
     ##iinncclluuddee <>

     pidt
     ggeettllcciidd(pidt pid);

DESCRIPTION
     The login context of the process identified by pid is returned by
     ggeettllcciidd().  If pid is zero, ggeettllcciidd() returns the login context of the
     current process.

     Login contexts are used for tracking processes that originated from a
     users login session.  A login context is inherited via ffoorrkk() or by
     explicit creation using the sseettllcciidd() call.

RETURN VALUES
     If successful, ggeettllcciidd() returns a non-negative integer, the Login Con-
     text ID; otherwise the value -1 is returned and the global variable errno
     is set to indicate the error.

EERRRROORRSS
     The ggeettllcciidd() function will fail if:

     [EPERM]            Operation not permitted.

     [ESRCH]            No such process.

     [ENOATTR]          Attribute not found.

SEE ALSO
     setlcid(2)

HISTORY     The ggeettllcciidd manual page first appeared in FreeBSD 6.0.

AUTHORS     This manual page was written by Matthew N. Dodd .

BSD                               May 5, 2005                              BSD