Skip to contentSkip to conversation

tty: n_gsm: remove obsolete mknod doc example

PATCH Superseded Martin Hundebøll 3 participants 8 messages Jul 8, 2019 – Jul 10, 2019

Subsystems (2)

v1 of 3 Superseded Latest is v3 →

lore
Share & tools
lore
#0 lore raw

PATCH 1/4 tty: n_gsm: remove obsolete mknod doc example

The n_gsm driver handles registration of /dev/gsmttyX nodes, so there's no need to do mknod manually.

---
 Documentation/serial/n_gsm.rst | 10 ----------
 1 file changed, 10 deletions(-)
Documentation/serial/n_gsm.rst +0 -10
index f3ad9fd26408..78f91ce06956 100644
@@ -63,16 +63,6 @@ Major parts of the initialization program :
 	daemon(0,0);
 	pause();
 
-4. create the devices corresponding to the "virtual" serial ports (take care,
-   each modem has its configuration and some DLC have dedicated functions,
-   for example GPS), starting with minor 1 (DLC0 is reserved for the management
-   of the mux)::
-
-     MAJOR=`cat /proc/devices |grep gsmtty | awk '{print $1}`
-     for i in `seq 1 4`; do
-	mknod /dev/ttygsm$i c $MAJOR $i
-     done
-
 5. use these devices as plain serial ports.
 
    for example, it's possible:
Signature · 1 line
2.22.0
#1 lore raw

PATCH 2/4 tty: n_gsm: update doc example to use header for N_GSM0710 define

There is no reason to gues the line discipline number when it is available from tty.h

---
 Documentation/serial/n_gsm.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
Documentation/serial/n_gsm.rst +1 -1
index 78f91ce06956..a3ce1b269018 100644
@@ -23,7 +23,7 @@ Major parts of the initialization program :
 (a good starting point is util-linux-ng/sys-utils/ldattach.c)::
 
   #include <linux/gsmmux.h>
-  #define N_GSM0710	21	/* GSM 0710 Mux */
+  #include <linux/tty.h>
   #define DEFAULT_SPEED	B115200
   #define SERIAL_PORT	/dev/ttyS0
 
Signature · 1 line
2.22.0
#2 lore raw

PATCH 3/4 tty: n_gsm: add helper to convert mux-num to/from tty-base

In reply to Martin Hundebøll

Make it obvious how the gsm mux number relates to the virtual tty lines by using helper function instead of shifting 6 bits.

---
 drivers/tty/n_gsm.c | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)
drivers/tty/n_gsm.c +13 -3
index c4e16b31f9ab..cba06063c44a 100644
@@ -2171,6 +2171,16 @@ static inline void mux_put(struct gsm_mux *gsm)
 	kref_put(&gsm->ref, gsm_free_muxr);
 }
 
+static inline int mux_num_to_base(struct gsm_mux *gsm)
+{
+	return gsm->num * NUM_DLCI;
+}
+
+static inline unsigned int mux_line_to_num(int line)
+{
+	return line / NUM_DLCI;
+}
+
 /**
  *	gsm_alloc_mux		-	allocate a mux
  *
@@ -2361,7 +2371,7 @@ static int gsmld_attach_gsm(struct tty_struct *tty, struct gsm_mux *gsm)
 	else {
 		/* Don't register device 0 - this is the control channel and not
 		   a usable tty interface */
-		base = gsm->num << 6; /* Base for this MUX */
+		base = mux_num_to_base(gsm); /* Base for this MUX */
 		for (i = 1; i < NUM_DLCI; i++)
 			tty_register_device(gsm_tty_driver, base + i, NULL);
 	}
@@ -2380,7 +2390,7 @@ static int gsmld_attach_gsm(struct tty_struct *tty, struct gsm_mux *gsm)
 static void gsmld_detach_gsm(struct tty_struct *tty, struct gsm_mux *gsm)
 {
 	int i;
-	int base = gsm->num << 6; /* Base for this MUX */
+	int base = mux_num_to_base(gsm); /* Base for this MUX */
 
 	WARN_ON(tty != gsm->tty);
 	for (i = 1; i < NUM_DLCI; i++)
@@ -2908,7 +2918,7 @@ static int gsmtty_install(struct tty_driver *driver, struct tty_struct *tty)
 	struct gsm_mux *gsm;
 	struct gsm_dlci *dlci;
 	unsigned int line = tty->index;
-	unsigned int mux = line >> 6;
+	unsigned int mux = mux_line_to_num(line);
 	bool alloc = false;
 	int ret;
 
Signature · 1 line
2.22.0
#3 lore raw

PATCH 4/4 tty: n_gsm: add ioctl to map serial device to mux'ed tty

In reply to Martin Hundebøll

Guessing the base tty for a gsm0710 multiplexed serial device is not currently possible, which makes it racy to use with multiple modems.

Add a way to map the physical serial tty to its related mux devices using a ioctl.

---
 Documentation/serial/n_gsm.rst | 8 ++++++++
 drivers/tty/n_gsm.c            | 6 ++++++
 include/uapi/linux/gsmmux.h    | 2 ++
 3 files changed, 16 insertions(+)
Documentation/serial/n_gsm.rst +8 -0
index a3ce1b269018..bf5d7f82b5af 100644
@@ -18,10 +18,12 @@ How to use it
 2. switch the serial line to using the n_gsm line discipline by using
    TIOCSETD ioctl,
 3. configure the mux using GSMIOC_GETCONF / GSMIOC_SETCONF ioctl,
+4. obtain base gsmtty number for the used serial port,
 
 Major parts of the initialization program :
 (a good starting point is util-linux-ng/sys-utils/ldattach.c)::
 
+  #include <stdio.h>
   #include <linux/gsmmux.h>
   #include <linux/tty.h>
   #define DEFAULT_SPEED	B115200
@@ -30,6 +32,7 @@ Major parts of the initialization program :
 	int ldisc = N_GSM0710;
 	struct gsm_config c;
 	struct termios configuration;
+	int base;
 
 	/* open the serial port connected to the modem */
 	fd = open(SERIAL_PORT, O_RDWR | O_NOCTTY | O_NDELAY);
@@ -58,6 +61,11 @@ Major parts of the initialization program :
 	c.mtu = 127;
 	/* set the new configuration */
 	ioctl(fd, GSMIOC_SETCONF, &c);
+	/* get and print base gsmtty device node */
+	ioctl(fd, GSMIOC_GETBASE, &base);
+	/* the base node is used for mux control by the driver */
+	printf(first muxed line: /dev/gsmtty%i\n", base + 1);
+
 
 	/* and wait for ever to keep the line discipline enabled */
 	daemon(0,0);
drivers/tty/n_gsm.c +6 -0
index cba06063c44a..93c24d9b582b 100644
@@ -2612,6 +2612,7 @@ static int gsmld_ioctl(struct tty_struct *tty, struct file *file,
 {
 	struct gsm_config c;
 	struct gsm_mux *gsm = tty->disc_data;
+	int base;
 
 	switch (cmd) {
 	case GSMIOC_GETCONF:
@@ -2623,6 +2624,11 @@ static int gsmld_ioctl(struct tty_struct *tty, struct file *file,
 		if (copy_from_user(&c, (void *)arg, sizeof(c)))
 			return -EFAULT;
 		return gsm_config(gsm, &c);
+	case GSMIOC_GETBASE:
+		base = mux_num_to_base(gsm);
+		if (copy_to_user((void *)arg, &base, sizeof(base)))
+			return -EFAULT;
+		return 0;
 	default:
 		return n_tty_ioctl_helper(tty, file, cmd, arg);
 	}
include/uapi/linux/gsmmux.h +2 -0
index 101d3c469acb..6eb63be3ed9e 100644
@@ -37,5 +37,7 @@ struct gsm_netconfig {
 #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_GETBASE		_IOR('G', 4, int)
 
 #endif
Signature · 1 line
2.22.0
#4 lore raw

Re: [PATCH 4/4] tty: n_gsm: add ioctl to map serial device to mux'ed tty

Quoted 5 lines · Martin Hundebøll

Guessing the base tty for a gsm0710 multiplexed serial device is not currently possible, which makes it racy to use with multiple modems.

Add a way to map the physical serial tty to its related mux devices using a ioctl.

...

Quoted 2 lines
Documentation/serial/n_gsm.rst +0 -0

...

Documentation/serial/n_gsm.rst Major parts of the initialization program : · line 67

Quoted 8 lines
Documentation/serial/n_gsm.rst +4 -0
@@ -58,6 +61,11 @@ Major parts of the initialization program :
 	c.mtu = 127;
 	/* set the new configuration */
 	ioctl(fd, GSMIOC_SETCONF, &c);
+	/* get and print base gsmtty device node */
+	ioctl(fd, GSMIOC_GETBASE, &base);
+	/* the base node is used for mux control by the driver */
+	printf(first muxed line: /dev/gsmtty%i\n", base + 1);

Missing " there.

Quoted 2 lines
drivers/tty/n_gsm.c +0 -0

...

drivers/tty/n_gsm.c static int gsmld_ioctl(struct tty_struct *tty, struct file *file, · line 2629

Quoted 7 lines
drivers/tty/n_gsm.c +3 -0
@@ -2623,6 +2624,11 @@ static int gsmld_ioctl(struct tty_struct *tty, struct file *file,
 		if (copy_from_user(&c, (void *)arg, sizeof(c)))
 			return -EFAULT;
 		return gsm_config(gsm, &c);
+	case GSMIOC_GETBASE:
+		base = mux_num_to_base(gsm);
+		if (copy_to_user((void *)arg, &base, sizeof(base)))

put_user would be more appropriate (and easier) for an int here.

thanks,

Signature · 2 lines
js
suse labs
#5 lore raw

Re: [PATCH 4/4] tty: n_gsm: add ioctl to map serial device to mux'ed tty

In reply to Martin Hundebøll
Quoted 5 lines · On Mon, 8 Jul 2019 21:02:52 +0200 Martin Hundebøll <[email protected]> wrote:

Guessing the base tty for a gsm0710 multiplexed serial device is not currently possible, which makes it racy to use with multiple modems.

Add a way to map the physical serial tty to its related mux devices using a ioctl.

That looks very sensible

Documentation/serial/n_gsm.rst Major parts of the initialization program : · line 65

Quoted 10 lines
Documentation/serial/n_gsm.rst +3 -0
+	int base;
 
 	/* open the serial port connected to the modem */
 	fd = open(SERIAL_PORT, O_RDWR | O_NOCTTY | O_NDELAY);
@@ -58,6 +61,11 @@ Major parts of the initialization program :
 	c.mtu = 127;
 	/* set the new configuration */
 	ioctl(fd, GSMIOC_SETCONF, &c);
+	/* get and print base gsmtty device node */
+	ioctl(fd, GSMIOC_GETBASE, &base);

Can we at least use a specific sized type ? uint32_t or whatever is fine.

Alan

#6 lore raw

Re: [PATCH 4/4] tty: n_gsm: add ioctl to map serial device to mux'ed tty

Quoted 11 lines · Alan Cox

Documentation/serial/n_gsm.rst Major parts of the initialization program : · line 65

Quoted 10 lines
Documentation/serial/n_gsm.rst +3 -0
+	int base;
 
  	/* open the serial port connected to the modem */
  	fd = open(SERIAL_PORT, O_RDWR | O_NOCTTY | O_NDELAY);
@@ -58,6 +61,11 @@ Major parts of the initialization program :
  	c.mtu = 127;
  	/* set the new configuration */
  	ioctl(fd, GSMIOC_SETCONF, &c);
+	/* get and print base gsmtty device node */
+	ioctl(fd, GSMIOC_GETBASE, &base);

Can we at least use a specific sized type ? uint32_t or whatever is fine.

Sure.

I am also considering whether returning the base (i.e. the unexposed control line) just confuses users. It might be better to use GSMIOC_GETFIRST instead, which would then return 1 for the first mux, and 65 for the second, and so forth.

// Martin

#7 lore raw
In reply to Martin Hundebøll
Quoted 17 lines · Martin Hundebøll

The n_gsm driver handles registration of /dev/gsmttyX nodes, so there's no need to do mknod manually.

---
 Documentation/serial/n_gsm.rst | 10 ----------
 1 file changed, 10 deletions(-)
Documentation/serial/n_gsm.rst +0 -1
index f3ad9fd26408..78f91ce06956 100644
@@ -63,16 +63,6 @@ Major parts of the initialization program :
 	daemon(0,0);
 	pause();
 
-4. create the devices corresponding to the "virtual" serial ports (take care,

Documentation/serial/n_gsm.rst Major parts of the initialization program : · line 66

Quoted 10 lines
Documentation/serial/n_gsm.rst +0 -9
-   each modem has its configuration and some DLC have dedicated functions,
-   for example GPS), starting with minor 1 (DLC0 is reserved for the management
-   of the mux)::
-
-     MAJOR=`cat /proc/devices |grep gsmtty | awk '{print $1}`
-     for i in `seq 1 4`; do
-	mknod /dev/ttygsm$i c $MAJOR $i
-     done
-
 5. use these devices as plain serial ports.

So you should renumber the rest now...

thanks,

Signature · 2 lines
js
suse labs