Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

tt_message_uid (3)

Name

tt_message_uid - retrieve the user identifier attribute from a message

Synopsis

#include <Tt/tt_c.h>
uid_t tt_message_uid(Tt_message m);

Description

tt_message_uid(3)             ToolTalk Functions             tt_message_uid(3)



NAME
       tt_message_uid - retrieve the user identifier attribute from a message

SYNOPSIS
       #include <Tt/tt_c.h>
       uid_t tt_message_uid(Tt_message m);

DESCRIPTION
       The  tt_message_uid()  function retrieves the user identifier attribute
       from the specified message.

       The ToolTalk service automatically sets the user identifier of  a  mes-
       sage with the user identifier of the process that created the message.

       The  m  argument  is the opaque handle for the message involved in this
       operation.

       The application should check the tt_message_uid() and tt_message_gid(3)
       against the User ID and Group ID of the application receiving the mess-
       sage. If the UID and/or GID of the application do not match that of the
       message then the receiving application should consider failing the mes-
       sage with TT_DESKTOP_EACCES.

RETURN VALUE
       Upon successful completion, the tt_message_uid() function  returns  the
       user  identifier  of the message.  If the group nobody is returned, the
       message handle is not valid.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/tooltalk |
       +---------------+------------------+
       |Stability      | Committed        |
       +---------------+------------------+
SEE ALSO
       tt_c(5), tt_message_gid(3).




ToolTalk 1.3                     1 March 1996                tt_message_uid(3)