change log for rtems (2010-05-09)

rtems-vc at rtems.org rtems-vc at rtems.org
Mon May 10 00:11:24 UTC 2010


 *joel*:
2010-05-09	Joel Sherrill <joel.sherrill at oarcorp.com>

	PR 1512/doc
	* shell/general.t: Add setenv, getenv, and unsetenv.

M  1.269  doc/ChangeLog
M    1.9  doc/shell/general.t

diff -u rtems/doc/ChangeLog:1.268 rtems/doc/ChangeLog:1.269
--- rtems/doc/ChangeLog:1.268	Wed May  5 15:44:15 2010
+++ rtems/doc/ChangeLog	Sun May  9 18:13:26 2010
@@ -1,3 +1,8 @@
+2010-05-09	Joel Sherrill <joel.sherrill at oarcorp.com>
+
+	PR 1512/doc
+	* shell/general.t: Add setenv, getenv, and unsetenv.
+
 2010-05-05	Alin Rus <alin.codejunkie at gmail.com>
 
 	PR 1510/doc

diff -u rtems/doc/shell/general.t:1.8 rtems/doc/shell/general.t:1.9
--- rtems/doc/shell/general.t:1.8	Fri Feb 29 17:20:29 2008
+++ rtems/doc/shell/general.t	Sun May  9 18:13:26 2010
@@ -1,5 +1,5 @@
 @c
- at c  COPYRIGHT (c) 1988-2008.
+ at c  COPYRIGHT (c) 1988-2010.
 @c  On-Line Applications Research Corporation (OAR).
 @c  All rights reserved.
 @c
@@ -21,6 +21,9 @@
 @item @code{id} - show uid gid euid and egid
 @item @code{tty} - show ttyname
 @item @code{whoami} - print effective user id
+ at item @code{getenv} - print environment variable
+ at item @code{setenv} - set environment variable
+ at item @code{unsetenv} - unset environment variable
 @item @code{logoff} - logoff from the system
 @item @code{exit} - alias for logoff command
 
@@ -623,6 +626,222 @@
 @c
 @c
 @page
+ at subsection getenv - print environment variable
+
+ at pgindex getenv
+
+ at subheading SYNOPSYS:
+
+ at example
+getenv variable
+ at end example
+
+ at subheading DESCRIPTION:
+
+This command is used to display the value of a @code{variable} in the set
+of environment variables.
+
+ at subheading EXIT STATUS:
+
+This command will return 1 and print a diagnostic message if
+a failure occurs.
+
+ at subheading NOTES:
+
+The entire RTEMS application shares a single set of environment variables.
+
+ at subheading EXAMPLES:
+
+The following is an example of how to use @code{getenv}:
+
+ at example
+SHLL [/] $ getenv BASEPATH
+/mnt/hda1
+ at end example
+
+ at subheading CONFIGURATION:
+
+ at findex CONFIGURE_SHELL_NO_COMMAND_GETENV
+ at findex CONFIGURE_SHELL_COMMAND_GETENV
+
+This command is included in the default shell command set.  
+When building a custom command set, define
+ at code{CONFIGURE_SHELL_COMMAND_GETENV} to have this
+command included.
+
+This command can be excluded from the shell command set by
+defining @code{CONFIGURE_SHELL_NO_COMMAND_GETENV} when all
+shell commands have been configured.
+
+ at subheading PROGRAMMING INFORMATION:
+
+ at findex rtems_shell_rtems_main_getenv
+
+The @code{getenv} is implemented by a C language function
+which has the following prototype:
+
+ at example
+int rtems_shell_rtems_main_getenv(
+  int    argc,
+  char **argv
+);
+ at end example
+
+The configuration structure for the @code{getenv} has the
+following prototype:
+
+ at example
+extern rtems_shell_cmd_t rtems_shell_GETENV_Command;
+ at end example
+
+ at c
+ at c
+ at c
+ at page
+ at subsection setenv - set environment variable
+
+ at pgindex setenv
+
+ at subheading SYNOPSYS:
+
+ at example
+setenv variable [value]
+ at end example
+
+ at subheading DESCRIPTION:
+
+This command is used to add a new @code{variable} to the set of environment
+variables or to modify the variable of an already existing @code{variable}.
+If the @code{value} is not provided, the @code{variable} will be set to the
+empty string.
+
+ at subheading EXIT STATUS:
+
+This command will return 1 and print a diagnostic message if
+a failure occurs.
+
+ at subheading NOTES:
+
+The entire RTEMS application shares a single set of environment variables.
+
+ at subheading EXAMPLES:
+
+The following is an example of how to use @code{setenv}:
+
+ at example
+SHLL [/] $ setenv BASEPATH /mnt/hda1
+ at end example
+
+ at subheading CONFIGURATION:
+
+ at findex CONFIGURE_SHELL_NO_COMMAND_SETENV
+ at findex CONFIGURE_SHELL_COMMAND_SETENV
+
+This command is included in the default shell command set.  
+When building a custom command set, define
+ at code{CONFIGURE_SHELL_COMMAND_SETENV} to have this
+command included.
+
+This command can be excluded from the shell command set by
+defining @code{CONFIGURE_SHELL_NO_COMMAND_SETENV} when all
+shell commands have been configured.
+
+ at subheading PROGRAMMING INFORMATION:
+
+ at findex rtems_shell_rtems_main_setenv
+
+The @code{setenv} is implemented by a C language function
+which has the following prototype:
+
+ at example
+int rtems_shell_rtems_main_setenv(
+  int    argc,
+  char **argv
+);
+ at end example
+
+The configuration structure for the @code{setenv} has the
+following prototype:
+
+ at example
+extern rtems_shell_cmd_t rtems_shell_SETENV_Command;
+ at end example
+
+ at c
+ at c
+ at c
+ at page
+ at subsection unsetenv - unset environment variable
+
+ at pgindex unsetenv
+
+ at subheading SYNOPSYS:
+
+ at example
+unsetenv variable
+ at end example
+
+ at subheading DESCRIPTION:
+
+This command is remove to a @code{variable} from the set of environment
+variables.
+
+ at subheading EXIT STATUS:
+
+This command will return 1 and print a diagnostic message if
+a failure occurs.
+
+ at subheading NOTES:
+
+The entire RTEMS application shares a single set of environment variables.
+
+ at subheading EXAMPLES:
+
+The following is an example of how to use @code{unsetenv}:
+
+ at example
+SHLL [/] $ unsetenv BASEPATH
+ at end example
+
+ at subheading CONFIGURATION:
+
+ at findex CONFIGURE_SHELL_NO_COMMAND_UNSETENV
+ at findex CONFIGURE_SHELL_COMMAND_UNSETENV
+
+This command is included in the default shell command set.  
+When building a custom command set, define
+ at code{CONFIGURE_SHELL_COMMAND_UNSETENV} to have this
+command included.
+
+This command can be excluded from the shell command set by
+defining @code{CONFIGURE_SHELL_NO_COMMAND_UNSETENV} when all
+shell commands have been configured.
+
+ at subheading PROGRAMMING INFORMATION:
+
+ at findex rtems_shell_rtems_main_unsetenv
+
+The @code{unsetenv} is implemented by a C language function
+which has the following prototype:
+
+ at example
+int rtems_shell_rtems_main_unsetenv(
+  int    argc,
+  char **argv
+);
+ at end example
+
+The configuration structure for the @code{unsetenv} has the
+following prototype:
+
+ at example
+extern rtems_shell_cmd_t rtems_shell_UNSETENV_Command;
+ at end example
+
+ at c
+ at c
+ at c
+ at page
 @subsection logoff - logoff from the system
 
 @pgindex logoff



--

Generated by Deluxe Loginfo [http://www.codewiz.org/projects/index.html#loginfo] 2.122 by Bernardo Innocenti <bernie at develer.com>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/vc/attachments/20100509/f237ecf6/attachment.html>


More information about the vc mailing list