genode/repos/os/src/server/iso9660
Norman Feske 17c79a9e23 base: avoid use of deprecated base/printf.h
Besides adapting the components to the use of base/log.h, the patch
cleans up a few base headers, i.e., it removes unused includes from
root/component.h, specifically base/heap.h and
ram_session/ram_session.h. Hence, components that relied on the implicit
inclusion of those headers have to manually include those headers now.

While adjusting the log messages, I repeatedly stumbled over the problem
that printing char * arguments is ambiguous. It is unclear whether to
print the argument as pointer or null-terminated string. To overcome
this problem, the patch introduces a new type 'Cstring' that allows the
caller to express that the argument should be handled as null-terminated
string. As a nice side effect, with this type in place, the optional len
argument of the 'String' class could be removed. Instead of supplying a
pair of (char const *, size_t), the constructor accepts a 'Cstring'.
This, in turn, clears the way let the 'String' constructor use the new
output mechanism to assemble a string from multiple arguments (and
thereby getting rid of snprintf within Genode in the near future).

To enforce the explicit resolution of the char * ambiguity, the 'char *'
overload of the 'print' function is marked as deleted.

Issue #1987
2016-08-29 17:27:10 +02:00
..
backing_store.h base: avoid use of deprecated base/printf.h 2016-08-29 17:27:10 +02:00
iso9660.cc base: avoid use of deprecated base/printf.h 2016-08-29 17:27:10 +02:00
iso9660.h Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
main.cc base: avoid use of deprecated base/printf.h 2016-08-29 17:27:10 +02:00
README Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
target.mk Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00

This directory contains an implementation of an ISO 9660 file system.

Limitations
-----------

At the moment, the only file-name format supported is the Rock Ridge extension.
The ISO specified 8.3 upper-case-file names are not supported, as well as Joliet.

Usage
-----

The server requires an ATAPI-block device as back-end. Please have a look at
'os/src/drivers/atapi'. The front-end of the server is implemented as a ROM
session server. In order to access this server from your application, you need
to route the ROM session to the ISO-ROM-session server in Genode's configuration
file:

!<start name="test-iso">
!  <resource name="RAM" quantum="10M" />
!    <route>
!      <service name="ROM"><child name="iso9660"/></service>
!    </route>
!</start>

Currently, the RAM quota necessary to obtain a file from the ISO file system
is allocated on behalf of the ISO server. Please make sure to provide
sufficient RAM quota to the ISO server.