X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=src%2Fguestfs.h;h=f2e108b5f366ec283fa0466b4d03c8af037e293f;hp=39b2687d0f7794b3fd4faea0565b95228c2e3784;hb=3385d7a1bf6afb8508ce334c6231c35cbe2fbae0;hpb=42a8baf3c9abc6f742671f37e9e24b607e5f9857 diff --git a/src/guestfs.h b/src/guestfs.h index 39b2687..f2e108b 100644 --- a/src/guestfs.h +++ b/src/guestfs.h @@ -1,5 +1,5 @@ /* libguestfs - * Copyright (C) 2009 Red Hat Inc. + * Copyright (C) 2009 Red Hat Inc. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public @@ -26,7 +26,12 @@ #include +#ifdef __cplusplus +extern "C" { +#endif + typedef struct guestfs_h guestfs_h; +typedef struct guestfs_main_loop guestfs_main_loop; /* Connection management. */ extern guestfs_h *guestfs_create (void); @@ -47,12 +52,6 @@ extern guestfs_abort_cb guestfs_get_out_of_memory_handler (guestfs_h *g); #include #include -/* Free up return values. */ -extern void guestfs_free_int_bool (struct guestfs_int_bool *); -extern void guestfs_free_lvm_pv_list (struct guestfs_lvm_pv_list *); -extern void guestfs_free_lvm_vg_list (struct guestfs_lvm_vg_list *); -extern void guestfs_free_lvm_lv_list (struct guestfs_lvm_lv_list *); - /* Low-level event API. */ typedef void (*guestfs_send_cb) (guestfs_h *g, void *data); typedef void (*guestfs_reply_cb) (guestfs_h *g, void *data, XDR *xdr); @@ -66,33 +65,40 @@ extern void guestfs_set_log_message_callback (guestfs_h *g, guestfs_log_message_ extern void guestfs_set_subprocess_quit_callback (guestfs_h *g, guestfs_subprocess_quit_cb cb, void *opaque); extern void guestfs_set_launch_done_callback (guestfs_h *g, guestfs_launch_done_cb cb, void *opaque); -extern void guestfs_error (guestfs_h *g, const char *fs, ...); -extern void guestfs_perrorf (guestfs_h *g, const char *fs, ...); +extern void guestfs_error (guestfs_h *g, const char *fs, ...) + __attribute__((format (printf,2,3))); +extern void guestfs_perrorf (guestfs_h *g, const char *fs, ...) + __attribute__((format (printf,2,3))); extern void *guestfs_safe_malloc (guestfs_h *g, size_t nbytes); +extern void *guestfs_safe_calloc (guestfs_h *g, size_t n, size_t s); extern void *guestfs_safe_realloc (guestfs_h *g, void *ptr, int nbytes); extern char *guestfs_safe_strdup (guestfs_h *g, const char *str); extern void *guestfs_safe_memdup (guestfs_h *g, void *ptr, size_t size); -extern int guestfs__send (guestfs_h *g, int proc_nr, xdrproc_t xdrp, char *args); extern int guestfs__switch_to_sending (guestfs_h *g); extern int guestfs__switch_to_receiving (guestfs_h *g); +/* These *_sync calls wait until the action is performed, using the + * main loop. We should implement asynchronous versions too. + */ +extern int guestfs__send_sync (guestfs_h *g, int proc_nr, xdrproc_t xdrp, char *args); +extern int guestfs__send_file_sync (guestfs_h *g, const char *filename); +extern int guestfs__receive_file_sync (guestfs_h *g, const char *filename); + /* Main loop. */ #define GUESTFS_HANDLE_READABLE 0x1 #define GUESTFS_HANDLE_WRITABLE 0x2 #define GUESTFS_HANDLE_HANGUP 0x4 #define GUESTFS_HANDLE_ERROR 0x8 -struct guestfs_main_loop; - -typedef void (*guestfs_handle_event_cb) (struct guestfs_main_loop *ml, guestfs_h *g, void *data, int watch, int fd, int events); -typedef int (*guestfs_add_handle_cb) (struct guestfs_main_loop *ml, guestfs_h *g, int fd, int events, guestfs_handle_event_cb cb, void *data); -typedef int (*guestfs_remove_handle_cb) (struct guestfs_main_loop *ml, guestfs_h *g, int watch); -typedef void (*guestfs_handle_timeout_cb) (struct guestfs_main_loop *ml, guestfs_h *g, void *data, int timer); -typedef int (*guestfs_add_timeout_cb) (struct guestfs_main_loop *ml, guestfs_h *g, int interval, guestfs_handle_timeout_cb cb, void *data); -typedef int (*guestfs_remove_timeout_cb) (struct guestfs_main_loop *ml, guestfs_h *g, int timer); -typedef int (*guestfs_main_loop_run_cb) (struct guestfs_main_loop *ml, guestfs_h *g); -typedef int (*guestfs_main_loop_quit_cb) (struct guestfs_main_loop *ml, guestfs_h *g); +typedef void (*guestfs_handle_event_cb) (guestfs_main_loop *ml, guestfs_h *g, void *data, int watch, int fd, int events); +typedef int (*guestfs_add_handle_cb) (guestfs_main_loop *ml, guestfs_h *g, int fd, int events, guestfs_handle_event_cb cb, void *data); +typedef int (*guestfs_remove_handle_cb) (guestfs_main_loop *ml, guestfs_h *g, int watch); +typedef void (*guestfs_handle_timeout_cb) (guestfs_main_loop *ml, guestfs_h *g, void *data, int timer); +typedef int (*guestfs_add_timeout_cb) (guestfs_main_loop *ml, guestfs_h *g, int interval, guestfs_handle_timeout_cb cb, void *data); +typedef int (*guestfs_remove_timeout_cb) (guestfs_main_loop *ml, guestfs_h *g, int timer); +typedef int (*guestfs_main_loop_run_cb) (guestfs_main_loop *ml, guestfs_h *g); +typedef int (*guestfs_main_loop_quit_cb) (guestfs_main_loop *ml, guestfs_h *g); /* This is the head of the main loop structure. Concrete implementations * use additional private data after this struct. @@ -105,7 +111,6 @@ struct guestfs_main_loop { guestfs_main_loop_run_cb main_loop_run; guestfs_main_loop_quit_cb main_loop_quit; }; -typedef struct guestfs_main_loop guestfs_main_loop; extern void guestfs_set_main_loop (guestfs_h *handle, guestfs_main_loop *main_loop); extern guestfs_main_loop *guestfs_get_main_loop (guestfs_h *handle); @@ -114,4 +119,8 @@ extern guestfs_main_loop *guestfs_get_default_main_loop (void); extern guestfs_main_loop *guestfs_create_main_loop (void); extern void guestfs_free_main_loop (guestfs_main_loop *); +#ifdef __cplusplus +} +#endif + #endif /* GUESTFS_H_ */