X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=src%2Fguestfs.h;h=f2e108b5f366ec283fa0466b4d03c8af037e293f;hp=1ed066e99e5272ae8af57ef2343d017c73f8ccb7;hb=3385d7a1bf6afb8508ce334c6231c35cbe2fbae0;hpb=94050e0344685b6916e21581e618ad3e85795008 diff --git a/src/guestfs.h b/src/guestfs.h index 1ed066e..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,13 +26,20 @@ #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); extern void guestfs_close (guestfs_h *g); /* Error handling. */ +extern const char *guestfs_last_error (guestfs_h *g); + typedef void (*guestfs_error_handler_cb) (guestfs_h *g, void *data, const char *msg); typedef void (*guestfs_abort_cb) (void); @@ -45,36 +52,57 @@ extern guestfs_abort_cb guestfs_get_out_of_memory_handler (guestfs_h *g); #include #include -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); typedef void (*guestfs_log_message_cb) (guestfs_h *g, void *data, char *buf, int len); typedef void (*guestfs_subprocess_quit_cb) (guestfs_h *g, void *data); typedef void (*guestfs_launch_done_cb) (guestfs_h *g, void *data); +extern void guestfs_set_send_callback (guestfs_h *g, guestfs_send_cb cb, void *opaque); extern void guestfs_set_reply_callback (guestfs_h *g, guestfs_reply_cb cb, void *opaque); extern void guestfs_set_log_message_callback (guestfs_h *g, guestfs_log_message_cb cb, void *opaque); 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, ...) + __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__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 -typedef void (*guestfs_handle_event_cb) (void *data, int watch, int fd, int events); -typedef int (*guestfs_add_handle_cb) (guestfs_h *g, int fd, int events, guestfs_handle_event_cb cb, void *data); -typedef int (*guestfs_remove_handle_cb) (guestfs_h *g, int watch); -typedef void (*guestfs_handle_timeout_cb) (void *data, int timer); -typedef int (*guestfs_add_timeout_cb) (guestfs_h *g, int interval, guestfs_handle_timeout_cb cb, void *data); -typedef int (*guestfs_remove_timeout_cb) (guestfs_h *g, int timer); -typedef void (*guestfs_main_loop_run_cb) (guestfs_h *g); -typedef void (*guestfs_main_loop_quit_cb) (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. + */ struct guestfs_main_loop { guestfs_add_handle_cb add_handle; guestfs_remove_handle_cb remove_handle; @@ -83,10 +111,16 @@ 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_main_loop *); -extern void guestfs_main_loop_run (void); -extern void guestfs_main_loop_quit (void); +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); +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_ */