Palacios Public Git Repository

To checkout Palacios execute

  git clone http://v3vee.org/palacios/palacios.web/palacios.git
This will give you the master branch. You probably want the devel branch or one of the release branches. To switch to the devel branch, simply execute
  cd palacios
  git checkout --track -b devel origin/devel
The other branches are similar.


Changes to stream interface to allow for flow control and error signaling
[palacios.git] / palacios / include / interfaces / vmm_stream.h
1 /*
2  * This file is part of the Palacios Virtual Machine Monitor developed
3  * by the V3VEE Project with funding from the United States National 
4  * Science Foundation and the Department of Energy.  
5  *
6  * The V3VEE Project is a joint project between Northwestern University
7  * and the University of New Mexico.  You can find out more at 
8  * http://www.v3vee.org
9  *
10  * Copyright (c) 2010, Peter Dinda (pdinda@northwestern.edu> 
11  * Copyright (c) 2010, The V3VEE Project <http://www.v3vee.org> 
12  * All rights reserved.
13  *
14  * Author: Peter Dinda <pdinda@northwestern.edu>
15  *
16  * This is free software.  You are permitted to use,
17  * redistribute, and modify it as specified in the file "V3VEE_LICENSE".
18  */
19
20
21 #ifndef __VMM_STREAM_H__
22 #define __VMM_STREAM_H__
23
24
25
26 struct v3_stream {
27     void * host_stream_data;
28     void * guest_stream_data;
29   // the semantics are:
30   // negative return = error
31   // zero return = would block
32   // otherwise = amount of data transfered
33     sint64_t (*input)(struct v3_stream * stream, uint8_t * buf, sint64_t len);
34 };
35
36
37 #ifdef __V3VEE__
38 #include <palacios/vmm.h>
39
40
41
42 /* VM Can be NULL */
43 struct v3_stream * v3_stream_open(struct v3_vm_info * vm, const char * name,
44                                   sint64_t (*input)(struct v3_stream * stream, uint8_t * buf, sint64_t len),
45                                   void * guest_stream_data);
46
47 // the semantics are:
48 // negative return = error
49 // zero return = would block
50 // otherwise = amount of data transfered
51 sint64_t  v3_stream_output(struct v3_stream * stream, uint8_t * buf, sint64_t len);
52
53 void v3_stream_close(struct v3_stream * stream);
54
55 #endif
56
57
58 struct v3_stream_hooks {
59     void *(*open)(struct v3_stream * stream, const char * name, void * host_vm_data);
60     sint64_t (*output)(struct v3_stream * stream, uint8_t * buf, sint64_t len);
61     void (*close)(struct v3_stream * stream);
62 };
63
64
65 void V3_Init_Stream(struct v3_stream_hooks * hooks);
66
67 #endif