a3e6415ba8
from a source directory. All files for which a predicate function
returns true are copied to the store. Typical example is to leave
out the .svn directory:
stdenv.mkDerivation {
...
src = builtins.filterSource
(path: baseNameOf (toString path) != ".svn")
./source-dir;
# as opposed to
# src = ./source-dir;
}
This is important because the .svn directory influences the hash in
a rather unpredictable and variable way.
65 lines
1.4 KiB
C++
65 lines
1.4 KiB
C++
#ifndef __ARCHIVE_H
|
|
#define __ARCHIVE_H
|
|
|
|
#include "types.hh"
|
|
#include "serialise.hh"
|
|
|
|
|
|
namespace nix {
|
|
|
|
|
|
/* dumpPath creates a Nix archive of the specified path. The format
|
|
is as follows:
|
|
|
|
IF path points to a REGULAR FILE:
|
|
dump(path) = attrs(
|
|
[ ("type", "regular")
|
|
, ("contents", contents(path))
|
|
])
|
|
|
|
IF path points to a DIRECTORY:
|
|
dump(path) = attrs(
|
|
[ ("type", "directory")
|
|
, ("entries", concat(map(f, sort(entries(path)))))
|
|
])
|
|
where f(fn) = attrs(
|
|
[ ("name", fn)
|
|
, ("file", dump(path + "/" + fn))
|
|
])
|
|
|
|
where:
|
|
|
|
attrs(as) = concat(map(attr, as)) + encN(0)
|
|
attrs((a, b)) = encS(a) + encS(b)
|
|
|
|
encS(s) = encN(len(s)) + s + (padding until next 64-bit boundary)
|
|
|
|
encN(n) = 64-bit little-endian encoding of n.
|
|
|
|
contents(path) = the contents of a regular file.
|
|
|
|
sort(strings) = lexicographic sort by 8-bit value (strcmp).
|
|
|
|
entries(path) = the entries of a directory, without `.' and
|
|
`..'.
|
|
|
|
`+' denotes string concatenation. */
|
|
|
|
struct PathFilter
|
|
{
|
|
virtual ~PathFilter() { }
|
|
virtual bool operator () (const Path & path) { return true; }
|
|
};
|
|
|
|
extern PathFilter defaultPathFilter;
|
|
|
|
void dumpPath(const Path & path, Sink & sink,
|
|
PathFilter & filter = defaultPathFilter);
|
|
|
|
void restorePath(const Path & path, Source & source);
|
|
|
|
|
|
}
|
|
|
|
|
|
#endif /* !__ARCHIVE_H */
|