xref: /linux/include/net/phonet/pep.h (revision d524dac9279b6a41ffdf7ff7958c577f2e387db6)
1 /*
2  * File: pep.h
3  *
4  * Phonet Pipe End Point sockets definitions
5  *
6  * Copyright (C) 2008 Nokia Corporation.
7  *
8  * This program is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU General Public License
10  * version 2 as published by the Free Software Foundation.
11  *
12  * This program is distributed in the hope that it will be useful, but
13  * WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15  * General Public License for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * along with this program; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
20  * 02110-1301 USA
21  */
22 
23 #ifndef NET_PHONET_PEP_H
24 #define NET_PHONET_PEP_H
25 
26 struct pep_sock {
27 	struct pn_sock		pn_sk;
28 
29 	/* XXX: union-ify listening vs connected stuff ? */
30 	/* Listening socket stuff: */
31 	struct hlist_head	ackq;
32 	struct hlist_head	hlist;
33 
34 	/* Connected socket stuff: */
35 	struct sock		*listener;
36 	struct sk_buff_head	ctrlreq_queue;
37 #define PNPIPE_CTRLREQ_MAX	10
38 	atomic_t		tx_credits;
39 	int			ifindex;
40 	u16			peer_type;	/* peer type/subtype */
41 	u8			pipe_handle;
42 
43 	u8			rx_credits;
44 	u8			rx_fc;	/* RX flow control */
45 	u8			tx_fc;	/* TX flow control */
46 	u8			init_enable;	/* auto-enable at creation */
47 	u8			aligned;
48 #ifdef CONFIG_PHONET_PIPECTRLR
49 	u8			pipe_state;
50 	struct sockaddr_pn	remote_pep;
51 #endif
52 };
53 
54 static inline struct pep_sock *pep_sk(struct sock *sk)
55 {
56 	return (struct pep_sock *)sk;
57 }
58 
59 extern const struct proto_ops phonet_stream_ops;
60 
61 /* Pipe protocol definitions */
62 struct pnpipehdr {
63 	u8			utid; /* transaction ID */
64 	u8			message_id;
65 	u8			pipe_handle;
66 	union {
67 		u8		state_after_connect;	/* connect request */
68 		u8		state_after_reset;	/* reset request */
69 		u8		error_code;		/* any response */
70 		u8		pep_type;		/* status indication */
71 		u8		data[1];
72 	};
73 };
74 #define other_pep_type		data[1]
75 
76 static inline struct pnpipehdr *pnp_hdr(struct sk_buff *skb)
77 {
78 	return (struct pnpipehdr *)skb_transport_header(skb);
79 }
80 
81 #define MAX_PNPIPE_HEADER (MAX_PHONET_HEADER + 4)
82 
83 enum {
84 	PNS_PIPE_CREATE_REQ = 0x00,
85 	PNS_PIPE_CREATE_RESP,
86 	PNS_PIPE_REMOVE_REQ,
87 	PNS_PIPE_REMOVE_RESP,
88 
89 	PNS_PIPE_DATA = 0x20,
90 	PNS_PIPE_ALIGNED_DATA,
91 
92 	PNS_PEP_CONNECT_REQ = 0x40,
93 	PNS_PEP_CONNECT_RESP,
94 	PNS_PEP_DISCONNECT_REQ,
95 	PNS_PEP_DISCONNECT_RESP,
96 	PNS_PEP_RESET_REQ,
97 	PNS_PEP_RESET_RESP,
98 	PNS_PEP_ENABLE_REQ,
99 	PNS_PEP_ENABLE_RESP,
100 	PNS_PEP_CTRL_REQ,
101 	PNS_PEP_CTRL_RESP,
102 	PNS_PEP_DISABLE_REQ = 0x4C,
103 	PNS_PEP_DISABLE_RESP,
104 
105 	PNS_PEP_STATUS_IND = 0x60,
106 	PNS_PIPE_CREATED_IND,
107 	PNS_PIPE_RESET_IND = 0x63,
108 	PNS_PIPE_ENABLED_IND,
109 	PNS_PIPE_REDIRECTED_IND,
110 	PNS_PIPE_DISABLED_IND = 0x66,
111 };
112 
113 #define PN_PIPE_INVALID_HANDLE	0xff
114 #define PN_PEP_TYPE_COMMON	0x00
115 
116 /* Phonet pipe status indication */
117 enum {
118 	PN_PEP_IND_FLOW_CONTROL,
119 	PN_PEP_IND_ID_MCFC_GRANT_CREDITS,
120 };
121 
122 /* Phonet pipe error codes */
123 enum {
124 	PN_PIPE_NO_ERROR,
125 	PN_PIPE_ERR_INVALID_PARAM,
126 	PN_PIPE_ERR_INVALID_HANDLE,
127 	PN_PIPE_ERR_INVALID_CTRL_ID,
128 	PN_PIPE_ERR_NOT_ALLOWED,
129 	PN_PIPE_ERR_PEP_IN_USE,
130 	PN_PIPE_ERR_OVERLOAD,
131 	PN_PIPE_ERR_DEV_DISCONNECTED,
132 	PN_PIPE_ERR_TIMEOUT,
133 	PN_PIPE_ERR_ALL_PIPES_IN_USE,
134 	PN_PIPE_ERR_GENERAL,
135 	PN_PIPE_ERR_NOT_SUPPORTED,
136 };
137 
138 /* Phonet pipe states */
139 enum {
140 	PN_PIPE_DISABLE,
141 	PN_PIPE_ENABLE,
142 };
143 
144 /* Phonet pipe sub-block types */
145 enum {
146 	PN_PIPE_SB_CREATE_REQ_PEP_SUB_TYPE,
147 	PN_PIPE_SB_CONNECT_REQ_PEP_SUB_TYPE,
148 	PN_PIPE_SB_REDIRECT_REQ_PEP_SUB_TYPE,
149 	PN_PIPE_SB_NEGOTIATED_FC,
150 	PN_PIPE_SB_REQUIRED_FC_TX,
151 	PN_PIPE_SB_PREFERRED_FC_RX,
152 	PN_PIPE_SB_ALIGNED_DATA,
153 };
154 
155 /* Phonet pipe flow control models */
156 enum {
157 	PN_NO_FLOW_CONTROL,
158 	PN_LEGACY_FLOW_CONTROL,
159 	PN_ONE_CREDIT_FLOW_CONTROL,
160 	PN_MULTI_CREDIT_FLOW_CONTROL,
161 };
162 
163 #define pn_flow_safe(fc) ((fc) >> 1)
164 
165 /* Phonet pipe flow control states */
166 enum {
167 	PEP_IND_EMPTY,
168 	PEP_IND_BUSY,
169 	PEP_IND_READY,
170 };
171 
172 #ifdef CONFIG_PHONET_PIPECTRLR
173 #define PNS_PEP_CONNECT_UTID           0x02
174 #define PNS_PIPE_CREATED_IND_UTID      0x04
175 #define PNS_PIPE_ENABLE_UTID           0x0A
176 #define PNS_PIPE_ENABLED_IND_UTID      0x0C
177 #define PNS_PIPE_DISABLE_UTID          0x0F
178 #define PNS_PIPE_DISABLED_IND_UTID     0x11
179 #define PNS_PEP_DISCONNECT_UTID        0x06
180 
181 /* Used for tracking state of a pipe */
182 enum {
183 	PIPE_IDLE,
184 	PIPE_DISABLED,
185 	PIPE_ENABLED,
186 };
187 #endif /* CONFIG_PHONET_PIPECTRLR */
188 
189 #endif
190