HP 3000 Manuals HP 3000 Manuals
900 Series HP 3000 Computer Systems MPE/iX Developer's Kit Reference Manual Volume I HP Part No. 36430-90001 Printed in U.S.A. Edition Second Edition E0494
UNIX is a registered trademark of UNIX System Laboratories Inc. in the USA and other countries. ________________________________________________________________________ |The information contained in this document is subject to change | |without notice. | | | |Hewlett-Packard makes no warranty of any kind with regard to this | |material, including, but not limited to, the implied warranties of | |merchantability or fitness for a particular purpose. Hewlett-Packard | |shall not be liable for errors contained herein or for direct, | |indirect, special, incidental or consequential damages in connection | |with the furnishing or use of this material. | | | |Hewlett-Packard assumes no responsibility for the use or reliability | |of its software on equipment that is not furnished by Hewlett-Packard.| | | |This document contains proprietary information that is protected by | |copyright. All rights are reserved. Reproduction, adaptation, or | |translation without prior written permission is prohibited, except as | |allowed under the copyright laws. | ________________________________________________________________________ Copyright (c) 1994 by Hewlett-Packard Company ________________________________________________________________________ |Use, duplication, or disclosure by the U.S. Government is subject to | |restrictions as set forth in subparagraph (c) (1) (ii) of the Rights | |in Technical Data and Computer Software clause at DFARS 252.227-7013. | |Rights for non-DoD U.S. Government Departments and agencies are as set| |forth in FAR 52.227-19 (c) (1,2). | | | |Hewlett-Packard Company | |3000 Hanover Street | |Palo Alto, CA 94304 U.S.A. | ________________________________________________________________________ Restricted Rights Legend Printed 1994 Printing History The following table lists the printings of this document, together with the respective release dates for each edition. The software version indicates the version of the software product at the time that this document was issued. Many product releases do not require changes to the document; therefore, do not expect a one-to-one correspondence between product releases and document editions. Edition Date Software Version --------------------------------------------------------------------------------------- First Edition October 1992 A.00.00 Second Edition April 1994 C.50.00 Preface MPE/iX, Multiprogramming Executive with Integrated POSIX, is the latest in a series of forward-compatible operating systems for the HP 3000 line of computers. In HP documentation and in talking with HP 3000 users, you will encounter references to MPE XL, the direct predecessor of MPE/iX. MPE/iX is a superset of MPE XL. All programs written for MPE XL will run without change under MPE/iX. You can continue to use MPE XL system documentation, although it may not refer to features added to the operating system to support POSIX (for example, hierarchical directories). Finally, you may encounter references to MPE V, which is the operating system for HP 3000s not based on PA-RISC architecture. MPE V software can be run on the PA-RISC (Series 900) HP 3000s in what is known as compatibility mode. The MPE/iX Developer's Kit Reference Manual, Volume 1 (36430-90001) describes the POSIX/iX library provided with the MPE/iX Developer's Kit (36430A) on 900 Series HP 3000 computer systems. This manual is intended for experienced C programmers. This manual is organized as follows: Chapter 1 Introduction provides a summary overview of the POSIX/iX library. Chapter 2 Using the POSIX/iX Library provides information on general C library considerations and how to develop applications using the MPE/iX Shell and Utilities. Chapter 3 POSIX/iX Library Implementation Considerations describe important MPE/iX implementation details you need to know when using POSIX/iX library functions. Chapter 4 POSIX/iX Library Function Descriptions presents the syntax and descriptions of POSIX/iX library functions, arranged alphabetically. Chapter 5 POSIX/iX Header Descriptions describes the contents of header files required by the POSIX/iX library. Conventions nonitalics Within syntax descriptions, nonitalicized words represent literals. Enter them exactly as shown. This includes angle brackets appearing within syntactic descriptions. For example, #include <unistd.h> Nonitalicized words and punctuation characters appear in computer font. In the following example, you must provide the keyword, function name, parentheses, and trailing semicolon: int ccode(); italics Within syntax descriptions, italicized words denote argument names, program names, or strings that you must replace with an appropriate value. In the following example, you must replace number and denom with the respective integers you want to pass to the div function: div(number, denom); [ ] Within syntax descriptions, italicized brackets surround optional elements. For example, the item list in the scanf() function call is optional: scanf(format [,item [,item]...] ); ... Within syntax descriptions, a horizontal ellipses indicates that a previous element can be repeated. For example: [,item]... Within examples, vertical and horizontal ellipses may show where portions of the example were omitted.