netdev - Re: [PATCH 11/11] Phonet: kernel documentation

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite for Android: free password hash cracker in your pocket

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-Id: <20080923144320.fc1fc81c.randy.dunlap@oracle.com>
Date:	Tue, 23 Sep 2008 14:43:20 -0700
From:	Randy Dunlap <randy.dunlap@...cle.com>
To:	Rémi Denis-Courmont 
	<remi.denis-courmont@...ia.com>
Cc:	netdev@...r.kernel.org
Subject: Re: [PATCH 11/11] Phonet: kernel documentation

On Mon, 22 Sep 2008 18:47:25 +0300 Rémi Denis-Courmont wrote:

> Signed-off-by: Rémi Denis-Courmont <remi.denis-courmont@...ia.com>
> ---
>  Documentation/networking/phonet.txt |  111 +++++++++++++++++++++++++++++++++++
>  1 files changed, 111 insertions(+), 0 deletions(-)
>  create mode 100644 Documentation/networking/phonet.txt
> 
> diff --git a/Documentation/networking/phonet.txt b/Documentation/networking/phonet.txt
> new file mode 100644
> index 0000000..f3c72e0
> --- /dev/null
> +++ b/Documentation/networking/phonet.txt
> @@ -0,0 +1,111 @@
> +Linux Phonet protocol family
> +============================
> +
> +Introduction
> +------------
> +
> +Phonet is a packet protocol used by Nokia cellular modems for both IPC
> +and RPC. With the Linux Phonet socket family, Linux host processes can
> +receive and send messages from/to the modem, or any other external
> +device attached to the modem. The modem takes care of routing.
> +
> +Phonet packets can be exchanged through various hardware connections
> +depending on the device, such as:
> +  - USB with the CDC Phonet interface,
> +  - infrared,
> +  - Bluetooth,
> +  - an RS232 serial port (with a dedicated "FBUS" line discipline),
> +  - the SSI bus with some TI OMAP processors.
> +
> +
> +Packets format
> +--------------
> +
> +Phonet packet have a common header as follow:

          packets

> +
> +  struct phonethdr {
> +    uint8_t  pn_media;  /* Media type (link-layer identifier) */
> +    uint8_t  pn_rdev;   /* Receiver device ID */
> +    uint8_t  pn_sdev;   /* Sender device ID */
> +    uint8_t  pn_res;    /* Resource ID or function */
> +    uint16_t pn_length; /* Big-endian message byte length (minus 6) */
> +    uint8_t  pn_robj;   /* Receiver object ID */
> +    uint8_t  pn_sobj;   /* Sender object ID */
> +  };
> +
> +The device ID is split: the 6 higher order bits consitutes the device

                                 higher-order bits constitute

> +address, while the 2 lower order bits are used for multiplexing, as are

                        lower-order

> +the 8-bits object identifiers. As such, Phonet can be considered as a

       8-bit

> +network layer with 6 bits of address space and 10 bits for transport
> +protocol (much like port numbers in IP world).
> +
> +The modem always has address number zero. Each other device has a its

                                             All other devices have their
> +own 6-bits address.

   own 6-bit address.


---
~Randy
--
To unsubscribe from this list: send the line "unsubscribe netdev" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html