HP 3000 Manuals HP 3000 Manuals
HP C/iX Library Reference Manual
________________________________________________________________________ |Notice | | | |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 AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett-Packard | |shall not be liable for errors contained herein or for incidental or | |consequential damages in connection with the furnishing, performance, | |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. No part of this document may be | |photocopied, reproduced, or translated to another language without the| |prior written consent of Hewlett-Packard Company. | | | |Restricted Rights Legend. Use, duplication, or disclosure by the U.S.| |Government is subject to restrictions as set forth in paragraph (c) | |(1) (ii) of the Rights in Technical Data and Computer Software clause | |in DFARS 252.227-7013. | | | |HEWLETT-PACKARD COMPANY | |3000 Hanover Street | |Palo Alto, California 94304 U.S.A. | | | |Rights for non-DOD U.S. Government Departments and Agencies are as set| |forth in FAR 52.227-19(c) (1,2). | ________________________________________________________________________ (c) Copyright 1987, 1988, 1990, 1992 by HEWLETT-PACKARD COMPANY Printed in U.S.A. HP 3000 Series 900 Computers HP Part No. 30026-90001 Edition Fifth Edition Printed October 1992 Printing History New editions are complete revisions of the manual. The dates on the title page change only when a new edition is published. The software code printed alongside the date indicates the version level of the software product at the time the manual was issued. Many product updates and fixes do not require manual changes, and conversely, manual corrections may be done without accompanying product changes. Therefore, do not expect a one-to-one correspondence between product updates and manual updates. First Edition November 1987 30026A.00.05 Second Edition October 1988 30026A.01.27 Third Edition April 1990 30026A.02.15 Fourth Edition June 1992 30026A.04.05 Fifth Edition October 1992 30026A.04.51 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 the PA-RISC architecture. MPE V software can be run on the PA-RISC (Series 900) HP 3000s in what is known as compatibility mode. What's In This Manual The HP C/iX Library Reference Manual describes the standard library functions and other functions in HP C/iX on HP 3000 Series 900 systems. This manual is intended for experienced C programmers who are familiar with HP computers. This manual is organized as follows: Chapter 1 Introduction to the HP C/iX Library introduces the HP C/iX library. Chapter 2 HP C/iX Library Input and Output provides an overview of stream files and the HP C/iX Library input/output functions. Chapter 3 Interfacing with MPE/iX describes the HP C/iX application program interface to MPE/iX. Chapter 4 HP C/iX Library Header Descriptions describes the HP C/iX library header files. Chapter 5 HP C/iX Library Function Descriptions presents the syntax and descriptions for all HP C/iX library functions. Appendix A Time Zones lists the time zones and the TZ environment variable strings that correspond to these time zones. Appendix B Restrictions and Special Considerations discusses restrictions and considerations that are not in the range of this manual. Appendix C System-Dependent Information summarizes the differences between the HP C libraries on the HP 3000 Series 900 and HP 9000 Series 700/800 computers. [REV BEG] MPE/iX Developer's Kit The HP C/iX Library Reference Manual is provided along with the MPE/iX Developer's Kit Reference Manual to customers who have purchased the MPE/iX Developer's Kit. Together, these manuals describe the complete set of C library functions in the POSIX/iX library. Refer to the MPE/iX Developer's Kit Reference Manual for additional information about using the POSIX C libraries and HP C/iX in the MPE/iX Developer's Kit environment. [REV END] Additional Documentation The following is a list of related documentation. HP C/iX Reference Manual (31506-90005)--This manual presents reference information on the C programming language as implemented on HP 3000 Series 900 computers. HP C Programmer's Guide (92434-90002)--This programming guide explains how to program in C and gives detailed descriptions of storage and alignment, the optimizer, C debugging, and programming for efficiency and portability. HP Link Editor/XL Reference Manual (32650-90030)--This manual describes the HP Link Editor/iX subsystem and how to use it with HP 3000 Series 900 computer systems. MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-90003 and 32650-90364)--This manual describes the MPE/iX commands that allow you to initiate, control, and terminate the processing of programs and to request various system operations. MPE/iX Intrinsics Reference Manual (32650-90028)--This manual describes the set of intrinsics available on the MPE/iX operating system and tells you how to communicate with MPE/iX programmatically. American National Standards for Information Systems--Programming Language--C, ANSI X3.159-1989. [REV BEG] MPE/iX Developer's Kit Reference Manual (36430-90001)--This manual describes the POSIX/iX library routines. It also describes how to use HP C/iX in the MPE/iX Developer's Kit environment.[REV END] Conventions This manual uses the following conventions to describe the HP C/iX library. NOTATION DESCRIPTION nonitalics Within syntax descriptions, nonitalicized words represent literals. Enter them exactly as shown. This includes angle brackets appearing within syntactic descriptions. For example, #include <stdio.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 numer and denom with the respective integers that you want to pass to the div function: div(numer, denom); [ ] Within syntax descriptions, italicized brackets surround optional elements. For example, the item list in the scanf call is optional: scanf(format [,item [,item]...]) ... Within syntax descriptions, a horizontal ellipsis 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. NOTATION DESCRIPTION [REV BEG] Change bars in the margin show where substantial changes have been made to the manual since the last edition.[REV END]