tt_session_prop_add(3)

tt_session_prop_add(3) C LIBRARY FUNCTIONS tt_session_prop_add(3)

NAME
     tt_session_prop_add - add a new  character-string	value  to
     the end of	the list of values

SYNOPSIS
     #include <Tt/tt_c.h>

     Tt_status tt_session_prop_add(const char *sessid,
				   const char *propname,
				   const char *value);

DESCRIPTION
     The tt_session_prop_add() function	 adds  a  new  character-
     string  value  to the end of the list of values for the pro-
     perty of the specified session.

     The sessid	argument is the	name of	the session joined.   The
     application   can	 use   the  sessid  value  returned  when
     tt_default_session() is called.  The  propname  argument  is
     the  name	of  the	property to which a value is to	be added.
     The name must be less than	64 bytes.  The value argument  is
     the character string to add to the	property name list.

RETURN VALUE
     Upon successful completion, the tt_session_prop_add()  func-
     tion  returns the status of the operation as one of the fol-
     lowing Tt_status values:

	TT_OK	The operation completed	successfully.

	TT_ERR_NOMP
		The ttsession(1) process is not	running	 and  the
		ToolTalk service cannot	restart	it.

	TT_ERR_PROPLEN
		The specified property value is	too  long.   (The
		maximum	 size  is implementation specific, but is
		at least 64.)

	TT_ERR_PROPNAME
		The  specified	property  name	is  syntactically
		invalid.

	TT_ERR_SESSION
		The specified ToolTalk session is out of date  or
		invalid.

SEE ALSO
     Tttt_c(5).

Unix System LaboratorLast change: 11 May 1994			1