This manual page is part of Xcode Tools version 3.2

To obtain these tools:

If you are running a version of Xcode Tools other than 3.2, view the documentation locally:

  • In Xcode

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • For more information about the manual page format, see the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Reference Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.


SETLCID(3)                              BSD Library Functions Manual                              SETLCID(3)

NAME
     setlcid -- set login context

SYNOPSIS
     #include <sys/lctx.h>

     int
     setlcid(pid_t pid, pid_t lcid);

DESCRIPTION
     The setlcid() system call sets the login context of the specified process pid to the specified lcid.
     If the pid is zero, then the call applies to the current process.  If the lcid is zero a new login con-text context
     text will be created.  If the lcid is -1 the process will be removed from the login context it is cur-rently currently
     rently a member of, if any.

     Creation of a new login context is only valid for the current process.  A process may not create a new
     login context if it is currently a member of one.

     Superuser privilege is required to add or remove a process from a login context.

RETURN VALUES
     The setlcid() function returns the value 0 if successful; otherwise the value -1 is returned and the
     global variable errno is set to indicate the error.

ERRORS
     The setlcid() function will fail if:

     [EPERM]            Operation not permitted.

     [ESRCH]            No such process.

     [ENOMEM]           Cannot allocate memory.

     [ENOATTR]          Attribute not found.

SEE ALSO
     getlcid(2)

HISTORY
     The setlcid manual page first appeared in FreeBSD 6.0.

AUTHORS
     This manual page was written by Matthew N. Dodd <[email protected]>.

BSD                                              May 5, 2005                                             BSD

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.