aboutsummaryrefslogtreecommitdiff
#pragma once

#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);

struct ParseSink
{
    virtual void createDirectory(const Path & path) { };

    virtual void createRegularFile(const Path & path) { };
    virtual void isExecutable() { };
    virtual void preallocateContents(unsigned long long size) { };
    virtual void receiveContents(unsigned char * data, unsigned int len) { };

    virtual void createSymlink(const Path & path, const string & target) { };
};

void parseDump(ParseSink & sink, Source & source);

void restorePath(const Path & path, Source & source);

}
¨s 2022-08-25services: configuration: Change the value of the unset marker....Attila Lendvai 2022-08-25services: Use the new maybe/unset API....Attila Lendvai 2022-08-01services: configuration: Step back from *unspecified*....Maxim Cournoyer 2022-06-15services: configuration: Use *unspecified* instead of 'disabled....Attila Lendvai 2022-06-04services: bitlbee: Run under a UTF-8 locale....Ludovic Courtès 2022-05-16services: bitlbee: Run as user "bitlbee"....Ludovic Courtès 2022-05-02services: Make sure Shepherd destructors match constructors....Ludovic Courtès 2022-05-02services: bitlbee: Preserve 'PURPLE_PLUGIN_PATH'....Ludovic Courtès 2022-05-01services: quassel: Use 'least-authority-wrapper'....Ludovic Courtès 2022-05-01services: bitlbee: Use 'make-inetd-constructor'....Ludovic Courtès 2022-04-05services: messaging: Fix two copy-paste mistakes; avoid warnings....Attila Lendvai 2021-11-30services: Accept <inferior-package>s in lieu of <package>s....Tobias Geerinckx-Rice