Crate io_conformance_util

Crate to provide fidl logging and test setup helpers for conformance tests for fuchsia.io.

Modules

• flags
  Utility functions for getting combinations of flags.
• test_harness
  Test harness helper struct.

Constants

• EMPTY_NODE_ATTRS
  A default value for NodeAttributes, with zeros set for all fields.
• TEST_FILE
  A common name for a file to create in a conformance test.
• TEST_FILE_CONTENTS
  A common set of file contents to write into a test file in a conformance test.

Traits

• DirectoryProxyExt
  Extension trait for fio::DirectoryProxy to make interactions with the fuchsia.io protocol less verbose.

Functions

• assert_file_not_found
  Attempts to open the given file, and checks the status is NOT_FOUND.
• assert_on_open_not_received
  Asserts that no fio::NodeEvent::OnOpen_ event is sent on an opened proxy.
• convert_node_proxy
  Converts a generic fio::NodeProxy to either fio::FileProxy or fio::DirectoryProxy. WARNING: This function does not verify that the conversion is valid.
• create_file_and_get_backing_memory
  Creates a directory with the given DirectoryEntry, opening the file with the given file flags, and returning a Buffer object initialized with the given vmo_flags.
• directory
  Makes a subdirectory with a name and a set of entries.
• executable_file
  Makes an executable file to be placed in the test directory.
• file
  Makes a file to be placed in the test directory.
• get_directory_entry_name
  Returns the .name field from a given DirectoryEntry, otherwise panics.
• get_open_status
  Wait for fio::NodeEvent::OnOpen_ to be sent via node_proxy and returns its zx::Status.
• get_token
  Helper function to call get_token on a directory. Only use this if testing something other than the get_token call directly.
• open_dir_with_flags
  Helper function to open a sub-directory with the given flags. Only use this if testing something other than the open call directly.
• open_file_with_flags
  Helper function to open a file with the given flags. Only use this if testing something other than the open call directly.
• open_node
  Helper function to open the desired node in the root folder. Asserts that open_node_status succeeds.
• open_node_status
  Helper function to open the desired node in the root folder.
• open_rw_dir
  Helper function to open a sub-directory as readable and writable. Only use this if testing something other than the open call directly.
• read_file
  Helper function to read a file and return its contents. Only use this if testing something other than the read call directly.
• remote_directory
  Makes a remote directory with a name, which forwards the requests to the given directory proxy.
• root_directory
  Constructs a directory from a set of directory entries.
• validate_vmo_rights
  Asserts that the given vmo_rights align with the expected_vmo_rights passed to a get_backing_memory call. We check that the returned rights align with and do not exceed those in the given flags, that we have at least basic VMO rights, and that the flags align with the expected sharing mode.