ttdt_file_notice(3)

ttdt_file_notice(3)    C LIBRARY FUNCTIONS    ttdt_file_notice(3)

NAME
     ttdt_file_notice -	 create	 and  send  a  standard	 ToolTalk
     notice about a file

SYNOPSIS
     #include <Tt/tttk.h>

     Tt_message	ttdt_file_notice(Tt_message context,
				 Tttk_op op,
				 Tt_scope scope,
				 const char *pathname,
				 int send_and_destroy);

DESCRIPTION
     The ttdt_file_notice()  function  is  used	 to  create  (and
     optionally	send) any of the standard file notices:	 Created,
     Deleted, Moved, Reverted, Saved, and Modified.

     The ttdt_file_notice() function creates a	notice	with  the
     specified op and scope, and sets its file attribute to path-
     name.  The	function adds an unset argument	of Tt_mode  TT_IN
     and vtype File to the notice, per the Desktop messaging con-
     ventions.	If send_and_destroy is	True,  ttdt_file_notice()
     sends  the	 message and then destroys it; otherwise, it only
     creates the message.

     The context argument describes the	environment to	use.   If
     context  is not zero, messages created by ttdt_file_notice()
     inherit from context all contexts whose slotname begins with
     the characters ENV_.

RETURN VALUE
     If	send_and_destroy is False, the	ttdt_file_notice()  func-
     tion returns the created Tt_message.  If send_and_destroy is
     True, it  returns	zero;  otherwise,  it  returns	an  error
     pointer.  The application can use tt_ptr_error(3) to extract
     one of the	following Tt_status values from	the returned han-
     dle:

	TT_DESKTOP_EINVAL
		The    op    argument	 was	TTDT_MOVED    and
		send_and_destroy was True.

	TT_ERR_DBAVAIL
		The ToolTalk service could not access  the  Tool-
		Talk database needed for this operation.

	TT_ERR_DBEXIST
		The ToolTalk service could not access the  speci-
		fied ToolTalk database in the expected place.

	TT_ERR_NOMEM
		There is insufficient memory available to perform

Unix System LaboratorLast change: 11 May 1994			1

ttdt_file_notice(3)    C LIBRARY FUNCTIONS    ttdt_file_notice(3)

		the function.

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

	TT_ERR_OVERFLOW
		The ToolTalk service  has  more	 active	 messages
		than  it  can  handle.	 (The  maximum	number of
		active messages	is implementation  specific,  but
		is at least 2000.)

	TT_ERR_POINTER
		The pathname argument was NULL or was a	 ToolTalk
		error pointer.

	TT_ERR_PROCID
		The specified process identifier is out	 of  date
		or invalid.

APPLICATION USAGE
     The ttdt_file_event() function is a  higher-level	interface
     than  ttdt_file_notice(),	and  is	the preferred way to send
     all but the Moved notice.

SEE ALSO
     Tttttk(5),	ttdt_file_event(3).

Unix System LaboratorLast change: 11 May 1994			2