.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

.. include:: ../../../Includes.txt

Directory
^^^^^^^^^

So far, nothing special here.

Just a quick explanation, what this abstraction layer is capable of doing:

- run through a specified directory
- get all directories (no files, no ., no ..)
- get meta information on the folders

For the data columns to be specified, here is a list of available "columns" in this handler.

==================  =========== ==========================  =============
Name                Type        Description                 Example
==================  =========== ==========================  =============
directory           string      directory name              fileadmin
name                string      basically the same          fileadmin
tstamp_creation     number/int  Unix timestamp of creation  1383724742
tstamp_lastaccess   number/int  timestamp of last access    1383725011
tstamp_modified     number/int  timestamp of last change    1383734253
permissions         number/int  system-dep. permissions     *varies*
usergroup           number/int  system-dep. usergroup       *varies*
user                number/int  system-dependant user       *varies*
inode               number/int  Unix-only ID of file        51348
is_writable         boolean     true if file is writable    false
==================  =========== ==========================  =============