op annotation tag

2 minute readReference

Synopsis

A single filesystem operation performed by a job in the build. The element is only present if the annotation detail includes file or lookup.

Attributes

atts

If the type of the operation is modifyAttrs, this attribute gives the list of file attributes that were modified. If the type of the operation is create or blindcreate, this attribute gives the list of file attributes that were explicitly set after the file was created.

file

Name of the file involved in the operation.

filetype

Type of the file. One of file, for regular files; dir, for directories; or symlink for symbolic links.

found

Flag indicating whether the file existed when the operation was performed. 1, the default value, indicates that the file existed, 0 indicates that the file did not exist.

md5

The MD5 checksum of the file. This attribute is only present if the annotation detail includes md5.

other

For operations involving two filenames (such as rename and link), the second name involved in the operation.

type

Type of filesystem operation; one the following:

  • append: the job added data to the end of the file, without reading any of the existing data.

  • blindcreate: the job created a file from scratch unconditionally, meaning the result of the operation would be the same whether or not the file existed before the operation.

  • create: the job created a file from scratch, or truncated and rewrote an existing file without reading any of the existing data.

  • link: the job created a hard link between two files.

  • lookup: the job stat()'d the file.

  • marker: delineates the boundary between operations incurred during up-to-date checks (before the marker) and operations incurred during execution of the job (after the marker).

  • modify: the job read some portion of an existing file, then replace some or all of the data in the file.

  • modifyAttrs: the job changed the attributes of the file, such as the owner, group or permissions.

  • read: the job read the file.

  • rename: the job renamed the file.

  • unlink: the job deleted the file.

Contents

None.