diff --git a/Documentation/NuttShell.html b/Documentation/NuttShell.html index ca7e8262796..2cb4bc9a429 100644 --- a/Documentation/NuttShell.html +++ b/Documentation/NuttShell.html @@ -8,7 +8,7 @@

NuttShell (NSH)

-

Last Updated: August 7, 2012

+

Last Updated: August 28, 2012

@@ -2284,8 +2284,9 @@ nsh> CONFIG_NSH_STRERROR - strerror(errno) makes more readable output but strerror() is - very large and will not be used unless this setting is y + strerror(errno) makes more readable output but strerror() is + very large and will not be used unless this setting is y. + This setting depends upon the strerror() having been enabled with CONFIG_LIBC_STRERROR. diff --git a/Documentation/NuttxPortingGuide.html b/Documentation/NuttxPortingGuide.html index 78c1327e205..a0f23e1e863 100644 --- a/Documentation/NuttxPortingGuide.html +++ b/Documentation/NuttxPortingGuide.html @@ -12,7 +12,7 @@

NuttX RTOS Porting Guide

-

Last Updated: July 8, 2012

+

Last Updated: August 28, 2012

@@ -4350,6 +4350,31 @@ build CONFIG_LIBC_FLOATINGPOINT: By default, floating point support in printf, sscanf, etc. is disabled. +
  • + CONFIG_LIBC_STRERROR: + strerror() is useful because it decodes errno values into a human readable strings. + But it can also require a lot of memory to store the strings. + If this option is selected, strerror() will still exist in the build but it will not decode error values. + This option should be used by other logic to decide if it should use strerror() or not. + For example, the NSH application will not use strerror() if this option is not selected; + perror() will not use strerror() is this option is not selected (see also CONFIG_NSH_STRERROR). +
  • +
  • + CONFIG_LIBC_STRERROR_SHORT: + If this option is selected, then strerror() will use a shortened string when it decodes the error. + Specifically, strerror() is simply use the string that is the common name for the error. + For example, the errno value of 2 will produce the string "No such file or directory" is CONFIG_LIBC_STRERROR_SHORT is not defined but the string "ENOENT" is CONFIG_LIBC_STRERROR_SHORT is defined. +
  • +
  • + CONFIG_LIBC_PERROR_STDOUT: + POSIX requires that perror() provide its output on stderr. + This option may be defined, however, to provide perror() output that is serialized with other stdout messages. +
  • +
  • + CONFIG_LIBC_PERROR_DEVNAME: + Another non-standard option is to provide perror() output to a logging device or file. + CONFIG_LIBC_PERROR_DEVNAME may be defined to be any write-able, character device (or file). +
  • Allow for architecture optimized implementations