linux-headers (unknown)

(root)/
include/
linux/
phonet.h
       1  /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
       2  /**
       3   * file phonet.h
       4   *
       5   * Phonet sockets kernel interface
       6   *
       7   * Copyright (C) 2008 Nokia Corporation. All rights reserved.
       8   *
       9   * This program is free software; you can redistribute it and/or
      10   * modify it under the terms of the GNU General Public License
      11   * version 2 as published by the Free Software Foundation.
      12   *
      13   * This program is distributed in the hope that it will be useful, but
      14   * WITHOUT ANY WARRANTY; without even the implied warranty of
      15   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
      16   * General Public License for more details.
      17   *
      18   * You should have received a copy of the GNU General Public License
      19   * along with this program; if not, write to the Free Software
      20   * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
      21   * 02110-1301 USA
      22   */
      23  
      24  #ifndef LINUX_PHONET_H
      25  #define LINUX_PHONET_H
      26  
      27  #include <linux/types.h>
      28  #include <linux/socket.h>
      29  
      30  /* Automatic protocol selection */
      31  #define PN_PROTO_TRANSPORT	0
      32  /* Phonet datagram socket */
      33  #define PN_PROTO_PHONET		1
      34  /* Phonet pipe */
      35  #define PN_PROTO_PIPE		2
      36  #define PHONET_NPROTO		3
      37  
      38  /* Socket options for SOL_PNPIPE level */
      39  #define PNPIPE_ENCAP		1
      40  #define PNPIPE_IFINDEX		2
      41  #define PNPIPE_HANDLE		3
      42  #define PNPIPE_INITSTATE	4
      43  
      44  #define PNADDR_ANY		0
      45  #define PNADDR_BROADCAST	0xFC
      46  #define PNPORT_RESOURCE_ROUTING	0
      47  
      48  /* Values for PNPIPE_ENCAP option */
      49  #define PNPIPE_ENCAP_NONE	0
      50  #define PNPIPE_ENCAP_IP		1
      51  
      52  /* ioctls */
      53  #define SIOCPNGETOBJECT		(SIOCPROTOPRIVATE + 0)
      54  #define SIOCPNENABLEPIPE	(SIOCPROTOPRIVATE + 13)
      55  #define SIOCPNADDRESOURCE	(SIOCPROTOPRIVATE + 14)
      56  #define SIOCPNDELRESOURCE	(SIOCPROTOPRIVATE + 15)
      57  
      58  /* Phonet protocol header */
      59  struct phonethdr {
      60  	__u8	pn_rdev;
      61  	__u8	pn_sdev;
      62  	__u8	pn_res;
      63  	__be16	pn_length;
      64  	__u8	pn_robj;
      65  	__u8	pn_sobj;
      66  } __attribute__((packed));
      67  
      68  /* Common Phonet payload header */
      69  struct phonetmsg {
      70  	__u8	pn_trans_id;	/* transaction ID */
      71  	__u8	pn_msg_id;	/* message type */
      72  	union {
      73  		struct {
      74  			__u8	pn_submsg_id;	/* message subtype */
      75  			__u8	pn_data[5];
      76  		} base;
      77  		struct {
      78  			__u16	pn_e_res_id;	/* extended resource ID */
      79  			__u8	pn_e_submsg_id;	/* message subtype */
      80  			__u8	pn_e_data[3];
      81  		} ext;
      82  	} pn_msg_u;
      83  };
      84  #define PN_COMMON_MESSAGE	0xF0
      85  #define PN_COMMGR		0x10
      86  #define PN_PREFIX		0xE0 /* resource for extended messages */
      87  #define pn_submsg_id		pn_msg_u.base.pn_submsg_id
      88  #define pn_e_submsg_id		pn_msg_u.ext.pn_e_submsg_id
      89  #define pn_e_res_id		pn_msg_u.ext.pn_e_res_id
      90  #define pn_data			pn_msg_u.base.pn_data
      91  #define pn_e_data		pn_msg_u.ext.pn_e_data
      92  
      93  /* data for unreachable errors */
      94  #define PN_COMM_SERVICE_NOT_IDENTIFIED_RESP	0x01
      95  #define PN_COMM_ISA_ENTITY_NOT_REACHABLE_RESP	0x14
      96  #define pn_orig_msg_id		pn_data[0]
      97  #define pn_status		pn_data[1]
      98  #define pn_e_orig_msg_id	pn_e_data[0]
      99  #define pn_e_status		pn_e_data[1]
     100  
     101  /* Phonet socket address structure */
     102  struct sockaddr_pn {
     103  	__kernel_sa_family_t spn_family;
     104  	__u8 spn_obj;
     105  	__u8 spn_dev;
     106  	__u8 spn_resource;
     107  	__u8 spn_zero[sizeof(struct sockaddr) - sizeof(__kernel_sa_family_t) - 3];
     108  } __attribute__((packed));
     109  
     110  /* Well known address */
     111  #define PN_DEV_PC	0x10
     112  
     113  static __inline__ __u16 pn_object(__u8 addr, __u16 port)
     114  {
     115  	return (addr << 8) | (port & 0x3ff);
     116  }
     117  
     118  static __inline__ __u8 pn_obj(__u16 handle)
     119  {
     120  	return handle & 0xff;
     121  }
     122  
     123  static __inline__ __u8 pn_dev(__u16 handle)
     124  {
     125  	return handle >> 8;
     126  }
     127  
     128  static __inline__ __u16 pn_port(__u16 handle)
     129  {
     130  	return handle & 0x3ff;
     131  }
     132  
     133  static __inline__ __u8 pn_addr(__u16 handle)
     134  {
     135  	return (handle >> 8) & 0xfc;
     136  }
     137  
     138  static __inline__ void pn_sockaddr_set_addr(struct sockaddr_pn *spn, __u8 addr)
     139  {
     140  	spn->spn_dev &= 0x03;
     141  	spn->spn_dev |= addr & 0xfc;
     142  }
     143  
     144  static __inline__ void pn_sockaddr_set_port(struct sockaddr_pn *spn, __u16 port)
     145  {
     146  	spn->spn_dev &= 0xfc;
     147  	spn->spn_dev |= (port >> 8) & 0x03;
     148  	spn->spn_obj = port & 0xff;
     149  }
     150  
     151  static __inline__ void pn_sockaddr_set_object(struct sockaddr_pn *spn,
     152  						__u16 handle)
     153  {
     154  	spn->spn_dev = pn_dev(handle);
     155  	spn->spn_obj = pn_obj(handle);
     156  }
     157  
     158  static __inline__ void pn_sockaddr_set_resource(struct sockaddr_pn *spn,
     159  						__u8 resource)
     160  {
     161  	spn->spn_resource = resource;
     162  }
     163  
     164  static __inline__ __u8 pn_sockaddr_get_addr(const struct sockaddr_pn *spn)
     165  {
     166  	return spn->spn_dev & 0xfc;
     167  }
     168  
     169  static __inline__ __u16 pn_sockaddr_get_port(const struct sockaddr_pn *spn)
     170  {
     171  	return ((spn->spn_dev & 0x03) << 8) | spn->spn_obj;
     172  }
     173  
     174  static __inline__ __u16 pn_sockaddr_get_object(const struct sockaddr_pn *spn)
     175  {
     176  	return pn_object(spn->spn_dev, spn->spn_obj);
     177  }
     178  
     179  static __inline__ __u8 pn_sockaddr_get_resource(const struct sockaddr_pn *spn)
     180  {
     181  	return spn->spn_resource;
     182  }
     183  
     184  /* Phonet device ioctl requests */
     185  
     186  #endif /* LINUX_PHONET_H */