Commit 1b866434 authored by Daniel Borkmann's avatar Daniel Borkmann Committed by David S. Miller
Browse files

net: sctp: introduce uapi header for sctp 



This patch introduces an UAPI header for the SCTP protocol,
so that we can facilitate the maintenance and development of
user land applications or libraries, in particular in terms
of header synchronization.

To not break compatibility, some fragments from lksctp-tools'
netinet/sctp.h have been carefully included, while taking care
that neither kernel nor user land breaks, so both compile fine
with this change (for lksctp-tools I tested with the old
netinet/sctp.h header and with a newly adapted one that includes
the uapi sctp header). lksctp-tools smoke test run through
successfully as well in both cases.

Suggested-by: default avatarNeil Horman <nhorman@tuxdriver.com>
Cc: Neil Horman <nhorman@tuxdriver.com>
Cc: Vlad Yasevich <vyasevich@gmail.com>
Signed-off-by: default avatarDaniel Borkmann <dborkman@redhat.com>
Signed-off-by: default avatarDavid S. Miller <davem@davemloft.net>
parent 3d4a1316

fs/dlm/lowcomms.c

+1 −1
Original line number Diff line number Diff line
@@ -52,8 +52,8 @@ 
#include <linux/mutex.h>

#include <linux/sctp.h>

#include <linux/slab.h>

#include <linux/sctp.h>

#include <net/sctp/sctp.h>

#include <net/sctp/user.h>

#include <net/ipv6.h>



#include "dlm_internal.h"

include/linux/sctp.h

+2 −4
Original line number Diff line number Diff line
@@ -53,7 +53,9 @@ 


#include <linux/in.h>		/* We need in_addr.  */

#include <linux/in6.h>		/* We need in6_addr.  */

#include <linux/skbuff.h>



#include <uapi/linux/sctp.h>



/* Section 3.1.  SCTP Common Header Format */

typedef struct sctphdr {
@@ -63,14 +65,10 @@ typedef struct sctphdr { 
	__le32 checksum;

} __packed sctp_sctphdr_t;



#ifdef __KERNEL__

#include <linux/skbuff.h>



static inline struct sctphdr *sctp_hdr(const struct sk_buff *skb)

{

	return (struct sctphdr *)skb_transport_header(skb);

}

#endif



/* Section 3.2.  Chunk Field Descriptions. */

typedef struct sctp_chunkhdr {

include/net/sctp/constants.h

+0 −1
Original line number Diff line number Diff line
@@ -49,7 +49,6 @@ 


#include <linux/sctp.h>

#include <linux/ipv6.h> /* For ipv6hdr. */

#include <net/sctp/user.h>

#include <net/tcp_states.h>  /* For TCP states used in sctp_sock_state_t */



/* Value used for stream negotiation. */

include/uapi/linux/Kbuild

+1 −0
Original line number Diff line number Diff line
@@ -331,6 +331,7 @@ header-y += rtnetlink.h 
header-y += scc.h

header-y += sched.h

header-y += screen_info.h

header-y += sctp.h

header-y += sdla.h

header-y += seccomp.h

header-y += securebits.h

include/net/sctp/user.h→include/uapi/linux/sctp.h

+74 −10
Original line number Diff line number Diff line
@@ -44,13 +44,15 @@ 
 *    Ryan Layer               <rmlayer@us.ibm.com>

 *    Ardelle Fan              <ardelle.fan@intel.com>

 *    Sridhar Samudrala        <sri@us.ibm.com>

 *    Inaky Perez-Gonzalez     <inaky.gonzalez@intel.com>

 *    Vlad Yasevich            <vladislav.yasevich@hp.com>

 *

 * Any bugs reported given to us we will try to fix... any fixes shared will

 * be incorporated into the next SCTP release.

 */



#ifndef __net_sctp_user_h__

#define __net_sctp_user_h__

#ifndef _UAPI_SCTP_H

#define _UAPI_SCTP_H



#include <linux/types.h>

#include <linux/socket.h>
@@ -168,14 +170,20 @@ enum sctp_sinfo_flags { 
	SCTP_EOF=MSG_FIN,    /* Initiate graceful shutdown process. */

};



typedef union {

	__u8   			raw;

	struct sctp_initmsg	init;

	struct sctp_sndrcvinfo	sndrcv;

} sctp_cmsg_data_t;



/* These are cmsg_types.  */

typedef enum sctp_cmsg_type {

	SCTP_INIT,              /* 5.2.1 SCTP Initiation Structure */

#define SCTP_INIT	SCTP_INIT

	SCTP_SNDRCV,            /* 5.2.2 SCTP Header Information Structure */

#define SCTP_SNDRCV	SCTP_SNDRCV

} sctp_cmsg_t;





/*

 * 5.3.1.1 SCTP_ASSOC_CHANGE

 *
@@ -345,6 +353,12 @@ struct sctp_pdapi_event { 


enum { SCTP_PARTIAL_DELIVERY_ABORTED=0, };



/*

 * 5.3.1.8.  SCTP_AUTHENTICATION_EVENT

 *

 *  When a receiver is using authentication this message will provide

 *  notifications regarding new keys being made active as well as errors.

 */

struct sctp_authkey_event {

	__u16 auth_type;

	__u16 auth_flags;
@@ -421,15 +435,23 @@ union sctp_notification { 
enum sctp_sn_type {

	SCTP_SN_TYPE_BASE     = (1<<15),

	SCTP_ASSOC_CHANGE,

#define SCTP_ASSOC_CHANGE		SCTP_ASSOC_CHANGE

	SCTP_PEER_ADDR_CHANGE,

#define SCTP_PEER_ADDR_CHANGE		SCTP_PEER_ADDR_CHANGE

	SCTP_SEND_FAILED,

#define SCTP_SEND_FAILED		SCTP_SEND_FAILED

	SCTP_REMOTE_ERROR,

#define SCTP_REMOTE_ERROR		SCTP_REMOTE_ERROR

	SCTP_SHUTDOWN_EVENT,

#define SCTP_SHUTDOWN_EVENT		SCTP_SHUTDOWN_EVENT

	SCTP_PARTIAL_DELIVERY_EVENT,

#define SCTP_PARTIAL_DELIVERY_EVENT	SCTP_PARTIAL_DELIVERY_EVENT

	SCTP_ADAPTATION_INDICATION,

#define SCTP_ADAPTATION_INDICATION	SCTP_ADAPTATION_INDICATION

	SCTP_AUTHENTICATION_EVENT,

#define SCTP_AUTHENTICATION_INDICATION	SCTP_AUTHENTICATION_EVENT

	SCTP_SENDER_DRY_EVENT,

#define SCTP_SENDER_DRY_EVENT		SCTP_SENDER_DRY_EVENT

};



/* Notification error codes used to fill up the error fields in some
@@ -504,6 +526,9 @@ struct sctp_prim { 
	struct sockaddr_storage ssp_addr;

} __attribute__((packed, aligned(4)));



/* For backward compatibility use, define the old name too */

#define sctp_setprim	sctp_prim



/*

 * 7.1.11 Set Adaptation Layer Indicator (SCTP_ADAPTATION_LAYER)

 *
@@ -565,11 +590,26 @@ struct sctp_authchunk { 
 * This option gets or sets the list of HMAC algorithms that the local

 * endpoint requires the peer to use.

 */

#ifndef __KERNEL__

/* This here is only used by user space as is. It might not be a good idea

 * to export/reveal the whole structure with reserved fields etc.

 */

enum {

	SCTP_AUTH_HMAC_ID_SHA1 = 1,

	SCTP_AUTH_HMAC_ID_SHA256 = 3,

};

#endif



struct sctp_hmacalgo {

	__u32		shmac_num_idents;

	__u16		shmac_idents[];

};



/* Sadly, user and kernel space have different names for

 * this structure member, so this is to not break anything.

 */

#define shmac_number_of_idents	shmac_num_idents



/*

 * 7.1.20.  Set a shared key (SCTP_AUTH_KEY)

 *
@@ -691,6 +731,24 @@ struct sctp_authchunks { 
	uint8_t		gauth_chunks[];

};



/* The broken spelling has been released already in lksctp-tools header,

 * so don't break anyone, now that it's fixed.

 */

#define guth_number_of_chunks	gauth_number_of_chunks



/* Association states.  */

enum sctp_sstat_state {

	SCTP_EMPTY                = 0,

	SCTP_CLOSED               = 1,

	SCTP_COOKIE_WAIT          = 2,

	SCTP_COOKIE_ECHOED        = 3,

	SCTP_ESTABLISHED          = 4,

	SCTP_SHUTDOWN_PENDING     = 5,

	SCTP_SHUTDOWN_SENT        = 6,

	SCTP_SHUTDOWN_RECEIVED    = 7,

	SCTP_SHUTDOWN_ACK_SENT    = 8,

};



/*

 * 8.2.6. Get the Current Identifiers of Associations

 *        (SCTP_GET_ASSOC_ID_LIST)
@@ -712,8 +770,13 @@ struct sctp_assoc_ids { 
struct sctp_getaddrs_old {

	sctp_assoc_t            assoc_id;

	int			addr_num;

#ifdef __KERNEL__

	struct sockaddr		__user *addrs;

#else

	struct sockaddr		*addrs;

#endif

};



struct sctp_getaddrs {

	sctp_assoc_t		assoc_id; /*input*/

	__u32			addr_num; /*output*/
@@ -779,4 +842,5 @@ struct sctp_paddrthlds { 
	__u16 spt_pathmaxrxt;

	__u16 spt_pathpfthld;

};

#endif /* __net_sctp_user_h__ */
 


#endif /* _UAPI_SCTP_H */

CRA Git | Maintained and supported by SUSTech CRA and CCSE