blob: b4ed5d89569908ed5fb4407a2eb16ccecf43d4d0 [file] [log] [blame]
Andy Kingd021c342013-02-06 14:23:56 +00001/*
2 * VMware vSockets Driver
3 *
4 * Copyright (C) 2007-2013 VMware, Inc. All rights reserved.
5 *
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms of the GNU General Public License as published by the Free
8 * Software Foundation version 2 and no later version.
9 *
10 * This program is distributed in the hope that it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
13 * more details.
14 */
15
Andy Kingc031e232013-03-07 05:26:13 +000016#ifndef _UAPI_VM_SOCKETS_H
17#define _UAPI_VM_SOCKETS_H
Andy Kingd021c342013-02-06 14:23:56 +000018
Andy Kingc031e232013-03-07 05:26:13 +000019#include <linux/socket.h>
Andy Kingd021c342013-02-06 14:23:56 +000020
21/* Option name for STREAM socket buffer size. Use as the option name in
22 * setsockopt(3) or getsockopt(3) to set or get an unsigned long long that
23 * specifies the size of the buffer underlying a vSockets STREAM socket.
24 * Value is clamped to the MIN and MAX.
25 */
26
27#define SO_VM_SOCKETS_BUFFER_SIZE 0
28
29/* Option name for STREAM socket minimum buffer size. Use as the option name
30 * in setsockopt(3) or getsockopt(3) to set or get an unsigned long long that
31 * specifies the minimum size allowed for the buffer underlying a vSockets
32 * STREAM socket.
33 */
34
35#define SO_VM_SOCKETS_BUFFER_MIN_SIZE 1
36
37/* Option name for STREAM socket maximum buffer size. Use as the option name
38 * in setsockopt(3) or getsockopt(3) to set or get an unsigned long long
39 * that specifies the maximum size allowed for the buffer underlying a
40 * vSockets STREAM socket.
41 */
42
43#define SO_VM_SOCKETS_BUFFER_MAX_SIZE 2
44
45/* Option name for socket peer's host-specific VM ID. Use as the option name
46 * in getsockopt(3) to get a host-specific identifier for the peer endpoint's
47 * VM. The identifier is a signed integer.
48 * Only available for hypervisor endpoints.
49 */
50
51#define SO_VM_SOCKETS_PEER_HOST_VM_ID 3
52
Andy Kingd021c342013-02-06 14:23:56 +000053/* Option name for determining if a socket is trusted. Use as the option name
54 * in getsockopt(3) to determine if a socket is trusted. The value is a
55 * signed integer.
56 */
57
58#define SO_VM_SOCKETS_TRUSTED 5
59
60/* Option name for STREAM socket connection timeout. Use as the option name
61 * in setsockopt(3) or getsockopt(3) to set or get the connection
62 * timeout for a STREAM socket.
63 */
64
65#define SO_VM_SOCKETS_CONNECT_TIMEOUT 6
66
67/* Option name for using non-blocking send/receive. Use as the option name
68 * for setsockopt(3) or getsockopt(3) to set or get the non-blocking
69 * transmit/receive flag for a STREAM socket. This flag determines whether
70 * send() and recv() can be called in non-blocking contexts for the given
71 * socket. The value is a signed integer.
72 *
73 * This option is only relevant to kernel endpoints, where descheduling the
74 * thread of execution is not allowed, for example, while holding a spinlock.
75 * It is not to be confused with conventional non-blocking socket operations.
76 *
77 * Only available for hypervisor endpoints.
78 */
79
80#define SO_VM_SOCKETS_NONBLOCK_TXRX 7
81
82/* The vSocket equivalent of INADDR_ANY. This works for the svm_cid field of
83 * sockaddr_vm and indicates the context ID of the current endpoint.
84 */
85
86#define VMADDR_CID_ANY -1U
87
88/* Bind to any available port. Works for the svm_port field of
89 * sockaddr_vm.
90 */
91
92#define VMADDR_PORT_ANY -1U
93
94/* Use this as the destination CID in an address when referring to the
95 * hypervisor. VMCI relies on it being 0, but this would be useful for other
96 * transports too.
97 */
98
99#define VMADDR_CID_HYPERVISOR 0
100
101/* This CID is specific to VMCI and can be considered reserved (even VMCI
102 * doesn't use it anymore, it's a legacy value from an older release).
103 */
104
105#define VMADDR_CID_RESERVED 1
106
107/* Use this as the destination CID in an address when referring to the host
108 * (any process other than the hypervisor). VMCI relies on it being 2, but
109 * this would be useful for other transports too.
110 */
111
112#define VMADDR_CID_HOST 2
113
114/* Invalid vSockets version. */
115
116#define VM_SOCKETS_INVALID_VERSION -1U
117
118/* The epoch (first) component of the vSockets version. A single byte
119 * representing the epoch component of the vSockets version.
120 */
121
122#define VM_SOCKETS_VERSION_EPOCH(_v) (((_v) & 0xFF000000) >> 24)
123
124/* The major (second) component of the vSockets version. A single byte
125 * representing the major component of the vSockets version. Typically
126 * changes for every major release of a product.
127 */
128
129#define VM_SOCKETS_VERSION_MAJOR(_v) (((_v) & 0x00FF0000) >> 16)
130
131/* The minor (third) component of the vSockets version. Two bytes representing
132 * the minor component of the vSockets version.
133 */
134
135#define VM_SOCKETS_VERSION_MINOR(_v) (((_v) & 0x0000FFFF))
136
137/* Address structure for vSockets. The address family should be set to
Andy Kingc031e232013-03-07 05:26:13 +0000138 * AF_VSOCK. The structure members should all align on their natural
139 * boundaries without resorting to compiler packing directives. The total size
140 * of this structure should be exactly the same as that of struct sockaddr.
Andy Kingd021c342013-02-06 14:23:56 +0000141 */
142
143struct sockaddr_vm {
Andy Kingc031e232013-03-07 05:26:13 +0000144 __kernel_sa_family_t svm_family;
Andy Kingd021c342013-02-06 14:23:56 +0000145 unsigned short svm_reserved1;
146 unsigned int svm_port;
147 unsigned int svm_cid;
148 unsigned char svm_zero[sizeof(struct sockaddr) -
149 sizeof(sa_family_t) -
150 sizeof(unsigned short) -
151 sizeof(unsigned int) - sizeof(unsigned int)];
152};
153
154#define IOCTL_VM_SOCKETS_GET_LOCAL_CID _IO(7, 0xb9)
155
Andy Kingc031e232013-03-07 05:26:13 +0000156#endif /* _UAPI_VM_SOCKETS_H */