~ubuntu-branches/ubuntu/saucy/lvm2/saucy

« back to all changes in this revision

Viewing changes to libdaemon/client/daemon-client.h

  • Committer: Package Import Robot
  • Author(s): Dmitrijs Ledkovs
  • Date: 2012-08-14 14:35:57 UTC
  • mfrom: (3.1.25 sid)
  • Revision ID: package-import@ubuntu.com-20120814143557-93aill2tp3kf3o30
Tags: 2.02.95-4ubuntu1
* Merge from Debian unstable, remaining changes:
  - debian/patches/avoid-dev-block.patch: Prefer any other device name over
    names in /dev/block/ since lvm.conf won't handle this.
  - debian/rules:
    - copy .po file to .pot file for Rosetta (Ubuntu specific).
  - debian/{dmsetup,lvm2}-udeb.install:
    - install initramfs and udev hooks in udebs (Debian bug 504341).
  - auto-start VGs as their PVs are discovered (Ubuntu specific):
    - add debian/tree/lvm2/lib/udev/rules.d/85-lvm2.rules: use watershed plus
      the sledgehammer of vgscan/vgchange to turn on VGs as they come online.
    - debian/tree/lvm2/usr/share/initramfs-tools/scripts/hooks/lvm2:
      - add 85-lvm2.rules to the list of udev rules to copy.
      - depend on udev.
    - debian/control:
      - add versioned Depend on watershed in lvm2 for udev rules.
      - add Depends on watershed-udeb in lvm2-udeb for udev rules.
      - add versioned Depend/Breaks on udev in dmsetup for udev rules.
      - add Depend on initramfs-tools in dmsetup so system is not potentially
        rendered unbootable by out-of-order dpkg configuration.
    - debian/rules:
      - do not install local-top scripts since Ubuntu mounts root using udev.
      - do not install init scripts for lvm2, since udev starts LVM.
    - debian/lvm2.postinst: handle missing lvm2 init script.
    - debian/tree/dmsetup/lib/udev/rules.d/60-persistent-storage-dm.rules:
      watch dm devices for changes with inotify
  - add mountroot failure hooks to help fix bad boots (Debian bug 468115):
    - debian/tree/lvm2/usr/share/initramfs-tools/scripts/init-premount/lvm2
  - remaining changes to upstream event manager packages (Debian bug 514706):
    - debian/rules:
      - enable dmeventd during configure.
    - debian/dmeventd.{8,manpages}: install dmeventd files.
  - rename debian/clvm.defaults to debian/clvm.default so it is installed
    correctly.
  - debian/control: add dmsetup-udeb to libdevmapper1.02.1-udeb recommends.
  - debian/rules: make sure dmsetup and lvm2 initramfs-tools scripts are
    executable.  When the Ubuntu-specific ones are added with a patch,
    they may lose their executable bit.
  - Add and install clvmd resource agent
  - Add dependency on libudev-dev to libdevmapper-dev so that the .pc file
    works.
  - debian/{clvmd.ra,clvm.init}:
    - create /run/lvm if it doesn't exist.
  - debian/clvm.init:
    - exit 3 if not running on status action.
  - Call dh_installman so that our dmeventd manpage actually gets installed
  - Install the missing fsadm manpage.

 * libdevmapper-dev:
  - move .so symlinks and pkgconfig files to multiarched locations.
  - mark libdevmapper-dev M-A: same

 * libdevmapper-event1.02.1:
  - Add Breaks: dmeventd (<< 2.02.95-4ubuntu1) due to debian symbol rename

 * debian/lvm2.{preinst,postinst,postrm}:
  - Implement removal of obsolete /etc/init.d/lvm2 conffile, which
    should not have been re-introduced in Quantal.

 * Dropped Changes, included in Debian:
  - Mostly included packages for upstream event manager (Debian bug 514706).
  - debian/patches/rules-subdir.patch: removed as reordering will cause
    build failure with dmeventd.
  - debian/patches/libdm-event-static.patch: removed as other static libs
    aren't being built anymore either.
  - Update symbols for libdevmapper-event.
  - Update libdevmapper-event, dmeventd descriptions to match Debian
    boilerplate.

 * Disappeared Changes:
  - Don't install documentation in udebs. No diff found, but no docs are
    installed into udebs either.

 * Resurected Changes:
  - corrected dropping the wrong init script. Now clvm.init is shipped
    and lvm2.init is dropped in favor of udev rules as per original
    intention (LP: #1037033).

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
/*
 
2
 * Copyright (C) 2011-2012 Red Hat, Inc.
 
3
 *
 
4
 * This file is part of LVM2.
 
5
 *
 
6
 * This copyrighted material is made available to anyone wishing to use,
 
7
 * modify, copy, or redistribute it subject to the terms and conditions
 
8
 * of the GNU Lesser General Public License v.2.1.
 
9
 *
 
10
 * You should have received a copy of the GNU Lesser General Public License
 
11
 * along with this program; if not, write to the Free Software Foundation,
 
12
 * Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
13
 */
 
14
 
 
15
#ifndef _LVM_DAEMON_COMMON_CLIENT_H
 
16
#define _LVM_DAEMON_COMMON_CLIENT_H
 
17
 
 
18
#include "libdevmapper.h"
 
19
 
 
20
typedef struct {
 
21
        int socket_fd; /* the fd we use to talk to the daemon */
 
22
        const char *protocol;
 
23
        int protocol_version;  /* version of the protocol the daemon uses */
 
24
        int error;
 
25
} daemon_handle;
 
26
 
 
27
typedef struct {
 
28
        const char *path; /* the binary of the daemon */
 
29
        const char *socket; /* path to the comms socket */
 
30
        unsigned autostart:1; /* start the daemon if not running? */
 
31
 
 
32
        /*
 
33
         * If the following are not NULL/0, an attempt to talk to a daemon which
 
34
         * uses a different protocol or version will fail.
 
35
         */
 
36
        const char *protocol;
 
37
        int protocol_version;
 
38
} daemon_info;
 
39
 
 
40
typedef struct {
 
41
        char *buffer;
 
42
        /*
 
43
         * The request looks like this:
 
44
         *    request = "id"
 
45
         *    arg_foo = "something"
 
46
         *    arg_bar = 3
 
47
         *    arg_wibble {
 
48
         *        something_special = "here"
 
49
         *        amount = 75
 
50
         *        knobs = [ "twiddle", "tweak" ]
 
51
         *    }
 
52
         */
 
53
        struct dm_config_tree *cft;
 
54
} daemon_request;
 
55
 
 
56
typedef struct {
 
57
        int error; /* 0 for success */
 
58
        char *buffer; /* textual reply */
 
59
        struct dm_config_tree *cft; /* parsed reply, if available */
 
60
} daemon_reply;
 
61
 
 
62
/*
 
63
 * Open the communication channel to the daemon. If the daemon is not running,
 
64
 * it may be autostarted based on the binary path provided in the info (this
 
65
 * will only happen if autostart is set to true). If the call fails for any
 
66
 * reason, daemon_handle_valid(h) for the response will return false. Otherwise,
 
67
 * the connection is good to start serving requests.
 
68
 */
 
69
daemon_handle daemon_open(daemon_info i);
 
70
 
 
71
/*
 
72
 * Send a request to the daemon, waiting for the reply. All communication with
 
73
 * the daemon is synchronous. The function handles the IO details and parses the
 
74
 * response, handling common error conditions. See "daemon_reply" for details.
 
75
 *
 
76
 * In case the request contains a non-NULL buffer pointer, this buffer is sent
 
77
 * *verbatim* to the server. In this case, the cft pointer may be NULL (but will
 
78
 * be ignored even if non-NULL). If the buffer is NULL, the cft is required to
 
79
 * be a valid pointer, and is used to build up the request.
 
80
 */
 
81
daemon_reply daemon_send(daemon_handle h, daemon_request r);
 
82
 
 
83
/*
 
84
 * A simple interface to daemon_send. This function just takes the command id
 
85
 * and possibly a list of parameters (of the form "name = %?", "value"). The
 
86
 * type (string, integer) of the value is indicated by a character substituted
 
87
 * for ? in %?: d for integer, s for string.
 
88
 */
 
89
daemon_reply daemon_send_simple(daemon_handle h, const char *id, ...);
 
90
 
 
91
void daemon_reply_destroy(daemon_reply r);
 
92
 
 
93
static inline int64_t daemon_reply_int(daemon_reply r, const char *path, int64_t def) {
 
94
        return dm_config_find_int64(r.cft->root, path, def);
 
95
}
 
96
 
 
97
static inline const char *daemon_reply_str(daemon_reply r, const char *path, const char *def) {
 
98
        return dm_config_find_str(r.cft->root, path, def);
 
99
}
 
100
 
 
101
 
 
102
/* Shut down the communication to the daemon. Compulsory. */
 
103
void daemon_close(daemon_handle h);
 
104
 
 
105
#endif