1 <!-- $XConsortium: uid.sgm /main/5 1996/08/30 13:45:57 rws $ -->
2 <!-- (c) Copyright 1995 Digital Equipment Corporation. -->
3 <!-- (c) Copyright 1995 Hewlett-Packard Company. -->
4 <!-- (c) Copyright 1995 International Business Machines Corp. -->
5 <!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
6 <!-- (c) Copyright 1995 Novell, Inc. -->
7 <!-- (c) Copyright 1995 FUJITSU LIMITED. -->
8 <!-- (c) Copyright 1995 Hitachi. -->
10 <![ %CDE.C.CDE; [<RefEntry Id="CDEMX.XCDI.MAN156.rsml.1">]]>
11 <![ %CDE.C.XO; [<RefEntry Id="XCDI.MAN156.rsml.1">]]>
13 <RefEntryTitle>tt_message_uid</RefEntryTitle>
14 <ManVolNum>library call</ManVolNum>
17 <RefName><Function>tt_message_uid</Function></RefName>
18 <RefPurpose>retrieve the user identifier attribute from a message
21 <!-- $XConsortium: uid.sgm /main/5 1996/08/30 13:45:57 rws $-->
22 <!-- CDE Common Source Format, Version 1.0.0-->
23 <!-- (c) Copyright 1993, 1994, 1995 Hewlett-Packard Company-->
24 <!-- (c) Copyright 1993, 1994, 1995 International Business Machines Corp.-->
25 <!-- (c) Copyright 1993, 1994, 1995 Sun Microsystems, Inc.-->
26 <!-- (c) Copyright 1993, 1994, 1995 Novell, Inc.-->
28 <FuncSynopsis Remap="ANSI">
29 <FuncSynopsisInfo>#include <Tt/tt_c.h>
31 <FuncDef>uid_t <Function>tt_message_uid</Function></FuncDef>
32 <ParamDef>Tt_message <Parameter>m</Parameter></ParamDef>
36 <Title>DESCRIPTION</Title>
38 <Function>tt_message_uid</Function> function
39 retrieves the user identifier attribute from the specified message.
41 <Para>The ToolTalk service automatically sets the user identifier of a message with
42 the user identifier of the process that created the message.
45 <Emphasis>m</Emphasis> argument is the opaque handle for the message involved in this operation.
49 <Title>RETURN VALUE</Title>
50 <Para>Upon successful completion, the
51 <Function>tt_message_uid</Function> function returns
52 the user identifier of the message.
54 <Literal>nobody</Literal> is returned, the
55 message handle is not valid.
59 <Title>SEE ALSO</Title>
60 <Para>&cdeman.Tt.tt.c.h;, &cdeman.tt.message.gid;.</Para>
63 <!--fickle 1.12 mancsf-to-docbook 1.2 08/07/95 23:18:47-->