Filesystems management
======================

Filesystems are represented through cursors, which represent a view of
a filesystem through a current directory.

The filesystem object is usable both by the library and the user. It is
usually opened through a system.

.. type:: tio_file_cursor_t

	A filesystem cursor object.

Changing the current directory
------------------------------

You can change the current directory on which a file cursor is pointing
to with the following function:

.. c:function:: int tio_move(tio_file_cursor_t *cursor, char const *name)

	Changes the current directory on which a file cursor is pointing
	to to the one within the current directory that uses the name
	given by ``name``, or the parent directory if ``name`` is ``".."``.

Gathering information on the current folder
-------------------------------------------

You can list files through the following file:

.. c:function:: int tio_list(tio_file_cursor_t *cursor, tio_iter_t **iterp)

	Create a file iterator which gives things. TODO