summaryrefslogtreecommitdiff
path: root/lib/sbuild/chroot/facet/source-clonable.h
blob: 471235e431dee62ee5d1888df0a2459a598d271f (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
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
/* 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_SOURCE_CLONABLE_H
#define SBUILD_CHROOT_FACET_SOURCE_CLONABLE_H

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

namespace sbuild
{
  namespace chroot
  {
    namespace facet
    {

      /**
       * Chroot support for creation of source chroots.
       *
       * A chroot may offer a "source" chroot in addition to its typical
       * session clone, to allow for maintenence of the source data.  This
       * facet can be used by any chroot wishing to provide such
       * functionality.
       */
      class source_clonable : public facet
      {
      public:
        /// A shared_ptr to a chroot facet object.
        typedef std::shared_ptr<source_clonable> ptr;

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

      private:
        /// The constructor.
        source_clonable ();

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

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

        virtual facet::ptr
        clone () const;

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

        /**
         * Clone a source chroot.
         *
         * @returns a source chroot.
         */
        virtual chroot::ptr
        clone_source () const;

        /**
         * Is cloning a source chroot automatically permitted?  Note that
         * this is merely a hint and does not prevent cloning.
         *
         * @returns a list of clone.
         */
        virtual bool
        get_source_clone () const;

        /**
         * Set if cloning a source chroot automatically is permitted.
         * Note that this is merely a hint and does not prevent cloning.
         *
         * @param clone true to automatically clone, otherwise false.
         */
        virtual void
        set_source_clone (bool clone);

        /**
         * Get the users allowed to access the source chroot.
         *
         * @returns a list of users.
         */
        virtual string_list const&
        get_source_users () const;

        /**
         * Set the users allowed to access the source chroot.
         *
         * @param users a list of users.
         */
        virtual void
        set_source_users (const string_list& users);

        /**
         * Get the groups allowed to access the source chroot.
         *
         * @returns a list of groups.
         */
        virtual string_list const&
        get_source_groups () const;

        /**
         * Set the groups allowed to access the source chroot.
         *
         * @param groups a list of groups.
         */
        virtual void
        set_source_groups (const string_list& groups);

        /**
         * Get the users allowed to access the source chroot as root.
         * Members of these users can switch to root without
         * authenticating themselves.
         *
         * @returns a list of users.
         */
        virtual string_list const&
        get_source_root_users () const;

        /**
         * Set the users allowed to access the source chroot as root.
         * Members of these users can switch to root without
         * authenticating themselves.
         *
         * @param users a list of users.
         */
        virtual void
        set_source_root_users (const string_list& users);

        /**
         * Get the groups allowed to access the source chroot as root.
         * Members of these groups can switch to root without
         * authenticating themselves.
         *
         * @returns a list of groups.
         */
        virtual string_list const&
        get_source_root_groups () const;

        /**
         * Set the groups allowed to access the source chroot as root.
         * Members of these groups can switch to root without
         * authenticating themselves.
         *
         * @param groups a list of groups.
         */
        virtual void
        set_source_root_groups (const string_list& groups);

        virtual session_flags
        get_session_flags () const;

        virtual void
        get_details (format_detail& detail) const;

        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:
        /// Is source chroot cloning permitted?
        bool          source_clone;
        /// Users allowed to access the source chroot.
        string_list   source_users;
        /// Groups allowed to access the source chroot.
        string_list   source_groups;
        /// Users allowed to access the source chroot as root.
        string_list   source_root_users;
        /// Groups allowed to access the source chroot as root.
        string_list   source_root_groups;
      };

    }
  }
}

#endif /* SBUILD_CHROOT_FACET_SOURCE_CLONABLE_H */

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