summaryrefslogtreecommitdiff
path: root/lib/sbuild/chroot/facet/custom.h
blob: 4363aa21319922e5a93247d22cd488a042f8da31 (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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
/* Copyright © 2005-2013  Roger Leigh <rleigh@debian.org>
 *
 * schroot is free software: you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * schroot 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.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see
 * <http://www.gnu.org/licenses/>.
 *
 *********************************************************************/

#ifndef SBUILD_CHROOT_FACET_CUSTOM_H
#define SBUILD_CHROOT_FACET_CUSTOM_H

#include <sbuild/chroot/chroot.h>
#include <sbuild/chroot/facet/facet.h>
#include <sbuild/chroot/facet/storage.h>

namespace sbuild
{
  namespace chroot
  {
    namespace facet
    {

      /**
       * A chroot stored with custom parameters.
       *
       * This chroot specifies no behaviour or policy.  It is entirely
       * configured using user options and setup scripts.  The intent is
       * to permit the prototyping of and experimentation with new chroot
       * types without requiring a "full" class definition and associated
       * infrastructural work.  It also makes schroot extensible without
       * requiring any C++ coding.
       */
      class custom : public facet,
                     public storage
      {
      public:
        /// Exception type.
        typedef chroot::error error;

        /// A shared_ptr to a chroot facet object.
        typedef std::shared_ptr<custom> ptr;

        /// A shared_ptr to a const chroot facet object.
        typedef std::shared_ptr<const custom> const_ptr;

      protected:
        /// The constructor.
        custom ();

        /// The copy constructor.
        custom (const custom& rhs);

        void
        set_chroot (chroot& chroot,
                    bool    copy);

        friend class chroot;

      public:
        /// The destructor.
        virtual ~custom ();

        virtual std::string const&
        get_name () const;

        /**
         * Create a chroot facet.
         *
         * @returns a shared_ptr to the new chroot facet.
         */
        static ptr
        create ();

        facet::ptr
        clone () const;

        /**
         * Enable or disable cloning of the chroot session.  This simply
         * creates or removes the chroot_facet_session_cloneable facet,
         * hence there is no companion get method.
         *
         * @param cloneable true if cloneable, false if not.
         */
        void
        set_session_cloneable (bool cloneable);

        /**
         * Enable or disable purging of the chroot session.  Note that
         * this is only usable if the chroot supports session cloning,
         * otherwise this does nothing.
         *
         * @param purgeable true if purgeable, false if not.
         */
        void
        set_session_purgeable (bool purgeable);

        /**
         * Get status of chroot session purging.
         *
         * @returns true if purgeable, false if not.
         */
        bool
        get_session_purgeable () const;

        /**
         * Enable or disable cloning of the source chroot.  This simply
         * creates or removes the chroot_facet_source_cloneable facet,
         * hence there is no companion get method.
         *
         * @param cloneable true if source cloneable, false if not.
         */
        void
        set_source_cloneable (bool cloneable);

        std::string
        get_path () const;

        virtual session_flags
        get_session_flags () const;

      protected:
        virtual void
        setup_lock (chroot::setup_type type,
                    bool               lock,
                    int                status);

        virtual void
        get_used_keys (string_list& used_keys) const;

        virtual void
        get_keyfile (keyfile& keyfile) const;

        virtual void
        set_keyfile (const keyfile& keyfile);

      private:
        bool purgeable;
      };

    }
  }
}

#endif /* SBUILD_CHROOT_FACET_CUSTOM_H */

/*
 * Local Variables:
 * mode:C++
 * End:
 */