[PATCH] serial.c procfs 2nd try - discussion

Ed Vance (EdV@macrolink.com)
Mon, 11 Mar 2002 17:41:09 -0800


This serial driver patch modifies function line_info() which assembles text
to be read from /proc/tty/driver/serial. For example, the text line for the
COM2 port, which is mapped to I/O space, is as follows:

"1: uart:16550A port:02F8 irq:3 tx:0 rx:0 "

The patch corrects handling of ports that are on memory mapped devices.
The unpatched function generates a short text line for such ports because
the I/O port address field is zero on memory mapped ports:

"4: uart:16C950/954 port:0 irq:14"

This is the format used for nonexistent ports. Truly nonexistent ports
always have a port type of "unknown port". kudzu depends on that. The bug
causes the short format to be used for all memory mapped ports which have
known types. The absence of the tx: and rx: fields in the short format
causes kudzu to die during system initialization at the "Checking for new
hardware" step:

S05kudzu: pciserial.c: Line 78: 237 Segmentation fault

This is caused by a null-pointer dereference in kudzu's not-so-robust
parser, when it lemmings off the end of the invalid short line.

This patch adds a test to avoid displaying ports that are marked as uart
type "unknown" instead of displaying a line for all possible port numbers.
This patch adds logic to check both the I/O port field and the I/O memory
base address field to display the correct device address. The patched
driver generates the longer format text for memory mapped ports:

"4: uart:16C950/954 port:C4800000 irq:14 tx:0 rx:0 "

To avoid breaking kudzu, but still make it possible to see which ports are
mapped to I/O space and which are mapped to memory, the label on the port
address field is left as "port:". Memory mapped addresses are displayed
as eight hex digits. I/O port mapped addresses are displayed as four hex
digits. The "serinfo" version number on the first line is changed from 1.0
to 1.1 because of these display differences.

Created on kernel files rev 2.4.19-pre2

SUMMARY OF CHANGES:
Changes text generated by serial driver for the /proc/tty/driver/serial
interface. Serinfo version tag changes from 1.0 to 1.1. Now generates a
correct display for memory mapped devices. Displays only ports claimed
by driver. Displays I/O port addresses as 4 digits, and memory mapped
addresses as 8 digits. New format prevents kudzu crash on null pointer
de-reference when memory mapped devices are present.

Contributor: Ed Vance [serial24@macrolink.com]

ISSUES AND CONCERNS FOR DISCUSSION:

1. Does anybody know of anything that will break because the nonexistent
ports are not displayed?

2. Does anybody know of anything that will break because of the leading
zeros that are now present on the address field?

diff -urN -X dontdiff.txt linux-2.4.19-pre2/drivers/char/serial.c
patched/drivers/char/serial.c
--- linux-2.4.19-pre2/drivers/char/serial.c Sat Mar 2 10:38:11 2002
+++ patched/drivers/char/serial.c Mon Mar 11 16:22:42 2002
@@ -3258,15 +3258,19 @@
int ret;
unsigned long flags;

- ret = sprintf(buf, "%d: uart:%s port:%lX irq:%d",
- state->line, uart_config[state->type].name,
- state->port, state->irq);
-
- if (!state->port || (state->type == PORT_UNKNOWN)) {
- ret += sprintf(buf+ret, "\n");
- return ret;
+ /*
+ * Return zero characters for ports not claimed by a driver.
+ */
+ if (state->type == PORT_UNKNOWN) {
+ return 0; /* ignore unused ports */
}

+ ret = sprintf(buf, state->port ? "%d: uart:%s port:%04lX irq:%d"
+ : "%d: uart:%s port:%08lX irq:%d",
+ state->line, uart_config[state->type].name,
+ (state->port ? state->port : (long)state->iomem_base),
+ state->irq);
+
/*
* Figure out the current RS-232 lines
*/
@@ -3336,7 +3340,7 @@
int i, len = 0, l;
off_t begin = 0;

- len += sprintf(page, "serinfo:1.0 driver:%s%s revision:%s\n",
+ len += sprintf(page, "serinfo:1.1 driver:%s%s revision:%s\n",
serial_version, LOCAL_VERSTRING, serial_revdate);
for (i = 0; i < NR_PORTS && len < 4000; i++) {
l = line_info(page + len, &rs_table[i]);

----------------------------------------------------------------
Ed Vance serial24@macrolink.com
Macrolink, Inc. 1500 N. Kellogg Dr Anaheim, CA 92807
----------------------------------------------------------------

-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/