The alternate console device CONFIG_NSH_CONDEV must not be defined unconditionally. This causes errors when using Telnet sessions. This was solved by adding CONFIG_NSH_ALTCONDEV: CONFIG_NSH_ALTCONDEV enables or disables the feature then, if enabled, CONFIG_NSH_CONDEV provides the alternative console device name

2026-06-04 06:42:32 +08:00 · 2014-05-05 08:52:02 -06:00
parent 3ad8debd73
commit f924601fc1
129 changed files with 152 additions and 137 deletions
@@ -7279,3 +7279,9 @@
 	  measurements are being driven by an external clock, then the prototype
 	  for sched_process_cpuload() must be available in include/nuttx/arch.h
 	  (2014-4-30).
+	* Documentation/NuttShell.html and many defconfig files:  The alternate
+	  console device CONFIG_NSH_CONDEV must not be defined unconditionally.
+	  This causes errors when using Telnet sessions.  This was solved by
+	  adding CONFIG_NSH_ALTCONDEV: CONFIG_NSH_ALTCONDEV enables or disables
+	  the feature then, if enabled, CONFIG_NSH_CONDEV provides the alternative
+	  console device name (2014-5-5).
@@ -3007,8 +3007,8 @@ set FOOBAR ABC_${FOO}_${BAR}
        <li>
          <code>CONFIG_NSH_USBCONSOLE</code>.
          If defined, then the an arbitrary USB device may be used to as the NSH console.
-          In this case, <code>CONFIG_NSH_CONDEV</code> must be defined to indicate which USB device to use as the console.
-          The advantage of using a device other that /dev/console is that normal debug output can not use /dev/console while NSH uses <code>CONFIG_NSH_USBCONDEV</code>.
+          In this case, <code>CONFIG_NSH_USBCONDEV</code> must be defined to indicate which USB device to use as the console.
+          The advantage of using a device other that <code>/dev/console</code> is that normal debug output can then use <code>/dev/console</code> while NSH uses <code>CONFIG_NSH_USBCONDEV</code>.
          <p>
          <code>CONFIG_NSH_USBCONDEV</code>.
          If <code>CONFIG_NSH_USBCONSOLE</code> is set to 'y', then <code>CONFIG_NSH_USBCONDEV</code> must also be set to select the USB device used to support the NSH console.
@@ -3053,20 +3053,29 @@ set FOOBAR ABC_${FOO}_${BAR}
    </td>
  </tr>
  <tr>
-    <td valign="top"><b><code>CONFIG_NSH_CONDEV</code></b></td>
+    <td valign="top"><b><code>CONFIG_NSH_ALTCONDEV</code></b> and <b><code>CONFIG_NSH_CONDEV</code></b></td>
    <td>
-      If <code>CONFIG_NSH_CONSOLE</code> is set to <i>y</i>, then <code>CONFIG_NSH_CONDEV</code>
-      may also be set to select the serial device used to support the NSH console.
-      This should be set to the quoted name of a readable/write-able character driver such as:
+      If <code>CONFIG_NSH_CONSOLE</code> is set to <i>y</i>, then <code>CONFIG_NSH_ALTCONDEV</code>
+      may also be selected to enable use of an alternate character device to support the NSH console.
+      If <code>CONFIG_NSH_ALTCONDEV</code> is selected, then <code>CONFIG_NSH_CONDEV</code> holds the quoted name of a readable/write-able character driver such as:
      <code>CONFIG_NSH_CONDEV=&quot;/dev/ttyS1&quot;</code>.
      This is useful, for example, to separate the NSH command line from the system console
      when the system console is used to provide debug output.
      Default:  <code>stdin</code> and <code>stdout</code> (probably &quot;<code>/dev/console</code>&quot;)
      <ul><small>
-        NOTE: When any other device other than <code>/dev/console</code> is used for a user interface,
-        (1) linefeeds (<code>\n</code>) will not be expanded to carriage return / linefeeds (<code>\r\n</code>).
-        You will need to configure your terminal program to account for this.
-        And (2) input is not automatically echoed so you will have to turn local echo on.
+        <li>
+          <b>NOTE 1:</b>
+          When any other device other than <code>/dev/console</code> is used for a user interface,
+          (1) linefeeds (<code>\n</code>) will not be expanded to carriage return / linefeeds (<code>\r\n</code>).
+          You will need to configure your terminal program to account for this.
+          And (2) input is not automatically echoed so you will have to turn local echo on.
+        </li>
+        <li>
+          <b>NOTE 2:</b>
+          This option forces the console of all sessions to use NSH_CONDEV.
+          Hence, this option only makes sense for a system that supports only a single session.
+          This option is, in particular, incompatible with Telnet sessions because each Telnet session must use a different console device.
+        </li>
      </small></ul>
    </td>
  <tr>
@@ -639,7 +639,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-CONFIG_NSH_CONDEV="/dev/console"
+# CONFIG_NSH_ALTCONDEV is not set
 # CONFIG_NSH_ARCHINIT is not set

 #
@@ -637,7 +637,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 # CONFIG_NSH_ARCHINIT is not set

 #
@@ -594,7 +594,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 # CONFIG_NSH_ARCHINIT is not set

 #
@@ -662,7 +662,7 @@ CONFIG_NSH_NESTDEPTH=3
 # CONFIG_NSH_DISABLESCRIPT is not set
 # CONFIG_NSH_DISABLEBG is not set
 CONFIG_NSH_CONSOLE=y
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y
 CONFIG_NSH_TELNET=y
 CONFIG_NSH_TELNETD_PORT=23
@@ -569,7 +569,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 # CONFIG_NSH_ARCHINIT is not set

 #
@@ -601,7 +601,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 # CONFIG_NSH_ARCHINIT is not set

 #
@@ -605,7 +605,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 # CONFIG_NSH_ARCHINIT is not set

 #
@@ -748,7 +748,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 # CONFIG_NSH_ARCHINIT is not set

 #
@@ -606,7 +606,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -697,7 +697,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -765,7 +765,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y
 CONFIG_NSH_TELNET=y
 CONFIG_NSH_TELNETD_PORT=23
@@ -749,7 +749,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y
 CONFIG_NSH_TELNET=y
 CONFIG_NSH_TELNETD_PORT=23
@@ -726,7 +726,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 # CONFIG_NSH_ARCHINIT is not set
 CONFIG_NSH_TELNET=y
 CONFIG_NSH_TELNETD_PORT=23
@@ -965,7 +965,7 @@ CONFIG_NSH_NESTDEPTH=3
 # CONFIG_NSH_DISABLEBG is not set
 CONFIG_NSH_CONSOLE=y
 # CONFIG_NSH_USBCONSOLE is not set
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y
 CONFIG_NSH_TELNET=y
 CONFIG_NSH_TELNETD_PORT=23
@@ -615,7 +615,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 # CONFIG_NSH_ARCHINIT is not set

 #
@@ -604,7 +604,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 # CONFIG_NSH_ARCHINIT is not set

 #
@@ -654,7 +654,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -842,7 +842,7 @@ CONFIG_NSH_CONSOLE=y
 # USB Trace Support
 #
 # CONFIG_NSH_USBDEV_TRACE is not set
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -687,7 +687,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 # CONFIG_NSH_ARCHINIT is not set

 #
@@ -666,7 +666,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -743,7 +743,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y
 CONFIG_NSH_TELNET=y
 CONFIG_NSH_TELNETD_PORT=23
@@ -757,7 +757,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y
 CONFIG_NSH_TELNET=y
 CONFIG_NSH_TELNETD_PORT=23
@@ -757,7 +757,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y
 CONFIG_NSH_TELNET=y
 CONFIG_NSH_TELNETD_PORT=23
@@ -765,7 +765,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y
 CONFIG_NSH_TELNET=y
 CONFIG_NSH_TELNETD_PORT=23
@@ -662,7 +662,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 # CONFIG_NSH_ARCHINIT is not set

 #
@@ -675,7 +675,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -842,7 +842,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y
 CONFIG_NSH_TELNET=y
 CONFIG_NSH_TELNETD_PORT=23
@@ -757,7 +757,7 @@ CONFIG_NSH_CONSOLE=y
 # USB Trace Support
 #
 # CONFIG_NSH_USBDEV_TRACE is not set
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 # CONFIG_NSH_ARCHINIT is not set

 #
@@ -703,7 +703,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -548,7 +548,7 @@ CONFIG_NSH_NESTDEPTH=3
 # CONFIG_NSH_DISABLESCRIPT is not set
 # CONFIG_NSH_DISABLEBG is not set
 CONFIG_NSH_CONSOLE=y
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -1141,7 +1141,7 @@ CONFIG_NSH_CONSOLE=y
 # USB Trace Support
 #
 # CONFIG_NSH_USBDEV_TRACE is not set
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -945,7 +945,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -871,7 +871,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -845,7 +845,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -846,7 +846,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -855,7 +855,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -920,7 +920,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -712,7 +712,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 # CONFIG_NSH_ARCHINIT is not set

 #
@@ -757,7 +757,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -719,7 +719,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 # CONFIG_NSH_ARCHINIT is not set
 CONFIG_NSH_TELNET=y
 CONFIG_NSH_TELNETD_PORT=23
@@ -983,7 +983,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-CONFIG_NSH_CONDEV="/dev/console"
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y
 CONFIG_NSH_IPADDR=0x0a000002
 CONFIG_NSH_DRIPADDR=0x0a000001
@@ -670,7 +670,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -575,7 +575,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 # CONFIG_NSH_ARCHINIT is not set

 #
@@ -608,7 +608,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y

 #
@@ -828,7 +828,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y
 CONFIG_NSH_IPADDR=0x0a000002
 CONFIG_NSH_DRIPADDR=0x0a000001
@@ -829,7 +829,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y
 CONFIG_NSH_TELNET=y
 CONFIG_NSH_TELNETD_PORT=23
@@ -829,7 +829,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y
 CONFIG_NSH_TELNET=y
 CONFIG_NSH_TELNETD_PORT=23
@@ -840,7 +840,7 @@ CONFIG_NSH_CONSOLE=y
 #
 # USB Trace Support
 #
-# CONFIG_NSH_CONDEV is not set
+# CONFIG_NSH_ALTCONDEV is not set
 CONFIG_NSH_ARCHINIT=y
 CONFIG_NSH_TELNET=y
 CONFIG_NSH_TELNETD_PORT=23
--- a/Show More
+++ b/Show More