aboutsummaryrefslogtreecommitdiff
path: root/src/libstore/fs-accessor.hh
blob: c825e84f2d70a5d357aed219752a884e2e133707 (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
#pragma once

#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;
        uint64_t fileSize = 0; // regular files only
        bool isExecutable = false; // 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;
};

}