RTEMS Shell Guide (5.4-rc2). — RTEMS Shell Guide 5.4-rc2 (21st August 2026) documentation

# RTEMS Shell Guide (5.4-rc2).

Copyrights and License

© 2016, 2019 Chris Johns
© 2016, 2017 embedded brains GmbH
© 2016, 2017 Sebastian Huber
© 1988, 2017 On-Line Applications Research Corporation (OAR)

This document is available under the Creative Commons Attribution-ShareAlike 4.0 International Public License.

The authors have used their best efforts in preparing this material. These efforts include the development, research, and testing of the theories and programs to determine their effectiveness. No warranty of any kind, expressed or implied, with regard to the software or the material contained in this document is provided. No liability arising out of the application or use of any product described in this document is assumed. The authors reserve the right to revise this material and to make changes from time to time in the content hereof without obligation to notify anyone of such revision or changes.

The RTEMS Project is hosted at https://www.rtems.org. Any inquiries concerning RTEMS, its related support components, or its documentation should be directed to the RTEMS Project community.

RTEMS Online Resources

Home | https://www.rtems.org
Documentation | https://docs.rtems.org
Mailing Lists | https://lists.rtems.org
Bug Reporting | https://devel.rtems.org/wiki/Developer/Bug_Reporting
Git Repositories | https://git.rtems.org
Developers | https://devel.rtems.org

- 1. Preface
  - 1.1. Acknowledgements
- 2. Configuration and Initialization
  - 2.1. Introduction
  - 2.2. Configuration
    - 2.2.1. Customizing the Command Set
    - 2.2.2. Adding Custom Commands
  - 2.3. Initialization
    - 2.3.1. Attached to a Serial Port
    - 2.3.2. Attached to a Socket
  - 2.4. Access Control
    - 2.4.1. Login Checks
    - 2.4.2. Configuration Files
    - 2.4.3. Command Visibility and Execution Permission
    - 2.4.4. Add CRYPT(3) Formats
  - 2.5. Functions
    - 2.5.1. rtems_shell_init - Initialize the shell
    - 2.5.2. rtems_shell_login_check - Default login check handler
- 3. General Commands
  - 3.1. Introduction
  - 3.2. Commands
    - 3.2.1. help - Print command help
    - 3.2.2. alias - add alias for an existing command
    - 3.2.3. cmdls - List commands
    - 3.2.4. cmdchown - Change user or owner of commands
    - 3.2.5. cmdchmod - Change mode of commands
    - 3.2.6. date - print or set current date and time
    - 3.2.7. echo - produce message in a shell script
    - 3.2.8. sleep - delay for a specified amount of time
    - 3.2.9. id - show uid gid euid and egid
    - 3.2.10. tty - show ttyname
    - 3.2.11. whoami - print effective user id
    - 3.2.12. getenv - print environment variable
    - 3.2.13. setenv - set environment variable
    - 3.2.14. unsetenv - unset environment variable
    - 3.2.15. time - time command execution
    - 3.2.16. logoff - logoff from the system
    - 3.2.17. rtc - RTC driver configuration
    - 3.2.18. exit - exit the shell
- 4. File and Directory Commands
  - 4.1. Introduction
  - 4.2. Commands
    - 4.2.1. blksync - sync the block driver
    - 4.2.2. cat - display file contents
    - 4.2.3. cd - alias for chdir
    - 4.2.4. chdir - change the current directory
    - 4.2.5. chmod - change permissions of a file
    - 4.2.6. chroot - change the root directory
    - 4.2.7. cp - copy files
    - 4.2.8. dd - convert and copy a file
    - 4.2.9. debugrfs - debug RFS file system
    - 4.2.10. df - display file system disk space usage
    - 4.2.11. dir - alias for ls
    - 4.2.12. fdisk - format disk
    - 4.2.13. hexdump - ascii/dec/hex/octal dump
    - 4.2.14. ln - make links
    - 4.2.15. ls - list files in the directory
    - 4.2.16. md5 - compute the Md5 hash of a file or list of files
    - 4.2.17. mkdir - create a directory
    - 4.2.18. mkdos - DOSFS file system format
    - 4.2.19. mknod - make device special file
    - 4.2.20. mkrfs - format RFS file system
    - 4.2.21. mount - mount disk
    - 4.2.22. mv - move files
    - 4.2.23. pwd - print work directory
    - 4.2.24. rmdir - remove empty directories
    - 4.2.25. rm - remove files
    - 4.2.26. umask - set file mode creation mask
    - 4.2.27. unmount - unmount disk
- 5. Memory Commands
  - 5.1. Introduction
  - 5.2. Commands
    - 5.2.1. mdump - display contents of memory
    - 5.2.2. wdump - display contents of memory (word)
    - 5.2.3. ldump - display contents of memory (longword)
    - 5.2.4. medit - modify contents of memory
    - 5.2.5. mfill - file memory with pattern
    - 5.2.6. mmove - move contents of memory
    - 5.2.7. malloc - obtain information on C program heap
- 6. RTEMS Specific Commands
  - 6.1. Introduction
  - 6.2. Commands
    - 6.2.1. shutdown - Shutdown the system
    - 6.2.2. cpuinfo - print per-processor information
    - 6.2.3. cpuuse - print or reset per thread cpu usage
    - 6.2.4. stackuse - print per thread stack usage
    - 6.2.5. perioduse - print or reset per period usage
    - 6.2.6. profreport - print a profiling report
    - 6.2.7. wkspace - display information on executive workspace
    - 6.2.8. config - show the system configuration.
    - 6.2.9. itask - list init tasks for the system
    - 6.2.10. extension - display information about extensions
    - 6.2.11. task - display information about tasks
    - 6.2.12. queue - display information about message queues
    - 6.2.13. sema - display information about semaphores
    - 6.2.14. region - display information about regions
    - 6.2.15. part - display information about partitions
    - 6.2.16. object - display information about RTEMS objects
    - 6.2.17. driver - display the RTEMS device driver table
    - 6.2.18. dname - displays information about named drivers
    - 6.2.19. pthread - display information about POSIX threads
- 7. Dynamic Loader
  - 7.1. Introduction
  - 7.2. Commands
    - 7.2.1. rtl - Manager the RTL
- 8. Network Commands
  - 8.1. Introduction
  - 8.2. Commands
    - 8.2.1. netstats - obtain network statistics
    - 8.2.2. ifconfig - configure a network interface
    - 8.2.3. route - show or manipulate the ip routing table
    - 8.2.4. ping - ping a host or IP address
- 9. Function and Variable Index
- 10. Concept Index