ttdt_file_notice - create and send a standard ToolTalk notice about a file
#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);
ttdt_file_notice(3) ToolTalk 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 pathname. The function adds
an unset argument of Tt_mode TT_IN and vtype File to the notice, per
the Desktop messaging conventions. 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() function 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 handle:
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 ToolTalk database
needed for this operation.
TT_ERR_DBEXIST
The ToolTalk service could not access the specified ToolTalk
database in the expected place.
TT_ERR_NOMEM
There is insufficient memory available to perform the func-
tion.
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 implemen-
tation 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.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | library/tooltalk |
+---------------+------------------+
|Stability | Committed |
+---------------+------------------+
SEE ALSO
tttk(5), ttdt_file_event(3).
ToolTalk 1.3 1 March 1996 ttdt_file_notice(3)