tt_session_bprop_add(3)

tt_session_bprop_add(3)C LIBRARY FUNCTIONStt_session_bprop_add(3)

NAME
     tt_session_bprop_add - add	a new byte-string  value  to  the
     end of the	list of	values

SYNOPSIS
     #include <Tt/tt_c.h>

     Tt_status tt_session_bprop_add(const char *sessid,
				    const char *propname,
				    const unsigned char	*value,
				    int	length);

DESCRIPTION
     The tt_session_bprop_add()	function adds a	 new  byte-string
     value  to	the  end of the	list of	values for the named 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	to add values.	The value
     argument is the value to add to the session  property.   The
     length argument is	the size of the	value in bytes.

RETURN VALUE
     Upon successful completion, the tt_session_bprop_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 2048.)

	TT_ERR_PROPNAME
		The  specified	property  name	is  syntactically
		invalid.

SEE ALSO
     Tttt_c(5).

Unix System LaboratorLast change: 11 May 1994			1