mirror of
https://git.proxmox.com/git/mirror_ubuntu-kernels.git
synced 2025-11-08 20:40:10 +00:00
72206cc730
n_gsm is based on the 3GPP 07.010 and its newer version is the 3GPP 27.010. See https://portal.3gpp.org/desktopmodules/Specifications/SpecificationDetails.aspx?specificationId=1516 The changes from 07.010 to 27.010 are non-functional. Therefore, I refer to the newer 27.010 here. Chapters 5.4.6.3.4 and 5.1.8.1.3 describe the test command which can be used to test the mux connection between both sides. Currently, no algorithm is implemented to make use of this command. This requires that each multiplexed upper layer protocol supervises the underlying muxer connection to handle possible connection losses. Introduce ioctl commands and functions to optionally enable keep alive handling via the test command as described in chapter 5.4.6.3.4. A single incrementing octet "ka_num" is being used for unique identification of each single keep alive packet. Retries will use the same "ka_num" value as the original packet. Retry count and interval are taken from the general parameters N2 and T2. Add usage description and basic example for the new ioctl to the n_gsm documentation. Note that support for the test command is mandatory and already present in the muxer implementation since the very first version. Also note that the previous ioctl structure gsm_config cannot be extended due to missing checks against zero of the field "unused". Signed-off-by: Daniel Starke <daniel.starke@siemens.com> Link: https://lore.kernel.org/r/20230214122737.1976-1-daniel.starke@siemens.com Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
53 lines
1.4 KiB
C
53 lines
1.4 KiB
C
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
|
|
#ifndef _LINUX_GSMMUX_H
|
|
#define _LINUX_GSMMUX_H
|
|
|
|
#include <linux/if.h>
|
|
#include <linux/ioctl.h>
|
|
#include <linux/types.h>
|
|
|
|
struct gsm_config
|
|
{
|
|
unsigned int adaption;
|
|
unsigned int encapsulation;
|
|
unsigned int initiator;
|
|
unsigned int t1;
|
|
unsigned int t2;
|
|
unsigned int t3;
|
|
unsigned int n2;
|
|
unsigned int mru;
|
|
unsigned int mtu;
|
|
unsigned int k;
|
|
unsigned int i;
|
|
unsigned int unused[8]; /* Can not be used */
|
|
};
|
|
|
|
#define GSMIOC_GETCONF _IOR('G', 0, struct gsm_config)
|
|
#define GSMIOC_SETCONF _IOW('G', 1, struct gsm_config)
|
|
|
|
struct gsm_netconfig {
|
|
unsigned int adaption; /* Adaption to use in network mode */
|
|
unsigned short protocol;/* Protocol to use - only ETH_P_IP supported */
|
|
unsigned short unused2; /* Can not be used */
|
|
char if_name[IFNAMSIZ]; /* interface name format string */
|
|
__u8 unused[28]; /* Can not be used */
|
|
};
|
|
|
|
#define GSMIOC_ENABLE_NET _IOW('G', 2, struct gsm_netconfig)
|
|
#define GSMIOC_DISABLE_NET _IO('G', 3)
|
|
|
|
/* get the base tty number for a configured gsmmux tty */
|
|
#define GSMIOC_GETFIRST _IOR('G', 4, __u32)
|
|
|
|
struct gsm_config_ext {
|
|
__u32 keep_alive; /* Control channel keep-alive in 1/100th of a
|
|
* second (0 to disable)
|
|
*/
|
|
__u32 reserved[7]; /* For future use, must be initialized to zero */
|
|
};
|
|
|
|
#define GSMIOC_GETCONF_EXT _IOR('G', 5, struct gsm_config_ext)
|
|
#define GSMIOC_SETCONF_EXT _IOW('G', 6, struct gsm_config_ext)
|
|
|
|
#endif
|