Go to main content

man pages section 4: Device and Network Interfaces

Exit Print View

Updated: Thursday, June 13, 2019
 
 

Get_Modified (4)

Name

Get_Modified - ask whether an entity has been modified

Synopsis

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

Description

Desktop Services Message Sets                                  Get_Modified(4)



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 process-
       ing 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 trans-
       parently 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.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/tooltalk |
       +---------------+------------------+
       |Stability      | Committed        |
       +---------------+------------------+
SEE ALSO
       ttdt_file_join(3), ttdt_file_request(3), ttdt_file_request(3),
       ttdt_Get_Modified(3); Set_Modified request.




ToolTalk 1.3                     1 March 1996                  Get_Modified(4)