rtems/rtems-docs
1
0
Fork 0
mirror of https://git.rtems.org/rtems-docs/ synced 2025-07-19 16:29:49 +08:00
Code Issues Packages Projects Releases Wiki Activity

Clean up config and init.

Browse Source
This commit is contained in:
Chris Johns 2016-01-17 07:54:30 +11:00 committed by Amar Takhar
parent 8ca13ed19f
commit 62d03a1324
1 changed files with 25 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
shell/configuration_and_init.rst
View File

@ -321,15 +321,15 @@ others - to indicate a failure condition
This service creates a task with the specified characteristics to run the RTEMS This service creates a task with the specified characteristics to run the RTEMS
Shell attached to the specified ``devname``. Shell attached to the specified ``devname``.
.. note:: **NOTES:**
This method invokes the ``rtems_task_create`` and ``rtems_task_start`` This method invokes the ``rtems_task_create`` and ``rtems_task_start``
directives and as such may return any status code that those directives may directives and as such may return any status code that those directives may
return. return.
There is one POSIX key necessary for all shell instances together and one There is one POSIX key necessary for all shell instances together and one POSIX
POSIX key value pair per instance. You should make sure that your RTEMS key value pair per instance. You should make sure that your RTEMS configuration
configuration accounts for these resources. accounts for these resources.
rtems_shell_login_check - Default login check handler rtems_shell_login_check - Default login check handler
----------------------------------------------------- -----------------------------------------------------
@ -342,8 +342,8 @@ rtems_shell_login_check - Default login check handler
.. code:: c .. code:: c
bool rtems_shell_login_check( bool rtems_shell_login_check(
const char \*user, const char *user,
const char \*passphrase const char *passphrase
); );
**DIRECTIVE STATUS CODES:** **DIRECTIVE STATUS CODES:**
@ -356,26 +356,25 @@ rtems_shell_login_check - Default login check handler
This function checks if the specified passphrase is valid for the specified This function checks if the specified passphrase is valid for the specified
user. user.
.. note:: **NOTES:**
As a side-effect if the specified passphrase is valid for the specified As a side-effect if the specified passphrase is valid for the specified user,
user, this function: this function:
- performs a filesystem change root operation to the directory of the - performs a filesystem change root operation to the directory of the specified
specified user if the directory path is non-empty, user if the directory path is non-empty,
- changes the owner of the current shell device to the UID of the specified - changes the owner of the current shell device to the UID of the specified
user, user,
- sets the real and effective UID of the current user environment to the - sets the real and effective UID of the current user environment to the UID of
UID of the specified user, the specified user,
- sets the real and effective GID of the current user environment to the - sets the real and effective GID of the current user environment to the GID of
GID of the specified user, and the specified user, and
- sets the supplementary group IDs of the current user environment to the - sets the supplementary group IDs of the current user environment to the
supplementary group IDs of the specified user. supplementary group IDs of the specified user.
In case the filesystem change root operation fails, then the environment In case the filesystem change root operation fails, then the environment setup
setup is aborted and ``false`` is returned. is aborted and ``false`` is returned.