RTEMS 4.10.0 On-Line Library

File and Directory Commands cat - display file contents

RTEMS Shell User's Guide

3.2.13: cat - display file contents

SYNOPSYS:

cat file1 [file2 .. fileN]

DESCRIPTION:

This command displays the contents of the specified files.

EXIT STATUS:

This command returns 0 on success and non-zero if an error is encountered.

NOTES:

It is possible to read the input from a device file using cat.

EXAMPLES:

The following is an example of how to use cat:

SHLL [/] # cat /etc/passwd
root:*:0:0:root::/:/bin/sh
rtems:*:1:1:RTEMS Application::/:/bin/sh
tty:!:2:2:tty owner::/:/bin/false

CONFIGURATION:

This command is included in the default shell command set. When building a custom command set, define CONFIGURE_SHELL_COMMAND_CAT to have this command included.

This command can be excluded from the shell command set by defining CONFIGURE_SHELL_NO_COMMAND_CAT when all shell commands have been configured.

PROGRAMMING INFORMATION:

The cat is implemented by a C language function which has the following prototype:

int rtems_shell_rtems_main_cat(
  int    argc,
  char **argv
);

The configuration structure for the cat has the following prototype:

extern rtems_shell_cmd_t rtems_shell_CAT_Command;

RTEMS Shell User's Guide