include/net/ax25.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /*
   3  *      Declarations of AX.25 type objects.
   4  *
   5  *      Alan Cox (GW4PTS)       10/11/93
   6  */
   7 #ifndef _AX25_H
   8 #define _AX25_H
   9
  10 #include <linux/ax25.h>
  11 #include <linux/spinlock.h>
  12 #include <linux/timer.h>
  13 #include <linux/list.h>
  14 #include <linux/slab.h>
  15 #include <linux/refcount.h>
  16 #include <net/neighbour.h>
  17 #include <net/sock.h>
  18
  19 #define AX25_T1CLAMPLO                  1
  20 #define AX25_T1CLAMPHI                  (30 * HZ)
  21
  22 #define AX25_BPQ_HEADER_LEN             16
  23 #define AX25_KISS_HEADER_LEN            1
  24
  25 #define AX25_HEADER_LEN                 17
  26 #define AX25_ADDR_LEN                   7
  27 #define AX25_DIGI_HEADER_LEN            (AX25_MAX_DIGIS * AX25_ADDR_LEN)
  28 #define AX25_MAX_HEADER_LEN             (AX25_HEADER_LEN + AX25_DIGI_HEADER_LEN)
  29
  30 /* AX.25 Protocol IDs */
  31 #define AX25_P_ROSE                     0x01
  32 #define AX25_P_VJCOMP                   0x06    /* Compressed TCP/IP packet   */
  33                                                 /* Van Jacobsen (RFC 1144)    */
  34 #define AX25_P_VJUNCOMP                 0x07    /* Uncompressed TCP/IP packet */
  35                                                 /* Van Jacobsen (RFC 1144)    */
  36 #define AX25_P_SEGMENT                  0x08    /* Segmentation fragment      */
  37 #define AX25_P_TEXNET                   0xc3    /* TEXTNET datagram protocol  */
  38 #define AX25_P_LQ                       0xc4    /* Link Quality Protocol      */
  39 #define AX25_P_ATALK                    0xca    /* Appletalk                  */
  40 #define AX25_P_ATALK_ARP                0xcb    /* Appletalk ARP              */
  41 #define AX25_P_IP                       0xcc    /* ARPA Internet Protocol     */
  42 #define AX25_P_ARP                      0xcd    /* ARPA Address Resolution    */
  43 #define AX25_P_FLEXNET                  0xce    /* FlexNet                    */
  44 #define AX25_P_NETROM                   0xcf    /* NET/ROM                    */
  45 #define AX25_P_TEXT                     0xF0    /* No layer 3 protocol impl.  */
  46
  47 /* AX.25 Segment control values */
  48 #define AX25_SEG_REM                    0x7F
  49 #define AX25_SEG_FIRST                  0x80
  50
  51 #define AX25_CBIT                       0x80    /* Command/Response bit */
  52 #define AX25_EBIT                       0x01    /* HDLC Address Extension bit */
  53 #define AX25_HBIT                       0x80    /* Has been repeated bit */
  54
  55 #define AX25_SSSID_SPARE                0x60    /* Unused bits in SSID for standard AX.25 */
  56 #define AX25_ESSID_SPARE                0x20    /* Unused bits in SSID for extended AX.25 */
  57 #define AX25_DAMA_FLAG                  0x20    /* Well, it is *NOT* unused! (dl1bke 951121 */
  58
  59 #define AX25_COND_ACK_PENDING           0x01
  60 #define AX25_COND_REJECT                0x02
  61 #define AX25_COND_PEER_RX_BUSY          0x04
  62 #define AX25_COND_OWN_RX_BUSY           0x08
  63 #define AX25_COND_DAMA_MODE             0x10
  64
  65 #ifndef _LINUX_NETDEVICE_H
  66 #include <linux/netdevice.h>
  67 #endif
  68
  69 /* Upper sub-layer (LAPB) definitions */
  70
  71 /* Control field templates */
  72 #define AX25_I                  0x00    /* Information frames */
  73 #define AX25_S                  0x01    /* Supervisory frames */
  74 #define AX25_RR                 0x01    /* Receiver ready */
  75 #define AX25_RNR                0x05    /* Receiver not ready */
  76 #define AX25_REJ                0x09    /* Reject */
  77 #define AX25_U                  0x03    /* Unnumbered frames */
  78 #define AX25_SABM               0x2f    /* Set Asynchronous Balanced Mode */
  79 #define AX25_SABME              0x6f    /* Set Asynchronous Balanced Mode Extended */
  80 #define AX25_DISC               0x43    /* Disconnect */
  81 #define AX25_DM                 0x0f    /* Disconnected mode */
  82 #define AX25_UA                 0x63    /* Unnumbered acknowledge */
  83 #define AX25_FRMR               0x87    /* Frame reject */
  84 #define AX25_UI                 0x03    /* Unnumbered information */
  85 #define AX25_XID                0xaf    /* Exchange information */
  86 #define AX25_TEST               0xe3    /* Test */
  87
  88 #define AX25_PF                 0x10    /* Poll/final bit for standard AX.25 */
  89 #define AX25_EPF                0x01    /* Poll/final bit for extended AX.25 */
  90
  91 #define AX25_ILLEGAL            0x100   /* Impossible to be a real frame type */
  92
  93 #define AX25_POLLOFF            0
  94 #define AX25_POLLON             1
  95
  96 /* AX25 L2 C-bit */
  97 #define AX25_COMMAND            1
  98 #define AX25_RESPONSE           2
  99
 100 /* Define Link State constants. */
 101
 102 enum {
 103         AX25_STATE_0,                   /* Listening */
 104         AX25_STATE_1,                   /* SABM sent */
 105         AX25_STATE_2,                   /* DISC sent */
 106         AX25_STATE_3,                   /* Established */
 107         AX25_STATE_4                    /* Recovery */
 108 };
 109
 110 #define AX25_MODULUS            8       /*  Standard AX.25 modulus */
 111 #define AX25_EMODULUS           128     /*  Extended AX.25 modulus */
 112
 113 enum {
 114         AX25_PROTO_STD_SIMPLEX,
 115         AX25_PROTO_STD_DUPLEX,
 116 #ifdef CONFIG_AX25_DAMA_SLAVE
 117         AX25_PROTO_DAMA_SLAVE,
 118 #ifdef CONFIG_AX25_DAMA_MASTER
 119         AX25_PROTO_DAMA_MASTER,
 120 #define AX25_PROTO_MAX AX25_PROTO_DAMA_MASTER
 121 #endif
 122 #endif
 123         __AX25_PROTO_MAX,
 124         AX25_PROTO_MAX = __AX25_PROTO_MAX -1
 125 };
 126
 127 enum {
 128         AX25_VALUES_IPDEFMODE,  /* 0=DG 1=VC */
 129         AX25_VALUES_AXDEFMODE,  /* 0=Normal 1=Extended Seq Nos */
 130         AX25_VALUES_BACKOFF,    /* 0=None 1=Linear 2=Exponential */
 131         AX25_VALUES_CONMODE,    /* Allow connected modes - 0=No 1=no "PID text" 2=all PIDs */
 132         AX25_VALUES_WINDOW,     /* Default window size for standard AX.25 */
 133         AX25_VALUES_EWINDOW,    /* Default window size for extended AX.25 */
 134         AX25_VALUES_T1,         /* Default T1 timeout value */
 135         AX25_VALUES_T2,         /* Default T2 timeout value */
 136         AX25_VALUES_T3,         /* Default T3 timeout value */
 137         AX25_VALUES_IDLE,       /* Connected mode idle timer */
 138         AX25_VALUES_N2,         /* Default N2 value */
 139         AX25_VALUES_PACLEN,     /* AX.25 MTU */
 140         AX25_VALUES_PROTOCOL,   /* Std AX.25, DAMA Slave, DAMA Master */
 141         AX25_VALUES_DS_TIMEOUT, /* DAMA Slave timeout */
 142         AX25_MAX_VALUES         /* THIS MUST REMAIN THE LAST ENTRY OF THIS LIST */
 143 };
 144
 145 #define AX25_DEF_IPDEFMODE      0                       /* Datagram */
 146 #define AX25_DEF_AXDEFMODE      0                       /* Normal */
 147 #define AX25_DEF_BACKOFF        1                       /* Linear backoff */
 148 #define AX25_DEF_CONMODE        2                       /* Connected mode allowed */
 149 #define AX25_DEF_WINDOW         2                       /* Window=2 */
 150 #define AX25_DEF_EWINDOW        32                      /* Module-128 Window=32 */
 151 #define AX25_DEF_T1             10000                   /* T1=10s */
 152 #define AX25_DEF_T2             3000                    /* T2=3s  */
 153 #define AX25_DEF_T3             300000                  /* T3=300s */
 154 #define AX25_DEF_N2             10                      /* N2=10 */
 155 #define AX25_DEF_IDLE           0                       /* Idle=None */
 156 #define AX25_DEF_PACLEN         256                     /* Paclen=256 */
 157 #define AX25_DEF_PROTOCOL       AX25_PROTO_STD_SIMPLEX  /* Standard AX.25 */
 158 #define AX25_DEF_DS_TIMEOUT     180000                  /* DAMA timeout 3 minutes */
 159
 160 typedef struct ax25_uid_assoc {
 161         struct hlist_node       uid_node;
 162         refcount_t              refcount;
 163         kuid_t                  uid;
 164         ax25_address            call;
 165 } ax25_uid_assoc;
 166
 167 #define ax25_uid_for_each(__ax25, list) \
 168         hlist_for_each_entry(__ax25, list, uid_node)
 169
 170 #define ax25_uid_hold(ax25) \
 171         refcount_inc(&((ax25)->refcount))
 172
 173 static inline void ax25_uid_put(ax25_uid_assoc *assoc)
 174 {
 175         if (refcount_dec_and_test(&assoc->refcount)) {
 176                 kfree(assoc);
 177         }
 178 }
 179
 180 typedef struct {
 181         ax25_address            calls[AX25_MAX_DIGIS];
 182         unsigned char           repeated[AX25_MAX_DIGIS];
 183         unsigned char           ndigi;
 184         signed char             lastrepeat;
 185 } ax25_digi;
 186
 187 typedef struct ax25_route {
 188         struct ax25_route       *next;
 189         refcount_t              refcount;
 190         ax25_address            callsign;
 191         struct net_device       *dev;
 192         ax25_digi               *digipeat;
 193         char                    ip_mode;
 194 } ax25_route;
 195
 196 static inline void ax25_hold_route(ax25_route *ax25_rt)
 197 {
 198         refcount_inc(&ax25_rt->refcount);
 199 }
 200
 201 void __ax25_put_route(ax25_route *ax25_rt);
 202
 203 extern rwlock_t ax25_route_lock;
 204
 205 static inline void ax25_route_lock_use(void)
 206 {
 207         read_lock(&ax25_route_lock);
 208 }
 209
 210 static inline void ax25_route_lock_unuse(void)
 211 {
 212         read_unlock(&ax25_route_lock);
 213 }
 214
 215 static inline void ax25_put_route(ax25_route *ax25_rt)
 216 {
 217         if (refcount_dec_and_test(&ax25_rt->refcount))
 218                 __ax25_put_route(ax25_rt);
 219 }
 220
 221 typedef struct {
 222         char                    slave;                  /* slave_mode?   */
 223         struct timer_list       slave_timer;            /* timeout timer */
 224         unsigned short          slave_timeout;          /* when? */
 225 } ax25_dama_info;
 226
 227 struct ctl_table;
 228
 229 typedef struct ax25_dev {
 230         struct ax25_dev         *next;
 231         struct net_device       *dev;
 232         struct net_device       *forward;
 233         struct ctl_table_header *sysheader;
 234         int                     values[AX25_MAX_VALUES];
 235 #if defined(CONFIG_AX25_DAMA_SLAVE) || defined(CONFIG_AX25_DAMA_MASTER)
 236         ax25_dama_info          dama;
 237 #endif
 238 } ax25_dev;
 239
 240 typedef struct ax25_cb {
 241         struct hlist_node       ax25_node;
 242         ax25_address            source_addr, dest_addr;
 243         ax25_digi               *digipeat;
 244         ax25_dev                *ax25_dev;
 245         unsigned char           iamdigi;
 246         unsigned char           state, modulus, pidincl;
 247         unsigned short          vs, vr, va;
 248         unsigned char           condition, backoff;
 249         unsigned char           n2, n2count;
 250         struct timer_list       t1timer, t2timer, t3timer, idletimer;
 251         unsigned long           t1, t2, t3, idle, rtt;
 252         unsigned short          paclen, fragno, fraglen;
 253         struct sk_buff_head     write_queue;
 254         struct sk_buff_head     reseq_queue;
 255         struct sk_buff_head     ack_queue;
 256         struct sk_buff_head     frag_queue;
 257         unsigned char           window;
 258         struct timer_list       timer, dtimer;
 259         struct sock             *sk;            /* Backlink to socket */
 260         refcount_t              refcount;
 261 } ax25_cb;
 262
 263 struct ax25_sock {
 264         struct sock             sk;
 265         struct ax25_cb          *cb;
 266 };
 267
 268 static inline struct ax25_sock *ax25_sk(const struct sock *sk)
 269 {
 270         return (struct ax25_sock *) sk;
 271 }
 272
 273 static inline struct ax25_cb *sk_to_ax25(const struct sock *sk)
 274 {
 275         return ax25_sk(sk)->cb;
 276 }
 277
 278 #define ax25_for_each(__ax25, list) \
 279         hlist_for_each_entry(__ax25, list, ax25_node)
 280
 281 #define ax25_cb_hold(__ax25) \
 282         refcount_inc(&((__ax25)->refcount))
 283
 284 static __inline__ void ax25_cb_put(ax25_cb *ax25)
 285 {
 286         if (refcount_dec_and_test(&ax25->refcount)) {
 287                 kfree(ax25->digipeat);
 288                 kfree(ax25);
 289         }
 290 }
 291
 292 static inline __be16 ax25_type_trans(struct sk_buff *skb, struct net_device *dev)
 293 {
 294         skb->dev      = dev;
 295         skb_reset_mac_header(skb);
 296         skb->pkt_type = PACKET_HOST;
 297         return htons(ETH_P_AX25);
 298 }
 299
 300 /* af_ax25.c */
 301 extern struct hlist_head ax25_list;
 302 extern spinlock_t ax25_list_lock;
 303 void ax25_cb_add(ax25_cb *);
 304 struct sock *ax25_find_listener(ax25_address *, int, struct net_device *, int);
 305 struct sock *ax25_get_socket(ax25_address *, ax25_address *, int);
 306 ax25_cb *ax25_find_cb(ax25_address *, ax25_address *, ax25_digi *,
 307                       struct net_device *);
 308 void ax25_send_to_raw(ax25_address *, struct sk_buff *, int);
 309 void ax25_destroy_socket(ax25_cb *);
 310 ax25_cb * __must_check ax25_create_cb(void);
 311 void ax25_fillin_cb(ax25_cb *, ax25_dev *);
 312 struct sock *ax25_make_new(struct sock *, struct ax25_dev *);
 313
 314 /* ax25_addr.c */
 315 extern const ax25_address ax25_bcast;
 316 extern const ax25_address ax25_defaddr;
 317 extern const ax25_address null_ax25_address;
 318 char *ax2asc(char *buf, const ax25_address *);
 319 void asc2ax(ax25_address *addr, const char *callsign);
 320 int ax25cmp(const ax25_address *, const ax25_address *);
 321 int ax25digicmp(const ax25_digi *, const ax25_digi *);
 322 const unsigned char *ax25_addr_parse(const unsigned char *, int,
 323         ax25_address *, ax25_address *, ax25_digi *, int *, int *);
 324 int ax25_addr_build(unsigned char *, const ax25_address *,
 325                     const ax25_address *, const ax25_digi *, int, int);
 326 int ax25_addr_size(const ax25_digi *);
 327 void ax25_digi_invert(const ax25_digi *, ax25_digi *);
 328
 329 /* ax25_dev.c */
 330 extern ax25_dev *ax25_dev_list;
 331 extern spinlock_t ax25_dev_lock;
 332
 333 static inline ax25_dev *ax25_dev_ax25dev(struct net_device *dev)
 334 {
 335         return dev->ax25_ptr;
 336 }
 337
 338 ax25_dev *ax25_addr_ax25dev(ax25_address *);
 339 void ax25_dev_device_up(struct net_device *);
 340 void ax25_dev_device_down(struct net_device *);
 341 int ax25_fwd_ioctl(unsigned int, struct ax25_fwd_struct *);
 342 struct net_device *ax25_fwd_dev(struct net_device *);
 343 void ax25_dev_free(void);
 344
 345 /* ax25_ds_in.c */
 346 int ax25_ds_frame_in(ax25_cb *, struct sk_buff *, int);
 347
 348 /* ax25_ds_subr.c */
 349 void ax25_ds_nr_error_recovery(ax25_cb *);
 350 void ax25_ds_enquiry_response(ax25_cb *);
 351 void ax25_ds_establish_data_link(ax25_cb *);
 352 void ax25_dev_dama_off(ax25_dev *);
 353 void ax25_dama_on(ax25_cb *);
 354 void ax25_dama_off(ax25_cb *);
 355
 356 /* ax25_ds_timer.c */
 357 void ax25_ds_setup_timer(ax25_dev *);
 358 void ax25_ds_set_timer(ax25_dev *);
 359 void ax25_ds_del_timer(ax25_dev *);
 360 void ax25_ds_timer(ax25_cb *);
 361 void ax25_ds_t1_timeout(ax25_cb *);
 362 void ax25_ds_heartbeat_expiry(ax25_cb *);
 363 void ax25_ds_t3timer_expiry(ax25_cb *);
 364 void ax25_ds_idletimer_expiry(ax25_cb *);
 365
 366 /* ax25_iface.c */
 367
 368 struct ax25_protocol {
 369         struct ax25_protocol *next;
 370         unsigned int pid;
 371         int (*func)(struct sk_buff *, ax25_cb *);
 372 };
 373
 374 void ax25_register_pid(struct ax25_protocol *ap);
 375 void ax25_protocol_release(unsigned int);
 376
 377 struct ax25_linkfail {
 378         struct hlist_node lf_node;
 379         void (*func)(ax25_cb *, int);
 380 };
 381
 382 void ax25_linkfail_register(struct ax25_linkfail *lf);
 383 void ax25_linkfail_release(struct ax25_linkfail *lf);
 384 int __must_check ax25_listen_register(ax25_address *, struct net_device *);
 385 void ax25_listen_release(ax25_address *, struct net_device *);
 386 int(*ax25_protocol_function(unsigned int))(struct sk_buff *, ax25_cb *);
 387 int ax25_listen_mine(ax25_address *, struct net_device *);
 388 void ax25_link_failed(ax25_cb *, int);
 389 int ax25_protocol_is_registered(unsigned int);
 390
 391 /* ax25_in.c */
 392 int ax25_rx_iframe(ax25_cb *, struct sk_buff *);
 393 int ax25_kiss_rcv(struct sk_buff *, struct net_device *, struct packet_type *,
 394                   struct net_device *);
 395
 396 /* ax25_ip.c */
 397 netdev_tx_t ax25_ip_xmit(struct sk_buff *skb);
 398 extern const struct header_ops ax25_header_ops;
 399
 400 /* ax25_out.c */
 401 ax25_cb *ax25_send_frame(struct sk_buff *, int, ax25_address *, ax25_address *,
 402                          ax25_digi *, struct net_device *);
 403 void ax25_output(ax25_cb *, int, struct sk_buff *);
 404 void ax25_kick(ax25_cb *);
 405 void ax25_transmit_buffer(ax25_cb *, struct sk_buff *, int);
 406 void ax25_queue_xmit(struct sk_buff *skb, struct net_device *dev);
 407 int ax25_check_iframes_acked(ax25_cb *, unsigned short);
 408
 409 /* ax25_route.c */
 410 void ax25_rt_device_down(struct net_device *);
 411 int ax25_rt_ioctl(unsigned int, void __user *);
 412 extern const struct file_operations ax25_route_fops;
 413 ax25_route *ax25_get_route(ax25_address *addr, struct net_device *dev);
 414 int ax25_rt_autobind(ax25_cb *, ax25_address *);
 415 struct sk_buff *ax25_rt_build_path(struct sk_buff *, ax25_address *,
 416                                    ax25_address *, ax25_digi *);
 417 void ax25_rt_free(void);
 418
 419 /* ax25_std_in.c */
 420 int ax25_std_frame_in(ax25_cb *, struct sk_buff *, int);
 421
 422 /* ax25_std_subr.c */
 423 void ax25_std_nr_error_recovery(ax25_cb *);
 424 void ax25_std_establish_data_link(ax25_cb *);
 425 void ax25_std_transmit_enquiry(ax25_cb *);
 426 void ax25_std_enquiry_response(ax25_cb *);
 427 void ax25_std_timeout_response(ax25_cb *);
 428
 429 /* ax25_std_timer.c */
 430 void ax25_std_heartbeat_expiry(ax25_cb *);
 431 void ax25_std_t1timer_expiry(ax25_cb *);
 432 void ax25_std_t2timer_expiry(ax25_cb *);
 433 void ax25_std_t3timer_expiry(ax25_cb *);
 434 void ax25_std_idletimer_expiry(ax25_cb *);
 435
 436 /* ax25_subr.c */
 437 void ax25_clear_queues(ax25_cb *);
 438 void ax25_frames_acked(ax25_cb *, unsigned short);
 439 void ax25_requeue_frames(ax25_cb *);
 440 int ax25_validate_nr(ax25_cb *, unsigned short);
 441 int ax25_decode(ax25_cb *, struct sk_buff *, int *, int *, int *);
 442 void ax25_send_control(ax25_cb *, int, int, int);
 443 void ax25_return_dm(struct net_device *, ax25_address *, ax25_address *,
 444                     ax25_digi *);
 445 void ax25_calculate_t1(ax25_cb *);
 446 void ax25_calculate_rtt(ax25_cb *);
 447 void ax25_disconnect(ax25_cb *, int);
 448
 449 /* ax25_timer.c */
 450 void ax25_setup_timers(ax25_cb *);
 451 void ax25_start_heartbeat(ax25_cb *);
 452 void ax25_start_t1timer(ax25_cb *);
 453 void ax25_start_t2timer(ax25_cb *);
 454 void ax25_start_t3timer(ax25_cb *);
 455 void ax25_start_idletimer(ax25_cb *);
 456 void ax25_stop_heartbeat(ax25_cb *);
 457 void ax25_stop_t1timer(ax25_cb *);
 458 void ax25_stop_t2timer(ax25_cb *);
 459 void ax25_stop_t3timer(ax25_cb *);
 460 void ax25_stop_idletimer(ax25_cb *);
 461 int ax25_t1timer_running(ax25_cb *);
 462 unsigned long ax25_display_timer(struct timer_list *);
 463
 464 /* ax25_uid.c */
 465 extern int  ax25_uid_policy;
 466 ax25_uid_assoc *ax25_findbyuid(kuid_t);
 467 int __must_check ax25_uid_ioctl(int, struct sockaddr_ax25 *);
 468 extern const struct file_operations ax25_uid_fops;
 469 void ax25_uid_free(void);
 470
 471 /* sysctl_net_ax25.c */
 472 #ifdef CONFIG_SYSCTL
 473 int ax25_register_dev_sysctl(ax25_dev *ax25_dev);
 474 void ax25_unregister_dev_sysctl(ax25_dev *ax25_dev);
 475 #else
 476 static inline int ax25_register_dev_sysctl(ax25_dev *ax25_dev) { return 0; }
 477 static inline void ax25_unregister_dev_sysctl(ax25_dev *ax25_dev) {}
 478 #endif /* CONFIG_SYSCTL */
 479
 480 #endif