Get_Modified(4)

Get_Modified(4)	 DEVICES AND NETWORK INTERFACES	  Get_Modified(4)

NAME
     Get_Modified request - ask	whether	an entity has been  modi-
     fied

SYNOPSIS
     [file] Get_Modified(in type ID,
			 out boolean modified);

DESCRIPTION
     The Get_Modified request asks whether any tool has	 modified
     a	volatile, non-shared (for example, in-memory) representa-
     tion of the persistent state of an	entity (such as	 a  file)
     with  the intention of eventually making that representation
     persistent.

     Thus, a tool should register  a  dynamic  pattern	for  this
     request  when  it	has modified an	entity of possible shared
     interest.

     The ID argument is	the identity  of  the  persistent  entity
     being  asked about.  When its type	is File, then ID is unset
     (in other words, has a value of (char *)0), and it	refers to
     the file or directory named in the	message's file attribute.

     The modified argument argument is a Boolean value indicating
     whether  a	 volatile,  non-shared	(for  example, in-memory)
     representation of the entity  has	been  modified	with  the
     intention	of  eventually	making	that  representation per-
     sistent.

ERRORS
     The ToolTalk service may return one of the	following  errors
     in	processing the Get_Modified request:

	TT_ERR_NO_MATCH
	      Since no handler could  be  found,  the  entity  in
	      question can be assumed not to be	modified.

APPLICATION USAGE
     The ttdt_file_join(3), function can be used to register for,
     and transparently process,	the Get_Modified request.

     The    Get_Modified    request    can    be    sent     with
     ttdt_file_request(3);  ttdt_Get_Modified(3),  can	send  the
     Get_Modified request and block on the reply.

SEE ALSO
     ttdt_file_join(3),	ttdt_file_request(3),
     ttdt_file_request(3), ttdt_Get_Modified(3); Set_Modified
     request.

Unix System LaboratorLast change: 13 May 1994			1