File: sbuild-chroot-facet-union.h

package info (click to toggle)
schroot 1.6.4-4
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 6,684 kB
  • sloc: cpp: 21,427; sh: 12,516; makefile: 829; ansic: 231; sed: 16
file content (201 lines) | stat: -rw-r--r-- 5,457 bytes parent folder | download
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
/* Copyright © 2008-2009  Jan-Marek Glogowski <glogow@fbihome.de>
 * Copyright © 2005-2009  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_UNION_H
#define SBUILD_CHROOT_FACET_UNION_H

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

namespace sbuild
{

  /**
   * Chroot support for filesystem union based sessions.
   *
   * A chroot may offer session support using a filesystem union like
   * aufs or unionfs.  A new union type may need to adapt the 10mount
   * or 05union script to properly populate the underlay and mount
   * directory.  The overlay directory and union setup is already
   * handled.
   */
  class chroot_facet_union : public chroot_facet
  {
  public:
    /// Error codes.
    enum error_code
      {
	UNION_TYPE_UNKNOWN, ///< Unknown filesystem union type.
	UNION_OVERLAY_ABS,  ///< Union overlay must have an absolute path.
	UNION_UNDERLAY_ABS  ///< Union underlay must have an absolute path.
      };

    /// Exception type.
    typedef custom_error<error_code> error;

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

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

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

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

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

    virtual chroot_facet::ptr
    clone () const;

    std::string const&
    get_name () const;

    /**
     * Get fs union configured state.
     *
     * @returns if fs union is configured
     */
    bool
    get_union_configured () const;

    /**
     * Get the filesystem union type.
     *
     * @see set_union_type
     * @returns the union filesytem type.
     */
    virtual std::string const&
    get_union_type () const;

    /**
     * Set the filesystem union type.
     *
     * Currently supported values are aufs, unionfs and none.
     *
     * @param union_type the filesystem type.
     **/
    virtual void
    set_union_type (std::string const& union_type);

    /**
     * Get the filesystem union mount options (branch configuration).
     *
     * @see set_union_mount_options
     * @returns the filesystem union branch configuration.
     */
    virtual std::string const&
    get_union_mount_options () const;

    /**
     * Set the filesystem union mount options (branch configuration).
     *
     * Normally a temporary directory is used as the writeable branch,
     * which is removed on session end. This allows the building of a
     * complex union which can merge multiple branches. The string has
     * to be constructed as expected by the filesystem union type and
     * is directly used as the mount '-o' option string.
     *
     * @param union_mount_options a union filesystem-specific branch
     * description
     **/
    virtual void
    set_union_mount_options (std::string const& union_mount_options);

    /**
     * Get the union overlay directory.
     *
     * @returns the writeable overlay directory.
     */
    virtual std::string const&
    get_union_overlay_directory () const;

    /**
     * Set the union overlay directory.
     *
     * @param directory the writeable overlay directory.
     */
    virtual void
    set_union_overlay_directory (std::string const& directory);

    /**
     * Get the union underlay directory.
     *
     * @returns the writeable underlay directory.
     */
    virtual std::string const&
    get_union_underlay_directory () const;

    /**
     * Set the union underlay directory.
     *
     * @param directory the writeable underlay directory.
     */
    virtual void
    set_union_underlay_directory (std::string const& directory);

    virtual void
    setup_env (chroot const& chroot,
	       environment&  env) const;

    virtual chroot::session_flags
    get_session_flags (chroot const& chroot) const;

    virtual void
    get_details (chroot const&  chroot,
		 format_detail& detail) const;

    virtual void
    get_keyfile (chroot const& chroot,
		 keyfile&      keyfile) const;

    virtual void
    set_keyfile (chroot&        chroot,
		 keyfile const& keyfile,
		 string_list&   used_keys);

  private:
    /// filesystem union type.
    std::string union_type;
    /// Union mount options (branch configuration).
    std::string union_mount_options;
    /// Union read-write overlay directory.
    std::string union_overlay_directory;
    /// Union read-only underlay directory.
    std::string union_underlay_directory;
  };

}

#endif /* SBUILD_CHROOT_FACET_UNION_H */

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