mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-23 17:30:02 +00:00
![Andy King](/assets/img/avatar_default.png)
Split the vSockets header into kernel and UAPI parts. The former gets the bits that used to be in __KERNEL__ guards, while the latter gets everything that is user-visible. Tested by compiling vsock (+transport) and a simple user-mode vSockets application. Reported-by: David Howells <dhowells@redhat.com> Acked-by: Dmitry Torokhov <dtor@vmware.com> Signed-off-by: Andy King <acking@vmware.com> Acked-by: David Howells <dhowells@redhat.com> Signed-off-by: David S. Miller <davem@davemloft.net>
156 lines
5.1 KiB
C
156 lines
5.1 KiB
C
/*
|
|
* VMware vSockets Driver
|
|
*
|
|
* Copyright (C) 2007-2013 VMware, Inc. All rights reserved.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License as published by the Free
|
|
* Software Foundation version 2 and no later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful, but WITHOUT
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|
|
* more details.
|
|
*/
|
|
|
|
#ifndef _UAPI_VM_SOCKETS_H
|
|
#define _UAPI_VM_SOCKETS_H
|
|
|
|
#include <linux/socket.h>
|
|
|
|
/* Option name for STREAM socket buffer size. Use as the option name in
|
|
* setsockopt(3) or getsockopt(3) to set or get an unsigned long long that
|
|
* specifies the size of the buffer underlying a vSockets STREAM socket.
|
|
* Value is clamped to the MIN and MAX.
|
|
*/
|
|
|
|
#define SO_VM_SOCKETS_BUFFER_SIZE 0
|
|
|
|
/* Option name for STREAM socket minimum buffer size. Use as the option name
|
|
* in setsockopt(3) or getsockopt(3) to set or get an unsigned long long that
|
|
* specifies the minimum size allowed for the buffer underlying a vSockets
|
|
* STREAM socket.
|
|
*/
|
|
|
|
#define SO_VM_SOCKETS_BUFFER_MIN_SIZE 1
|
|
|
|
/* Option name for STREAM socket maximum buffer size. Use as the option name
|
|
* in setsockopt(3) or getsockopt(3) to set or get an unsigned long long
|
|
* that specifies the maximum size allowed for the buffer underlying a
|
|
* vSockets STREAM socket.
|
|
*/
|
|
|
|
#define SO_VM_SOCKETS_BUFFER_MAX_SIZE 2
|
|
|
|
/* Option name for socket peer's host-specific VM ID. Use as the option name
|
|
* in getsockopt(3) to get a host-specific identifier for the peer endpoint's
|
|
* VM. The identifier is a signed integer.
|
|
* Only available for hypervisor endpoints.
|
|
*/
|
|
|
|
#define SO_VM_SOCKETS_PEER_HOST_VM_ID 3
|
|
|
|
/* Option name for determining if a socket is trusted. Use as the option name
|
|
* in getsockopt(3) to determine if a socket is trusted. The value is a
|
|
* signed integer.
|
|
*/
|
|
|
|
#define SO_VM_SOCKETS_TRUSTED 5
|
|
|
|
/* Option name for STREAM socket connection timeout. Use as the option name
|
|
* in setsockopt(3) or getsockopt(3) to set or get the connection
|
|
* timeout for a STREAM socket.
|
|
*/
|
|
|
|
#define SO_VM_SOCKETS_CONNECT_TIMEOUT 6
|
|
|
|
/* Option name for using non-blocking send/receive. Use as the option name
|
|
* for setsockopt(3) or getsockopt(3) to set or get the non-blocking
|
|
* transmit/receive flag for a STREAM socket. This flag determines whether
|
|
* send() and recv() can be called in non-blocking contexts for the given
|
|
* socket. The value is a signed integer.
|
|
*
|
|
* This option is only relevant to kernel endpoints, where descheduling the
|
|
* thread of execution is not allowed, for example, while holding a spinlock.
|
|
* It is not to be confused with conventional non-blocking socket operations.
|
|
*
|
|
* Only available for hypervisor endpoints.
|
|
*/
|
|
|
|
#define SO_VM_SOCKETS_NONBLOCK_TXRX 7
|
|
|
|
/* The vSocket equivalent of INADDR_ANY. This works for the svm_cid field of
|
|
* sockaddr_vm and indicates the context ID of the current endpoint.
|
|
*/
|
|
|
|
#define VMADDR_CID_ANY -1U
|
|
|
|
/* Bind to any available port. Works for the svm_port field of
|
|
* sockaddr_vm.
|
|
*/
|
|
|
|
#define VMADDR_PORT_ANY -1U
|
|
|
|
/* Use this as the destination CID in an address when referring to the
|
|
* hypervisor. VMCI relies on it being 0, but this would be useful for other
|
|
* transports too.
|
|
*/
|
|
|
|
#define VMADDR_CID_HYPERVISOR 0
|
|
|
|
/* This CID is specific to VMCI and can be considered reserved (even VMCI
|
|
* doesn't use it anymore, it's a legacy value from an older release).
|
|
*/
|
|
|
|
#define VMADDR_CID_RESERVED 1
|
|
|
|
/* Use this as the destination CID in an address when referring to the host
|
|
* (any process other than the hypervisor). VMCI relies on it being 2, but
|
|
* this would be useful for other transports too.
|
|
*/
|
|
|
|
#define VMADDR_CID_HOST 2
|
|
|
|
/* Invalid vSockets version. */
|
|
|
|
#define VM_SOCKETS_INVALID_VERSION -1U
|
|
|
|
/* The epoch (first) component of the vSockets version. A single byte
|
|
* representing the epoch component of the vSockets version.
|
|
*/
|
|
|
|
#define VM_SOCKETS_VERSION_EPOCH(_v) (((_v) & 0xFF000000) >> 24)
|
|
|
|
/* The major (second) component of the vSockets version. A single byte
|
|
* representing the major component of the vSockets version. Typically
|
|
* changes for every major release of a product.
|
|
*/
|
|
|
|
#define VM_SOCKETS_VERSION_MAJOR(_v) (((_v) & 0x00FF0000) >> 16)
|
|
|
|
/* The minor (third) component of the vSockets version. Two bytes representing
|
|
* the minor component of the vSockets version.
|
|
*/
|
|
|
|
#define VM_SOCKETS_VERSION_MINOR(_v) (((_v) & 0x0000FFFF))
|
|
|
|
/* Address structure for vSockets. The address family should be set to
|
|
* AF_VSOCK. The structure members should all align on their natural
|
|
* boundaries without resorting to compiler packing directives. The total size
|
|
* of this structure should be exactly the same as that of struct sockaddr.
|
|
*/
|
|
|
|
struct sockaddr_vm {
|
|
__kernel_sa_family_t svm_family;
|
|
unsigned short svm_reserved1;
|
|
unsigned int svm_port;
|
|
unsigned int svm_cid;
|
|
unsigned char svm_zero[sizeof(struct sockaddr) -
|
|
sizeof(sa_family_t) -
|
|
sizeof(unsigned short) -
|
|
sizeof(unsigned int) - sizeof(unsigned int)];
|
|
};
|
|
|
|
#define IOCTL_VM_SOCKETS_GET_LOCAL_CID _IO(7, 0xb9)
|
|
|
|
#endif /* _UAPI_VM_SOCKETS_H */
|