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
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
|
[[!meta copyright="Copyright © 2008, 2009 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]]."]]"""]]
Sergiu Ivanov
Mail: <mailto:unlimitedscolobb@gmail.com>
# Google Summer of Code: 2009 Project
**Unionmount**: The goal of this project is to make it possible to set
translators in unionmount mode, which means that the filesystem
published by the mounted translator will get merged with the directory
tree of the node the translator is mounted onto.
For documentation, see [[hurd/translator/unionmount]].
---
## Roadmap
### DONE
(Dates in brackets show the completion date)
* **Make `unionfs` build.** *(24 May)* For reasons unknown to me,
`unionfs` Makefile was configured to search for include files from
under `$(prefix)/include`, while `$(prefix)` was never
defined. Setting `$(prefix)` to `/usr` solved the problem.
* **Change the command line parsing in `unionfs` to comply with the
requirements of `unionmount`.** *(25 May)* Although the core
functionality of `unionmount` heavily relies on `unionfs`, the
command line interface of these two programs is completely
different: `unionfs` operates on directories, the list of which is
explicitly specified, while `unionmount` *always* merges the
underlying filesystem and the filesystem published by the
mountee. Therefore, options like `--add`, `--remove`, `--underlying`
(specific to `unionfs`) make little sense in `unionmount`
context. These options have been removed. Also, `unionmount` must be
able to pass some switches to the mountee, which means that it
should stop parsing the command line arguments immediately after
having encountered the path to the mountee (very similar to how
`settrans` works). This functionality has also been implemented.
* **Make `unionmount` capable of starting the mountee.** *(28 May)*
The idea behind implementation of this goal is that `unionmount`
should provide a proxy node on which to set the mountee. The main
issue about this goal was the fact that the mountee *cannot* be
started during the initialization of `unionmount`, because in this
phase `unionmount` is not capable of responding to RPCs, while many
translators try to `io_stat` their underlying node or do other
interesting things on startup. The solution to this problem is,
obviously, *lazy* startup, i.e. the mountee is started at the first
attempt to access (via `dir_lookup` or `dir_readdir`) the merged
filesystem published by `unionmount`.
* **Include the filesystem published by the mountee in the list of
merged filesystems.** *(1 Jun)* `unionfs` operates on a list of
ports to the underlying filesystems, therefore, to finish the
unionmount functionality, I had to include the port to the mountee
in this list.
* **Learn Texinfo.** *(Jun 4)* In order to produce canonical
documentation I had to learn the Texinfo documentation format.
* **Write documentation for `unionmount`.** *(Jun 5)* The basic
unionmount functionality being finished, it has to be documented
properly, lest it should lag behind and remain unfinished
eventually.
* **Write documentation for `unionfs`.** *(Jun 5)* `unionfs` is not
exactly well-documented at the moment, the only help being provided
by the comments in the sources. The goal is to write a more coherent
documentation.
* **Start with a clean unionfs and implement the `--mount` argument**
*(11 Jun)* It was suggested to implement the union mount
functionality first, instead of doing some partial adaptation of
`unionfs` to `unionmount` and leaving the complete adaptation for
the future.
* **Compile GNU/Hurd from source to be able to study
eth-multiplexer.** *(16 Jun)* On my way to getting a working
instance of eth-multiplexer I learnt how I could compile GNU/Hurd in
a Debian GNU/Hurd system.
* **Setup the `devnode`--`eth-multiplexer`--`pfinet chain`.** *(30
Jun)* Due to the fact that I was trying to build everything using
`gcc-4.3`, I got strange behaviour of pfinet and spend a week trying
to figure out the reason.
* **Try to start the mountee during initialization of `unionfs`** *(4
Jul)* Initially the mountee was started at the first lookup. Now it
is started immediately after initialization of `unionmount`.
* **Fix the patches in ``--mount'' option series** *(5 Jul)* The
patches have been reviewed by **antrik**. I corrected them and
posted them to the ML for final reviews.
### TODO
(Dates in brackets show the *expected* completion date)
* **Orphan the mountee after starting it** *(7 Jul)* Orphaning the
mountee after starting it up seems to be a nice work-around for the
necessity of keeping a proxy node in unionmount in simple use-cases.
* **Read the relevant code of `devnode`, `eth-multiplexer`, and
`pfinet`.** *(10 Jul)* At the moment a part of `devnode`
functionality appears in `eth-multiplexer` and (probably) because of
this, `devnode` cannot use `eth-multiplexer`'s pseudo master device
port. I'll have to figure out why it happens like that.
* **Implement merging rules.** *(25 Jul)* I will have to make the
merging of the virtual filesystem published by `eth-multiplexer` and
the real filesystem containing static nodes possible.
* **Wrap up the project for upstream inclusion.** *(1 Aug)*
`unionmount` is intended to be included upstream, therefore it
should be mostly complete and polished by the end of GSoC.
* **Decide as to location of unionmount.** *(1 Aug)* Presently,
`unionmount` is a (local) branch in `unionfs` git repository. The
first step of publishing it is planned to be pushing it to the
Savannah `unionfs` repository. Some agree that there should also be
a second step consisting in splitting `unionmount` in a separate git
repository, since the destinations of `unionfs` and `unionmount` are
*similar*, and not identical.
* **Employ `unionmount` in eth-multiplexer.** *(10 Aug)* I still have
to scrounge for details.
* **Use a different (better?) implementation idea.** *(17 Aug)* It has
been pointed out several times that `unionmount` could be
implemented not by forking off `unionfs`, but by keeping the merging
functionality in a stand-alone module (which could then be used by
`unionfs` as well). Different implementation ideas with their own
specific advantages may also arise in the future.
---
# Google Summer of Code: 2008 Project: Namespace-based translator selection
---
## Current Task
Write the filesystem proxy for namespace-based translator selection (*nsmux*).
The code is at <http://github.com/scolobb/nsmux/tree/master>.
---
###Did this week
* Modified the node cache so that it maintains shadow nodes alive.
###Plans for the next week
* Implement the shutting down of translator stacks when *nsmux* is asked to go away (in case **antrik** considers that necessary).
* Make *nsmux* provide the access to the translator stack of the real node, in case a translator (mainly, a filter) should ask for its underlying node to be opened in O_NOTRANS mode.
---
###Current Status
####DONE:
* The skeleton which mirrors the filesystem.
* Provide proxy nodes (modify the standard version of netfs_S_dir_lookup).
####TODO:
* Create the generic filtering translator.
* Create the translator '0' (providing the untranslated version of the
node).
* Create the "recursive wrappers" for one-node translators.
* Create special translators for the main proxy so that its functionality
should be complete.
* Implement sharing of dynamic translator stacks where possible.
* Make dynamic translators go away as soon as they are not required.
* Refine the skeleton in several places so that it should become faster
and more reliable.
* Kill bugs.
* Integrate nsmux upstream.
* Solve the libtrivfs stacking issue.
* Patch libnetfs (it does not support file_get_translator_cntl, for
instance).
---
###Progress
####8: Fri Sep 19:
> Modified the ncache so that it now maintains shadow nodes (and directory nodes too, it is a side effect at the moment) alive.
####7: Sat Aug 30 - Fri Sep 5:
> Added the code for shutting down dynamic translator stacks.
####6: Mon Aug 4 - Fri Aug 29:
> Implemented the proxy nodes.
####5: Thu Jul 24 - Thu Jul 24:
> Created a *libnetfs*-based one-node translator, working exactly like the *libtrivfs*-based translator I had written before; the former, however, can be included in a translator stack.
####4: Tue Jul 22 - Thu Jul 24:
> Attempted to make a *libtrivfs*-based translator to be able to be stacked upon itself (to be able to receive a translator on top of itself, more exactly); attempted to borrow some code from *libnetfs* but this didn't bring any results.
####3: Sun Jul 20 - Tue Jul 22:
> Implemented the possibility to propagate a translator on all files belonging to a directory 'dir' in the request of the type 'dir,,x/'.
####2: Thu Jul 17 - Fri Jul 18:
> Extended the lookup code in *nsmux* to allow for looking up nodes like 'file,,x' and added the possibility to escape the double-comma in the following way: ',,,'.
####1: Mon Jul 12 - Tue Jul 13:
> Implemented a simple *libtrivfs*-based translator to test the lookup code for *nsmux*.
####0: Sat Jul 12 - Sat Jul 12:
> Made small changes to the code of *filterfs* to fit the needs of *nsmux*.
---
## Completed Tasks
####2: Sat May 3 - Fri Jul 17:
> Write a translator that should filter the contents of the directory it is set on according to some property. The property can be an arbitrary command.
> The code is at <http://github.com/scolobb/filterfs/tree/master>.
####1: Mon Apr 28 - Wed Apr 30:
> Wrote a Python extension module in C for retreiving the uptime. The module is based on the code of *w*.
####0: Sun Apr 27:
> Followed the code of *dmesgd* (<http://www.bddebian.com/junk/dmesgd/>) kindly offered by **bddebian** and rewrote it from scratch as a tutorial.
|