Statistics
| Branch: | Revision:

root / nbd.h @ c09015dd

History | View | Annotate | Download (2.8 kB)

1 75818250 ths
/*
2 7a5ca864 bellard
 *  Copyright (C) 2005  Anthony Liguori <anthony@codemonkey.ws>
3 7a5ca864 bellard
 *
4 7a5ca864 bellard
 *  Network Block Device
5 7a5ca864 bellard
 *
6 7a5ca864 bellard
 *  This program is free software; you can redistribute it and/or modify
7 7a5ca864 bellard
 *  it under the terms of the GNU General Public License as published by
8 7a5ca864 bellard
 *  the Free Software Foundation; under version 2 of the License.
9 7a5ca864 bellard
 *
10 7a5ca864 bellard
 *  This program is distributed in the hope that it will be useful,
11 7a5ca864 bellard
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
12 7a5ca864 bellard
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13 7a5ca864 bellard
 *  GNU General Public License for more details.
14 7a5ca864 bellard
 *
15 7a5ca864 bellard
 *  You should have received a copy of the GNU General Public License
16 8167ee88 Blue Swirl
 *  along with this program; if not, see <http://www.gnu.org/licenses/>.
17 75818250 ths
 */
18 7a5ca864 bellard
19 7a5ca864 bellard
#ifndef NBD_H
20 7a5ca864 bellard
#define NBD_H
21 7a5ca864 bellard
22 7a5ca864 bellard
#include <sys/types.h>
23 7a5ca864 bellard
24 5a61cb60 Stefan Weil
#include "qemu-common.h"
25 c12504ce Nick Thomas
26 75818250 ths
struct nbd_request {
27 c12504ce Nick Thomas
    uint32_t magic;
28 75818250 ths
    uint32_t type;
29 75818250 ths
    uint64_t handle;
30 75818250 ths
    uint64_t from;
31 75818250 ths
    uint32_t len;
32 541dc0d4 Stefan Weil
} QEMU_PACKED;
33 75818250 ths
34 75818250 ths
struct nbd_reply {
35 c12504ce Nick Thomas
    uint32_t magic;
36 75818250 ths
    uint32_t error;
37 75818250 ths
    uint64_t handle;
38 541dc0d4 Stefan Weil
} QEMU_PACKED;
39 75818250 ths
40 b90fb4b8 Paolo Bonzini
#define NBD_FLAG_HAS_FLAGS      (1 << 0)        /* Flags are there */
41 b90fb4b8 Paolo Bonzini
#define NBD_FLAG_READ_ONLY      (1 << 1)        /* Device is read-only */
42 bbb74edd Paolo Bonzini
#define NBD_FLAG_SEND_FLUSH     (1 << 2)        /* Send FLUSH */
43 bbb74edd Paolo Bonzini
#define NBD_FLAG_SEND_FUA       (1 << 3)        /* Send FUA (Force Unit Access) */
44 bbb74edd Paolo Bonzini
#define NBD_FLAG_ROTATIONAL     (1 << 4)        /* Use elevator algorithm - rotational media */
45 bbb74edd Paolo Bonzini
#define NBD_FLAG_SEND_TRIM      (1 << 5)        /* Send TRIM (discard) */
46 bbb74edd Paolo Bonzini
47 bbb74edd Paolo Bonzini
#define NBD_CMD_MASK_COMMAND        0x0000ffff
48 bbb74edd Paolo Bonzini
#define NBD_CMD_FLAG_FUA        (1 << 16)
49 b90fb4b8 Paolo Bonzini
50 75818250 ths
enum {
51 75818250 ths
    NBD_CMD_READ = 0,
52 75818250 ths
    NBD_CMD_WRITE = 1,
53 bbb74edd Paolo Bonzini
    NBD_CMD_DISC = 2,
54 bbb74edd Paolo Bonzini
    NBD_CMD_FLUSH = 3,
55 bbb74edd Paolo Bonzini
    NBD_CMD_TRIM = 4
56 75818250 ths
};
57 75818250 ths
58 1d45f8b5 Laurent Vivier
#define NBD_DEFAULT_PORT        10809
59 1d45f8b5 Laurent Vivier
60 3777b09f Paolo Bonzini
#define NBD_BUFFER_SIZE (1024*1024)
61 3777b09f Paolo Bonzini
62 75818250 ths
size_t nbd_wr_sync(int fd, void *buffer, size_t size, bool do_read);
63 75818250 ths
int tcp_socket_outgoing(const char *address, uint16_t port);
64 7a5ca864 bellard
int tcp_socket_incoming(const char *address, uint16_t port);
65 c12504ce Nick Thomas
int tcp_socket_outgoing_spec(const char *address_and_port);
66 c12504ce Nick Thomas
int tcp_socket_incoming_spec(const char *address_and_port);
67 cd831bd7 ths
int unix_socket_outgoing(const char *path);
68 cd831bd7 ths
int unix_socket_incoming(const char *path);
69 7a5ca864 bellard
70 1d45f8b5 Laurent Vivier
int nbd_receive_negotiate(int csock, const char *name, uint32_t *flags,
71 1d45f8b5 Laurent Vivier
                          off_t *size, size_t *blocksize);
72 b90fb4b8 Paolo Bonzini
int nbd_init(int fd, int csock, uint32_t flags, off_t size, size_t blocksize);
73 75818250 ths
int nbd_send_request(int csock, struct nbd_request *request);
74 75818250 ths
int nbd_receive_reply(int csock, struct nbd_reply *reply);
75 0a4eb864 Jes Sorensen
int nbd_client(int fd);
76 7a5ca864 bellard
int nbd_disconnect(int fd);
77 7a5ca864 bellard
78 af49bbbe Paolo Bonzini
typedef struct NBDExport NBDExport;
79 1743b515 Paolo Bonzini
typedef struct NBDClient NBDClient;
80 af49bbbe Paolo Bonzini
81 af49bbbe Paolo Bonzini
NBDExport *nbd_export_new(BlockDriverState *bs, off_t dev_offset,
82 af49bbbe Paolo Bonzini
                          off_t size, uint32_t nbdflags);
83 af49bbbe Paolo Bonzini
void nbd_export_close(NBDExport *exp);
84 1743b515 Paolo Bonzini
NBDClient *nbd_client_new(NBDExport *exp, int csock,
85 1743b515 Paolo Bonzini
                          void (*close)(NBDClient *));
86 af49bbbe Paolo Bonzini
87 7a5ca864 bellard
#endif