aboutsummaryrefslogtreecommitdiff
path: root/src/libstore/fs-accessor.hh
blob: 1df19e647094f2efa1a01dec9780e76df7d171cd (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
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
#pragma once
///@file

#include "types.hh"

namespace nix {

/**
 * An abstract class for accessing a filesystem-like structure, such
 * as a (possibly remote) Nix store or the contents of a NAR file.
 */
class FSAccessor
{
public:
    enum Type { tMissing, tRegular, tSymlink, tDirectory };

    struct Stat
    {
        Type type = tMissing;
        /**
         * regular files only
         */
        uint64_t fileSize = 0;
        /**
         * regular files only
         */
        bool isExecutable = false; // regular files only
        /**
         * regular files only
         */
        uint64_t narOffset = 0; // regular files only
    };

    virtual ~FSAccessor() { }

    virtual Stat stat(const Path & path) = 0;

    virtual StringSet readDirectory(const Path & path) = 0;

    /**
     * Read a file inside the store.
     *
     * If `requireValidPath` is set to `true` (the default), the path must be
     * inside a valid store path, otherwise it just needs to be physically
     * present (but not necessarily properly registered)
     */
    virtual std::string readFile(const Path & path, bool requireValidPath = true) = 0;

    virtual std::string readLink(const Path & path) = 0;
};

}