nnfs.html

来自「Non-Networked File System在几个非网络的（或慢网络的）U」· HTML 代码 · 共 1,569 行 · 第 1/2 页

CLASS="COMMAND"
>nnfs2</B
> <TT
CLASS="OPTION"
>--add-nickname</TT
> <TT
CLASS="REPLACEABLE"
><I
>hostname-yet-known-by-nnfs</I
></TT
></P
></LI
><LI
><P
>You answer: <B
CLASS="KEYCAP"
>c</B
> <B
CLASS="KEYCAP"
>return</B
> to continue the update</P
></LI
></UL
></P
></DIV
><DIV
CLASS="REFSECT2"
><A
NAME="AEN260"
></A
><H3
>Configuration</H3
><P
>The configuration file is <TT
CLASS="FILENAME"
>.nnfs/nnfsrc</TT
>,
it is created the first time you run <B
CLASS="COMMAND"
>nnfs2</B
>.
It is a hugely commented shell script you can edit.
It is a shell script to allow some default values
to be computed from the system.</P
><P
>If you find this configuration file too complex to edit,
you can use the <B
CLASS="COMMAND"
>nnfs2</B
> X11 interface to edit the file.
There is many tips to help you configure.</P
><P
>The more useful options are :
<P
></P
><UL
><LI
><P
><TT
CLASS="ENVAR"
>READ_MEDIUM</TT
> shell script called by <B
CLASS="COMMAND"
>nnfs2</B
> to read from the medium</P
></LI
><LI
><P
><TT
CLASS="ENVAR"
>WRITE_MEDIUM</TT
> shell script called by <B
CLASS="COMMAND"
>nnfs2</B
> to write on the medium</P
></LI
><LI
><P
><TT
CLASS="ENVAR"
>COMPRESS_FILTER</TT
> shell script filter called by <B
CLASS="COMMAND"
>nnfs2</B
> to compress</P
></LI
><LI
><P
><TT
CLASS="ENVAR"
>UNCOMPRESS_FILTER</TT
> shell script filter called by <B
CLASS="COMMAND"
>nnfs2</B
> to uncompress</P
></LI
><LI
><P
><TT
CLASS="ENVAR"
>MEDIUM_SIZE</TT
> size of the medium in bytes</P
></LI
><LI
><P
><TT
CLASS="ENVAR"
>OUTPUT_FILTER</TT
> indicate which files should not be mirrored</P
></LI
><LI
><P
><TT
CLASS="ENVAR"
>CONFIRMATION</TT
> choose which questions <B
CLASS="COMMAND"
>nnfs2</B
> will ask you</P
></LI
><LI
><P
><TT
CLASS="ENVAR"
>AUTO_START</TT
> if true, <B
CLASS="COMMAND"
>nnfs2</B
> X11 interface start update without user intervantion.</P
></LI
><LI
><P
><TT
CLASS="ENVAR"
>TMP_FILE</TT
> set this to <TT
CLASS="LITERAL"
>none</TT
> if you use <B
CLASS="COMMAND"
>nnfs2</B
> with a big medium</P
></LI
><LI
><P
><TT
CLASS="ENVAR"
>CROSS_MOUNT_POINT</TT
> if true <B
CLASS="COMMAND"
>nnfs2</B
> will synchronise all the files even if they are on several file systems. The default is false so the mount points are not crossed.</P
></LI
><LI
><P
><TT
CLASS="ENVAR"
>COPY_HARD_LINK</TT
> if true <B
CLASS="COMMAND"
>nnfs2</B
> will copy hard links as several files not hard linked, this is dangerous because an update can break the link, so the default is false and the hard linked files are not copied at all.</P
></LI
></UL
></P
><P
>The option hard to configure is <TT
CLASS="ENVAR"
>OUTPUT_FILTER</TT
>.
The default value is fine for me but certainly not for you.
The minimal filter must stop the copy of <B
CLASS="COMMAND"
>nnfs2</B
> history and all backup files.</P
><DIV
CLASS="EXAMPLE"
><A
NAME="AEN315"><P
><B
>Example 3. Required minimal filter</B
></P
><PRE
CLASS="SCREEN"
>-regex=~$
-regex=^\.nnfs/history/</PRE
></DIV
><P
>But, to run <B
CLASS="COMMAND"
>nnfs2</B
> you must be connected, and the connection
modify some file you don't want to copy on other hosts
because it is a security breach or it is a non-sense.
For example, any dot file in connection directory
ending by <TT
CLASS="LITERAL"
>history</TT
> or <TT
CLASS="LITERAL"
>authority</TT
> </P
><DIV
CLASS="EXAMPLE"
><A
NAME="AEN322"><P
><B
>Example 4. Filter files modified by the connection</B
></P
><PRE
CLASS="SCREEN"
>-regex=^\.[^/]*(history|authority)$</PRE
></DIV
><P
>If the medium is small, you need to filter the files that are
garbage as <TT
CLASS="LITERAL"
>core</TT
>, the executable files
or the results of compilation as <TT
CLASS="LITERAL"
>.o</TT
> files.
I assume here that executables biggers than 50k are not scripts
shell or perl.</P
><DIV
CLASS="EXAMPLE"
><A
NAME="AEN328"><P
><B
>Example 5. Filter garbage files</B
></P
><PRE
CLASS="SCREEN"
>-type=f size=+50k perm=+111
-regex=(\.(o|a|so|sl|aux|log|dvi|summary|old)|/(core|a\.out))$</PRE
></DIV
><P
>The big shell or perl script are filtered, if you don't want
this. Tell <B
CLASS="COMMAND"
>nnfs2</B
> to not filter them.</P
><DIV
CLASS="EXAMPLE"
><A
NAME="AEN333"><P
><B
>Example 6. Do not filter scripts</B
></P
><PRE
CLASS="SCREEN"
>+regex=\.(pl|sh|tcl)$
+regex=/configure$</PRE
></DIV
><DIV
CLASS="REFSECT3"
><A
NAME="AEN336"
></A
><H4
>Reference of the filter description</H4
><P
>Each line starts by <TT
CLASS="LITERAL"
>-</TT
> or <TT
CLASS="LITERAL"
>+</TT
>,
to remove or add to the file set the files verifying all the conditions
in the line.</P
><P
>The conditions are:
<P
></P
><UL
><LI
><P
><TT
CLASS="LITERAL"
>perm=+</TT
><TT
CLASS="REPLACEABLE"
><I
>xxx</I
></TT
>:
The condition is verified if any bit indicated in octal are in the
file mode. If you indicate <TT
CLASS="LITERAL"
>0111</TT
> the file mode  <TT
CLASS="LITERAL"
>0100</TT
>,  <TT
CLASS="LITERAL"
>0111</TT
>,  <TT
CLASS="LITERAL"
>0750</TT
> are
verified.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>perm=-</TT
><TT
CLASS="REPLACEABLE"
><I
>xxx</I
></TT
>:
The condition is verified if all the bits indicated in octal are in
the file mode. If you indicate <TT
CLASS="LITERAL"
>0111</TT
> the file mode <TT
CLASS="LITERAL"
>0755</TT
> is verified but
not <TT
CLASS="LITERAL"
>0750</TT
>.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>perm=</TT
><TT
CLASS="REPLACEABLE"
><I
>xxx</I
></TT
>:
The condition is verified if the file mode is exactly equal to the
value indicated in octal.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>size=+</TT
><TT
CLASS="REPLACEABLE"
><I
>xxx</I
></TT
>:
The condition is verified if the file size if bigger than the size
specified. A size in kilo-bytes may be specified as
<TT
CLASS="LITERAL"
>56k</TT
> and in mega-bytes as <TT
CLASS="LITERAL"
>2m</TT
></P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>size=-</TT
><TT
CLASS="REPLACEABLE"
><I
>xxx</I
></TT
>:
same as above, but the file size must be smaller. The two conditions
may appear on the same line.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>type=</TT
><TT
CLASS="REPLACEABLE"
><I
>dflp</I
></TT
>:
The type is regular file (<TT
CLASS="LITERAL"
>f</TT
>), directory
(<TT
CLASS="LITERAL"
>d</TT
>), FIFO (<TT
CLASS="LITERAL"
>p</TT
>) or symbolic link (<TT
CLASS="LITERAL"
>l</TT
>)</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>regex=</TT
><TT
CLASS="REPLACEABLE"
><I
>aregularexpression</I
></TT
>: If you want the expression to match the full name, add <TT
CLASS="LITERAL"
>^</TT
> at the begin and  <TT
CLASS="LITERAL"
>$</TT
> at the end.
This condition must be at the end of the line.</P
></LI
></UL
></P
></DIV
></DIV
><DIV
CLASS="REFSECT2"
><A
NAME="AEN386"
></A
><H3
>Synchronisation of <SPAN
CLASS="ACRONYM"
>UID</SPAN
> and <SPAN
CLASS="ACRONYM"
>GID</SPAN
></H3
><P
>If you want to synchonise the files with there <SPAN
CLASS="ACRONYM"
>UID</SPAN
>
and <SPAN
CLASS="ACRONYM"
>GID</SPAN
> you need to be <TT
CLASS="LITERAL"
>root</TT
> and to run
the <B
CLASS="COMMAND"
>rootnnfs2</B
>.</P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN395"
></A
><H2
>FILES</H2
><P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="FILENAME"
>~/.nnfs/nnfsrc</TT
></DT
><DD
><P
><B
CLASS="COMMAND"
>nnfs2</B
> configuration</P
></DD
><DT
><TT
CLASS="FILENAME"
>~/.nnfs/gtkrc</TT
></DT
><DD
><P
><B
CLASS="COMMAND"
>nnfs2</B
> GTK configuration</P
></DD
><DT
><TT
CLASS="FILENAME"
>~/.nnfs/history</TT
></DT
><DD
><P
>Directory where modified or deleted files are saved</P
></DD
><DT
><TT
CLASS="FILENAME"
>~/.nnfs/log~</TT
></DT
><DD
><P
>Some log about <B
CLASS="COMMAND"
>nnfs2</B
> last work</P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN421"
></A
><H2
>BUGS</H2
><P
>Limitations:
<P
></P
><UL
><LI
><P
>Directories must contains less than 65536 files (need to recompile).</P
></LI
><LI
><P
>Less than 16 hosts to synchronise (need to recompile).</P
></LI
><LI
><P
>No mirroring of 000 mode file (it is more a feature than a bug).</P
></LI
><LI
><P
>No mirroring of hard links (will not be corrected).</P
></LI
><LI
><P
>A file may be not mirrored if it is modified in the
 same second that <B
CLASS="COMMAND"
>nnfs2</B
> modify it (will not be corrected).</P
></LI
><LI
><P
>If A, B  and C are 3 hosts, B filter some files.
	  <B
CLASS="COMMAND"
>nnfs2</B
> runs on A, B, C,  A, B, C,  A, B, C,  A, B, C,   ...
	  The modified files on A are filtered by B and are not copied on C.
(very difficult to correct)</P
></LI
><LI
><P
>When adding an host to <B
CLASS="COMMAND"
>nnfs2</B
>, symbolics links are copied because
the <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>NNFS medium</I
></SPAN
> doesn't contain the content of the link.
The real problem is that you can't create a symbolic link
with all the good attributes (modification time, mode and on some systems <SPAN
CLASS="ACRONYM"
>UID</SPAN
>
and <SPAN
CLASS="ACRONYM"
>GID</SPAN
>). So it is impossible to fully mirror symbolic links</P
></LI
><LI
><P
>In <TT
CLASS="FILENAME"
>g_file.h</TT
> should use <TT
CLASS="LITERAL"
>off_t</TT
> in place of <TT
CLASS="LITERAL"
>long</TT
> but it doesn't compile on IRIX MIPS IP30 gcc. So files are limited to 2GB.</P
></LI
><LI
><P
> On Mac OS X the symbolic links are often copied because the
file system does not store modification date
of symbolic links.</P
></LI
><LI
><P
> On Mac OS X is <B
CLASS="COMMAND"
>nnfs2</B
> is unpredictable if only the case is different between two file names as with <TT
CLASS="LITERAL"
>README</TT
> and <TT
CLASS="LITERAL"
>Readme</TT
></P
></LI
></UL
></P
><P
>Bugs:
<P
></P
><UL
><LI
><P
> In some cases, the GTK progress bar go over 100%.</P
></LI
></UL
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN461"
></A
><H2
>NO WARRANTY</H2
><P
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.</I
></SPAN
></P
><P
>It is nearly impossible that <B
CLASS="COMMAND"
>nnfs2</B
> do an irrecoverable error.
In the worst case, <B
CLASS="COMMAND"
>nnfs2</B
> will stop.
The returned value (error) of all the system calls are verified and
the program tries to analyse the error.</P
><P
>The parameters of the more stressing test on <B
CLASS="COMMAND"
>nnfs2</B
> are the following:
<P
></P
><UL
><LI
><P
> 4 hosts</P
></LI
><LI
><P
> On each host a program create/delete/modify file/links/directories
  at the maximum speed.</P
></LI
><LI
><P
><B
CLASS="COMMAND"
>nnfs2</B
> runs continuously on each of the host randomly.
  So, while <B
CLASS="COMMAND"
>nnfs2</B
> runs, files are modified while it is reading/writing them.
  Or worstly, directories are deleted while <B
CLASS="COMMAND"
>nnfs2</B
> analyse the content,
  or files are created in directories that <B
CLASS="COMMAND"
>nnfs2</B
> tries to delete</P
></LI
></UL
>
Incredibly, <B
CLASS="COMMAND"
>nnfs2</B
> works in this case thousands of time
on a Linux 386 Debian host.</P
><P
><B
CLASS="COMMAND"
>nnfs2</B
> had been compiled and tested on HPPA 1.1 HPUX 10.20 and MIPS IP30 IRIX 6.5</P
><P
>On Mac OS X it does not work optimaly with symbolic links (see BUGS).</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN485"
></A
><H2
>SEE ALSO</H2
><P
></P
><TABLE
BORDER="0"
><TBODY
><TR
><TD
><SPAN
CLASS="CITEREFENTRY"
><SPAN
CLASS="REFENTRYTITLE"
><B
CLASS="COMMAND"
>gzip</B
></SPAN
>(1)</SPAN
></TD
></TR
><TR
><TD
><SPAN
CLASS="CITEREFENTRY"
><SPAN
CLASS="REFENTRYTITLE"
><B
CLASS="COMMAND"
>mcopy</B
></SPAN
>(1)</SPAN
></TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN498"
></A
><H2
>AUTHOR</H2
><P
>Author:
    Thierry EXCOFFIER,
Author Home Page:
<A
HREF="http://www710.univ-lyon1.fr/~exco"
TARGET="_top"
>http://www710.univ-lyon1.fr/~exco</A
></P
><P
><B
CLASS="COMMAND"
>nnfs2</B
> home page: <A
HREF="http://www710.univ-lyon1.fr/~exco/nnfs.html"
TARGET="_top"
>http://www710.univ-lyon1.fr/~exco/nnfs.html</A
>&#13;</P
></DIV
></BODY
></HTML
>