Fires when the OS wants to read (enumerate) a directory's contents.
class FUSEReadDirEventParams(object): @property def path() -> str: ... @property def filler_context() -> int: ... @property def result() -> int: ... @result.setter def result(value) -> None: ... # In class FUSE: @property def on_read_dir() -> Callable[[FUSEReadDirEventParams], None]: ... @on_read_dir.setter def on_read_dir(event_hook: Callable[[FUSEReadDirEventParams], None]) -> None: ...
This event fires when the OS wants to enumerate the contents of the directory, identified by Path. In response to this event the application must call the filler method and pass it FillerContextparameter as well as the information about the directory entry. Please, refer to the description of filler for further details.
If filler returns an error code, set Result to the returned code (do not negate the code). If there are no more files to pass, set Result to 0.
The ResultCode parameter will always be 0 when the event is fired. If the event cannot be handled in a "successful" manner for some reason (e.g., a resource isn't available, security checks failed, etc.), set it to a negative error code value (e.g. -ENOENT to indicate that the file does not exist) to report an appropriate error. Please refer to the Error Reporting and Handling topic for more information.