4 releases (breaking)
0.4.0 | Oct 7, 2022 |
---|---|
0.3.0 | Aug 3, 2022 |
0.2.0 | Mar 18, 2022 |
0.1.0 | Dec 15, 2021 |
#21 in #communicating
17KB
297 lines
panda-channels
A Rust library (with C bindings) for communicating with the hypervisor via hypercalls in a channel-like manner. Primarily intended for use with the guest plugin API.
C API Documentation
/**
* Initialize the channel library, should be run at the start of main() in your guest plu
*/
void hyperchannel_init(void);
/**
* Uninitialize the channel library, should be run at the end of main() in your guest plu
*/
void hyperchannel_uninit(void);
/**
* Read from a channel descriptor into a buffer
*
* Returns: the number of bytes read into the buffer.
*/
uintptr_t channel_read(uint32_t channel, uint8_t *out, uintptr_t out_len);
/**
* Write a buffer to a given channel descriptor
*/
void channel_write(uint32_t channel, const uint8_t *buf, uintptr_t buf_len);
/**
* Gets the main channel for a plugin of a given name
*
* Returns: the number of bytes read into the buffer, or -1 if the plugin wasn't found
*/
int32_t get_main_channel(const uint8_t *name, uintptr_t len);
/**
* Get a new channel not associated with any specific plugin
*
* Returns: the channel, or -1 if an error occurs
*/
int32_t get_new_channel(void);
Dependencies
~0.5–1.7MB
~22K SLoC