Manual Pages for UNIX Operating System command usage for man gettaskid

System Calls                                         settaskid(2)



NAME
     settaskid, gettaskid, getprojid - set or get task or project
     IDs

SYNOPSIS
     #include 
     #include 
     #include 

     taskid_t settaskid(projid_t project, int flags);


     taskid_t gettaskid(void);


     #include 
     #include 
     #include 
     #include 

     projid_t getprojid(void);


DESCRIPTION
     The settaskid() function makes a request of  the  system  to
     assign  a  new  task ID to the calling process, changing the
     associated project ID to that specified. The calling process
     must  have  sufficient privileges to perform this operation.
     The flags argument should be either TASK_NORMAL for a  regu-
     lar  task,  or  TASK_FINAL,  which disallows subsequent set-
     taskid() calls by the created task.


     The gettaskid() function returns the task ID of the  calling
     process.


     The getprojid() function returns the project ID of the  cal-
     ling process.

RETURN VALUES
     Upon  successful  completion,  these  functions  return  the
     appropriate  task  or  project ID. Otherwise, -1 is returned
     and errno is set to indicate the error.

ERRORS
     The settaskid() function will fail if:

     EACCES    The invoking task was created with the  TASK_FINAL
               flag.





SunOS 5.11           Last change: 5 May 2010                    1






System Calls                                         settaskid(2)



     EAGAIN    A resource control limiting the number  of  tasks,
               LWPs,  or processes in the current project or zone
               has been exceeded.

               A resource control on the given project  would  be
               exceeded.


     EINVAL    The given project ID is not within the valid  pro-
               ject ID range.


     EPERM     The {PRIV_PROC_TASKID} privilege is  not  asserted
               in the effective set of the calling process.


ATTRIBUTES
     See attributes(5)  for descriptions of the following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Async-Signal-Safe           |
    |_____________________________|_____________________________|


SEE ALSO
     setsid(2), project(4), attributes(5), privileges(5)
























SunOS 5.11           Last change: 5 May 2010                    2