iRMX® Command Reference RadiSys Corporation 5445 NE Dawson Creek Drive Hillsboro, OR 97124 (503) 615-1100 FAX: (503) 615-1150 www.radisys.com 07-0574-01 December 1999 EPC, iRMX, INtime, Inside Advantage, and RadiSys are registered trademarks of RadiSys Corporation. Spirit, DAI, DAQ, ASM, Brahma, and SAIB are trademarks of RadiSys Corporation. Microsoft and MS-DOS are registered trademarks of Microsoft Corporation and Windows 95 is a trademark of Microsoft Corporation. IBM and PC/AT are registered trademarks of International Business Machines Corporation. Microsoft Windows and MS-DOS are registered trademarks of Microsoft Corporation. Intel is a registered trademark of Intel Corporation. All other trademarks, registered trademarks, service marks, and trade names are property of their respective owners. December 1999 Copyright 1999 by RadiSys Corporation All rights reserved. ii Quick Contents Chapter 1. Using Commands Chapter 2. Command Descriptions Appendix A. Using Disk Mirroring Appendix B. Using Diskverify in Interactive Mode Appendix C. Structure of a Named Volume Appendix D. Real-time Graphics Interface Appendix E. Supplied Device Drivers and Physical Device Names Appendix F. Partitioning PCI Hard Disk Drives Index Command Reference iii Notational Conventions Most of the references to system calls in the text and graphics use C syntax instead of PL/M (for example, the system call send_message instead of send$message). If you are working in C, you must use the C header files, rmx_c.h, udi_c.h,andrmx_err.h. If you are working in PL/M, you must use dollar signs ($) and use the rmxplm.ext and error.lit header files. This manual uses the following conventions: • Syntax strings, data types, and data structures are provided for PL/M and C respectively. • All numbers are decimal unless otherwise stated. Hexadecimal numbers include the H radix character (for example, 0FFH). Binary numbers include the B radix character (for example, 11011000B). • Bit 0 is the low-order bit. If a bit is set to 1, the associated description is true unless otherwise stated. • Data structures and syntax strings appear in this font. • System call names and command names appear in this font. • PL/M data types such as BYTE and SELECTOR, and iRMX data types such as STRING and SOCKET are capitalized. All C data types are lower case except those that represent data structures. • The following OS layer abbreviations are used. The Nucleus layer is unabbreviated. AL Application Loader BIOS Basic I/O System EIOS Extended I/O System HI Human Interface UDI Universal Development Interface • Whenever this manual describes I/O operations, it assumes that tasks use BIOS calls (such as rq_a_read, rq_a_write,andrq_a_special). Although not mentioned, tasks can also use the equivalent EIOS calls (such as rq_s_read, rq_s_write,andrq_s_special)orUDIcalls(dq_read or dq_write)todothe same operations. iv Contents 1 Using Commands How to Use This Manual................................................................................. 1 Commands Available on Your System............................................................ 3 The Human Interface (HI)........................................................................ 4 The Command Line Interpreter (CLI) ...................................................... 5 Networking Software................................................................................ 5 Understanding the File Systems....................................................................... 6 File Types................................................................................................. 7 Named File Tree....................................................................................... 8 File Access and User IDs ......................................................................... 9 Using Pathnames ...................................................................................... 10 Using the Copy Command with Multiple Pathnames............................... 11 Using Wildcards in Filenames.................................................................. 11 Specifying Hidden Files ........................................................................... 14 Entering Commands ........................................................................................ 14 Command Syntax ..................................................................................... 15 Using the To, Over, and After Parameters ............................................... 17 Abbreviating Parameters .......................................................................... 17 Abbreviating Command Names ............................................................... 18 Recalling and Editing Commands ............................................................ 18 Using Command Search Paths.................................................................. 19 Creating Command Aliases...................................................................... 20 Redirecting I/O......................................................................................... 21 Using Commands on Directories..................................................................... 22 Displaying Files with the DIR Command................................................. 22 Creating a New Directory......................................................................... 22 Referring to a Directory............................................................................ 22 Creating a Directory Within a Directory .................................................. 24 Changing Your Working Directory .......................................................... 24 Renaming Directories............................................................................... 25 Deleting a Directory ................................................................................. 25 Using Commands on Volumes ........................................................................ 26 Formatting a New Volume ....................................................................... 27 Command Reference Contents v Using TCP/IP and NFS Commands................................................................. 29 Executing TCP/IP Commands.................................................................. 29 Case Sensitivity in TCP/IP and NFS Command Syntax........................... 29 Executing OS Commands From a Posix Shell ......................................... 30 Creating and Using Logical Names................................................................. 30 Creating Logical Names for Devices........................................................ 31 Creating Logical Names for Files............................................................. 31 Where Logical Names are Stored............................................................. 32 Logical Names Created by the Operating System .................................... 33 Error Messages................................................................................................ 35 General HI Error Messages...................................................................... 35 General iRMX-NET Error Messages ....................................................... 37 2 Command Descriptions Command Descriptions ................................................................................... 39 Command Summary................................................................................. 39 ! .............................................................................................................. 45 accounting ................................................................................................ 47 addloc....................................................................................................... 50 aedit.......................................................................................................... 54 alias .......................................................................................................... 57 arp ............................................................................................................ 63 attachdevice.............................................................................................. 66 attachfile................................................................................................... 72 background............................................................................................... 76 backup ...................................................................................................... 79 bcl............................................................................................................. 87 bootdos ..................................................................................................... 90 bootrmx .................................................................................................... 91 case........................................................................................................... 92 changeid ................................................................................................... 93 cli.............................................................................................................. 94 connect ..................................................................................................... 95 console ..................................................................................................... 97 copy.........................................................................................................