summaryrefslogtreecommitdiff
path: root/hurd/libtrivfs.mdwn
blob: b15aeabec13e2741880356c732b2105231ee2774 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
[[!meta copyright="Copyright © 1994, 1996, 1998, 1999, 2000, 2001, 2002, 2003,
2004, 2005, 2007, 2008, 2009, 2010 Free Software Foundation, Inc."]]

[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable
id="license" text="Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no Invariant
Sections, no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license
is included in the section entitled [[GNU Free Documentation
License|/fdl]]."]]"""]]

Certain [[translator]]s do not need to be very complex, because they represent
a single file rather than an entire directory hierarchy.  The *trivfs library*,
which is declared in `<hurd/trivfs.h>`, does most of the work of implementing
this kind of translator.  This library requires the [[iohelp|libiohelp]] and
[[ports|libports]] libraries.

Using `libtrivfs` is not the only way to implement such a single-file
translator, but is a convenient abstraction: the library hides a lot of
low-level stuff and you just have to provide a number of call-back functions
and symbols in order to get a functioning (for file I/O, etc.) node in the file
system.


# Further Reading

  * In the *[[The_GNU_Hurd_Reference_Manual|reference_manual]]*:
    <http://www.gnu.org/software/hurd/doc/hurd_6.html#SEC48>.

  * In the *[[Hurd_Hacking_Guide]]*:
    <http://www.gnu.org/software/hurd/hacking-guide/hhg.html#An-Example-using-trivfs>.