genode/repos/os/src/server/lx_fs
Christian Helmuth b805e001db Add READ_READY support to file-system session
The read-ready packet informs the server that the client wants to be
notified if a handle becomes readable. When becoming readable, the
server acknowledges packet and the client may queue a read requests
accordingly.
2017-02-23 14:54:51 +01:00
..
directory.h base: avoid use of deprecated base/printf.h 2016-08-29 17:27:10 +02:00
file.h linux: prevent hybrid-mode compiler warnings 2015-05-26 09:39:53 +02:00
lx_util.h Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
main.cc Add READ_READY support to file-system session 2017-02-23 14:54:51 +01:00
node.h Remove Genode namespace from File_system 2016-01-08 14:48:52 +01:00
README Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
symlink.h rump_fs/fuse_fs/lx_fs/ram_fs: symlink fixup 2015-07-21 09:40:19 +02:00
target.mk Build dynamically linked executables by default 2016-12-14 11:22:27 +01:00

This directory contains an Genode file-system service to Linux host fs
wrapper.

Configuration
~~~~~~~~~~~~~

Access to the file system can be tailored for each session depending on the
session's label. By default, no permissions are granted to any session.
To selectively permit access to (a part of) the file system, at least one
policy must be defined.

The following configuration illustates the way of how to express policy.

! <config>
!   <!-- constrain sessions according to their labels -->
!   <policy label="noux -> root" root="/" />
!   <policy label="noux -> home" root="/home/user" writeable="yes" />
!   <policy label="noux -> tmp"  root="/tmp"       writeable="yes" />
! </config>

Session-specific access-control policy is expressed via one or more '<policy>'
nodes. At session-creation time, each policy node is matched against the label
of the new session. If the label of a policy node matches, the defined policy
is applied. If multiple policies match, the one with the longest 'label'
attribute (the most specific one) is selected.

A policy node may contain the following attributes. The mandatory 'root'
attribute defines the viewport of the session onto the file system. The
optional 'writeable' attribute grants the permission to modify the file system.


Example
~~~~~~~

To illustrate the use of lx_fs, refer to the 'base-linux/run/lx_fs.run'
script.


Notes
~~~~~

If the Linux file system experiences changes from other processes
'inotify' may help to keep the servers cache up-to-date. This is not
implemented yet.