Lines Matching refs:an
7 The FS-Cache system provides an API by which actual caches can be supplied to
83 In either case, this may not be an appropriate context in which to access the
168 An operation can be made exclusive upon an object by setting the
170 an operation needs more processing time, it should be enqueued again.
194 The to_do field is an empty list available for the cache backend to use as
226 This isn't strictly an operation, but should be pointed at a string naming
249 This method is used to look up an object, given that the object is already
276 This method is called to increment the reference count on an object. It
286 These methods are used to exclusively lock an object. It must be possible
295 These methods are used to pin an object into the cache. Once pinned an
300 * Check coherency state of an object [mandatory]::
323 All the data stored for this object should be discarded and an
325 with an object update operation.
334 This method is called to indicate that an object has been unbound from its
346 This method is used to discard a reference to an object. The object may
377 highest byte it's willing to store for an object.
379 This method may return -ve if an error occurred or the cache object cannot
387 * Reserve cache space for an object's data [optional]::
392 for an object and the metadata used to track it. Zero size should be
399 future expansion. If the amount of space consumed by an object would
435 be called at an appropriate point to request CPU time. For instance, the
439 If an I/O error occurs, fscache_io_error() should be called and -ENOBUFS
460 If there was an error such as -ENOMEM, then that should be returned; else
490 This is an multiple page version of the allocate_page() method. pages and
507 If an error occurred, then a negative error code should be returned,
509 in response to an error, such as withdrawing this object.
529 * Note occurrence of an I/O error in a cache::
533 This tells FS-Cache that an I/O error occurred in the cache. After this
546 This is called to note the end of an attempt to retrieve a page. The
547 error value should be 0 if successful and an error otherwise.
566 This is called to record the completion of an operation. This deducts
590 * Perform coherency check on an object::
596 This asks the netfs to perform a coherency check on an object that has
619 This initialises all the fields in an object representation.
622 * Indicate the destruction of an object::
626 This must be called to inform FS-Cache that an object that belonged to a
632 * Indicate negative lookup on an object::
636 This is called to indicate to FS-Cache that a lookup process for an object
639 This changes the state of an object to permit reads pending on lookup
643 This may be called multiple times on an object. Only the first call is
647 * Indicate an object has been obtained::
651 This is called to indicate to FS-Cache that a lookup process for an object
652 produced a positive result, or that an object was created. This should
655 This changes the state of an object to indicate:
668 This marks an object as having encountered a fatal error (usually EIO)
677 This is called to indicate that the lookup procedure found an object in
682 * Indicate that the caching backend killed an object::
687 This is called to indicate that the cache backend preemptively killed an
726 For debugging purposes, this may be used to turn the state that an object