X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;f=daemon%2Fdaemon.h;h=001c7038d04b8f924decea316df199fbb52d9a51;hb=bb98bbb91c74cca47b5e1f79fd54f4024572fd22;hp=ca71265746170f7555fd38923578709670d63418;hpb=1765330e07a48dc6f7bdef7007f69ebe606fa731;p=libguestfs.git diff --git a/daemon/daemon.h b/daemon/daemon.h index ca71265..001c703 100644 --- a/daemon/daemon.h +++ b/daemon/daemon.h @@ -41,8 +41,15 @@ extern void free_strings (char **argv); extern void free_stringslen (char **argv, int len); extern int command (char **stdoutput, char **stderror, const char *name, ...); +extern int commandr (char **stdoutput, char **stderror, const char *name, ...); extern int commandv (char **stdoutput, char **stderror, char * const* const argv); +extern int commandrv (char **stdoutput, char **stderror, + char * const* const argv); + +extern int shell_quote (char *out, int len, const char *in); + +extern int verbose; /*-- in proto.c --*/ extern int proc_nr; @@ -61,20 +68,36 @@ extern guestfs_lvm_int_lv_list *parse_command_line_lvs (void); extern void main_loop (int sock); /* ordinary daemon functions use these to indicate errors */ -extern void reply_with_error (const char *fs, ...); -extern void reply_with_perror (const char *fs, ...); +extern void reply_with_error (const char *fs, ...) + __attribute__((format (printf,1,2))); +extern void reply_with_perror (const char *fs, ...) + __attribute__((format (printf,1,2))); + +/* daemon functions that receive files (FileIn) should call + * receive_file for each FileIn parameter. + */ +typedef int (*receive_cb) (void *opaque, const void *buf, int len); +extern int receive_file (receive_cb cb, void *opaque); + +/* daemon functions that receive files (FileIn) can call this + * to cancel incoming transfers (eg. if there is a local error), + * but they MUST then call reply_with_error or reply_with_perror. + */ +extern void cancel_receive (void); /* daemon functions that return files (FileOut) should call - * reply, then send_file for each FileOut parameter. + * reply, then send_file_* for each FileOut parameter. + * Note max write size if GUESTFS_MAX_CHUNK_SIZE. */ -#if 0 -extern void send_file (); -#endif +extern int send_file_write (const void *buf, int len); +extern void send_file_end (int cancel); /* only call this if there is a FileOut parameter */ extern void reply (xdrproc_t xdrp, char *ret); -/* Helper for functions that need a root filesystem mounted. */ +/* Helper for functions that need a root filesystem mounted. + * NB. Cannot be used for FileIn functions. + */ #define NEED_ROOT(errcode) \ do { \ if (!root_mounted) { \ @@ -84,7 +107,9 @@ extern void reply (xdrproc_t xdrp, char *ret); } \ while (0) -/* Helper for functions that need an argument ("path") that is absolute. */ +/* Helper for functions that need an argument ("path") that is absolute. + * NB. Cannot be used for FileIn functions. + */ #define ABS_PATH(path,errcode) \ do { \ if ((path)[0] != '/') { \ @@ -93,7 +118,9 @@ extern void reply (xdrproc_t xdrp, char *ret); } \ } while (0) -/* Helper for functions that need an argument ("path") that is a device. */ +/* Helper for functions that need an argument ("path") that is a device. + * NB. Cannot be used for FileIn functions. + */ #define IS_DEVICE(path,errcode) \ do { \ struct stat statbuf; \ @@ -107,6 +134,20 @@ extern void reply (xdrproc_t xdrp, char *ret); } \ } while (0) +/* Helper for functions which need either an absolute path in the + * mounted filesystem, OR a /dev/ device which exists. + * NB. Cannot be used for FileIn functions. + */ +#define NEED_ROOT_OR_IS_DEVICE(path,errcode) \ + do { \ + if (strncmp ((path), "/dev/", 5) == 0) \ + IS_DEVICE ((path),(errcode)); \ + else { \ + NEED_ROOT ((errcode)); \ + ABS_PATH ((path),(errcode)); \ + } \ + } while (0) + /* NB: * (1) You must match CHROOT_IN and CHROOT_OUT even along error paths. * (2) You must not change directory! cwd must always be "/", otherwise @@ -118,7 +159,9 @@ extern void reply (xdrproc_t xdrp, char *ret); #define CHROOT_OUT \ do { int old_errno = errno; chroot ("."); errno = old_errno; } while (0) -/* Marks functions which are not implemented. */ +/* Marks functions which are not implemented. + * NB. Cannot be used for FileIn functions. + */ #define XXX_NOT_IMPL(errcode) \ do { \ reply_with_error ("%s: function not implemented", __func__); \