Index for Section 4

Alphabetical listing for G

Bottom of page

Get_Modified(4)
CDE
NAME
  Get_Modified - ask whether an entity has been modified

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) representation 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 persistent.

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

Index for Section 4

Alphabetical listing for G

Top of page