HP-UX Reference Section 3: Library Functions (A-M) HP-UX 11i Version 3 Volume 6 of 10 Manufacturing Part Number : B2355-91022 E0207 Printed in USA © Copyright 1983-2007 Hewlett-Packard Development Company LP.
Legal Notices The information in this document is subject to change without notice. Warranty The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. U.S. Government License Confidential computer software.
Copyright 1996 Morning Star Technologies, Inc. Copyright 1996 Progressive Systems, Inc. Trademark Notices Intel and Itanium are registered trademarks of Intel Corporation in the US and other countries and are used under license. Java is a US trademark of Sun Microsystems, Inc. Microsoft and MS-DOS are U.S. registered trademarks of Microsoft Corporation. OSF/Motif is a trademark of The Open Group in the US and other countries. UNIX is a registered trademark of The Open Group.
Preface HP-UX is the Hewlett-Packard Company’s implementation of a UNIX operating system that is compatible with various industry standards. It is based on the System V Release 4 operating system and includes important features from the Fourth Berkeley Software Distribution. The ten volumes of this manual contain the system reference documentation, made up of individual entries called manpages, named for the man command (see man (1)) that displays them on the system.
Typographical Conventions audit (5) An HP-UX manpage reference. For example, audit is the name and 5 is the section in the HP-UX Reference. On the web and on the Instant Information CD, it may be a hyperlink to the manpage itself. From the HP-UX command line, you can enter “man audit” or “man 5 audit” to view the manpage. See man (1). Book Title The title of a book. On the web and on the Instant Information CD, it may be a hyperlink to the book itself.
Command Syntax Literal A word or character that you enter literally. Replaceable A word or phrase that you replace with an appropriate value. -chars One or more grouped command options, such as -ikx. The chars are usually a string of literal characters that each represent a specific option. For example, the entry -ikx is equivalent to the individual options -i, -k, and -x. The plus character (+) is sometimes used as an option prefix. -word A single command option, such as -help.
Function Synopsis and Syntax HP-UX functions are described in a definition format rather than a usage format. The definition format includes type information that is omitted when the function call is actually included in a program. The function syntax elements are the same as for commands, except for the options; see “Command Syntax” on page 7. Function General Definition The general definition form is: type func ( type param [ , type param ]...
Revision History Part Number Release; Date; Format; Distribution B2355-60130 HP-UX 11i Version 3; February 2007; one volume HTML; http://docs.hp.com and Instant Information. B2355-91017-26 HP-UX 11i Version 3; February 2007; ten volumes PDF; http://docs.hp.com, Instant Information and print. B2355-60127 HP-UX 11i Version 1; September 2005 Update; one volume HTML; http://docs.hp.com and Instant Information. B2355-90902-11 HP-UX 11i Version 1; September 2005 Update; ten volumes PDF; http://docs.hp.
Volume Six Table of Contents Section 3
Volume Six Table of Contents Section 3
Table of Contents Volumes Six and Seven Section 3: Library Functions Entry Name(Section): name Description intro(3C): intro ................................................................................ introduction to subroutines and libraries __data_start: last locations in program ...................................................................................... see end(3C) __text_start: last locations in program .....................................................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description _UNW_createContext(): allocate and deallocate unwind library data structure .................................................................................................. see _UNW_createContextForSelf(3X) _UNW_createContextForSelf(3X): _UNW_createContextForSelf(), _UNW_createContext(), _UNW_destroyContext() .....................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description acoshl(): arc hyperbolic cosine function (long double) .............................................................. see acosh(3M) acoshq(): arc hyperbolic cosine function (quad) ........................................................................ see acosh(3M) acoshw(): arc hyperbolic cosine function (extended) .................................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description annuityq(): present value factor for annuity (quad) ............................................................. see annuity(3M) annuityw(): present value factor for annuity (extended) ...................................................... see annuity(3M) asctime(): convert date and time to string ...............................................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description authdes_create(): obsolete library routine for RPC ............................................................ see rpc_soc(3N) authdes_getucred(): library routines for secure remote procedure calls ....................... see secure_rpc(3N) authdes_seccreate(): library routines for secure remote procedure calls ..................... see secure_rpc(3N) authnone_create(): library routines for client side rpc authentication ........
Table of Contents Volumes Six and Seven Entry Name(Section): name Description cargw(): complex argument function (extended) ......................................................................... see carg(3M) casin(3M): casin(), casinf(), casinl(), casinw(), casinq() ......................... complex arcsine functions casinf(): complex arcsine function (float) .................................................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description cimagl(): complex imaginary-part function (long double) ......................................................... see cimag(3M) cimagq(): complex imaginary-part function (quad) ................................................................... see cimag(3M) cimagw(): complex imaginary-part function (extended) ............................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description cmpt_getent(): map compartment name to number or number to name .................. see cmpt_getbynum(3) cmpt_setent(): map compartment name to number or number to name .................. see cmpt_getbynum(3) color_content(): color manipulation functions ..................................................... see can_change_color(3X) color_set(): window attribute control functions .....................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description cprojq(): complex projection function (quad) ............................................................................ see cproj(3M) cprojw(): complex projection function (extended) ..................................................................... see cproj(3M) cr_close(3): cr_close() .................................................................................... close a crash dump descriptor cr_info(3): cr_info() ....
Table of Contents Volumes Six and Seven Entry Name(Section): name Description datalock(3C): datalock() ............................. lock process into memory after allocating data and stack space daylight(): convert date and time to string ............................................................................. see ctime(3C) dbm(3X): dbminit(), fetch(), store(), delete(), firstkey(), nextkey(), dbmclose() ........................................................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description dn_expand(): resolver routines ............................................................................................ see resolver(3N) doupdate(3X): doupdate(), refresh(), wnoutrefresh(), wrefresh() ............. refresh windows and lines drand48(3C): drand48(), erand48(), lrand48(), nrand48(), mrand48(), jrand48(), srand48(), seed48(), lcong48() ......................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description elf_next(3E): elf_next() .......................................... provide sequential archive member access for ELF files elf_nextscn(): get section information for ELF files ........................................................ see elf_getscn(3E) elf_rand(3E): elf_rand() .......................................................... random archive member access for ELF files elf_rawdata(): manipulate section data for ELF files ..
Table of Contents Volumes Six and Seven Entry Name(Section): name Description EvmConnCreate(3): EvmConnCreate(), EvmConnCreatePoster(), EvmConnCreateSubscriber(), EvmConnDestroy(), EvmConnFdGet() ............... establish or destroy connection with the EVM daemon EvmConnCreatePoster(): establish or destroy connection with the EVM daemon ... see EvmConnCreate(3) EvmConnCreateSubscriber(): establish or destroy connection with the EVM daemon .....................................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description EvmVarRelease(): manipulate event variables .................................................................. see EvmVarGet(3) EvmVarSet(): manipulate event variables .......................................................................... see EvmVarGet(3) EvmVarSetOpaque(): manipulate event variables ..............................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description fetch(): database subroutines ..................................................................................................... see dbm(3X) fetestexcept(3M): fetestexcept() ................................................................... test floating-point exceptions feupdateenv(3M): feupdateenv() ............................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description freenetconfigent(): get network configuration data base entry ................................. see getnetconfig(3N) freopen(): substitute a named file in place of an already open stream ...................................... see fopen(3S) frexp(3M): frexp(), frexpf(), frexpl(), frexpw(), frexpq() ......................................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description getclock(3C): getclock() ................................................................... get current value of system-wide clock getcwd(3C): getcwd() ................................................................. get path-name of current working directory getdate(3C): getdate(), getdate_r() ..................................................... convert user format date and time getdate_r(): convert user format date and time .
Table of Contents Volumes Six and Seven Entry Name(Section): name Description getprdfent(3): getprdfent(), getprdfnam(), setprdfent(), endprdfent(), putprdfnam() ....................................... manipulate system default database entry for a trusted system getprdfent(): return pointer for system default database for trusted system .................... see getprdfent(3) getprdfnam(): return pointer for system default database for trusted system ....................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description .................................................................................. get a multi-byte character string from the terminal getsubopt(3C): getsubopt() .......................................................................... parse suboptions from a string. gettimer(3C): gettimer() ............................................................................. get value of a per-process timer gettxt(3C): gettxt() ........
Table of Contents Volumes Six and Seven Entry Name(Section): name Description ........................................... provide textual representation of an opaque internal name to an application gss_display_status(3): gss_display_status() ................................................ provides an application with the textual representation of a GSSAPI status code that can be displayed to a user or used for logging gss_duplicate_name(3): gss_duplicate_name() ........................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description hg_context_switch_voluntary(): Mercury Library Interfaces to transfer data between user and kernel space in a lightweight manner ................................................................................................... see hg(3) hg_gethrcycles(): Mercury Library Interfaces to transfer data between user and kernel space in a lightweight manner ...............................................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description idcok(3X): idcok() ............................ enable or disable use of hardware insert- and delete-character features idlok(): terminal output control functions .............................................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description inet_pton(): Internet address manipulation routines .................................................................. see inet6(3N) init_colors(): color manipulation functions ......................................................... see can_change_color(3X) init_pair(): color manipulation functions ............................................................. see can_change_color(3X) initgroups(3C): initgroups() ................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description io_search(): interface for interacting with kernel I/O subsystem ............................................. see libIO(3X) io_search_array(): interface for interacting with kernel I/O subsystem ................................. see libIO(3X) io_search_array_batch(): interface for interacting with kernel I/O subsystem ..................... see libIO(3X) io_str_to_hw_path(): interface for interacting with kernel I/O subsystem ....
Table of Contents Volumes Six and Seven Entry Name(Section): name Description keypad(3X): keypad() ................................................................. enable/disable abbreviation of function keys killchar(): single-byte line kill character ........................................................................... see erasechar(3X) killwchar(): current line kill character ............................................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description lldiv(): long long integer division and remainder ......................................................................... see div(3C) llrint(3M): llrint(), llrintf(), llrintl(), llrintw(), llrintq() round to nearest long long functions llrintf(): round to nearest long long function (float) ............................................................... see llrint(3M) llrintl(): round to nearest long long function (long double) .
Table of Contents Volumes Six and Seven Entry Name(Section): name Description malloc(3C): malloc(), alloca(), calloc(), free(), mallinfo(), mallopt(), memorymap(), realloc(), valloc() ............................................. main memory allocator mallopt(): control memory space allocation ............................................................................ see malloc(3C) mblen(): multibyte characters and strings conversions .......................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description mvgetnstr(): get a multi-byte character length limited string from the terminal ...................... see getnstr(3X) mvgetstr(): get a multi-byte character string from the terminal ................................................. see getstr(3X) mvhline(): draw lines from single-byte characters and renditions ................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description mvwinsstr(): insert a multi-byte character into a window ........................................................ see insnstr(3X) mvwinstr(): input a multi-byte character string from a window ................................................. see innstr(3X) mvwinwstr(): input a string of wide characters from a window ................................................ see innwstr(3X) mvwprintw(): print formatted output in window .....
Table of Contents Volumes Six and Seven Entry Name(Section): name Description nlist_ia(3C): nlist(), nlist64() ......................................... get entries from name list on Integrity systems nlist_pa(3C): nlist(), nlist64() ........................................ get entries from name list on PA-RISC systems nocbreak(): input mode control functions ................................................................................. see cbreak(3X) nodelay(3X): nodelay() ..............................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description pow(3M): pow(), powf(), powl(), poww(), powq(), pown(), pownf(), pownl(), pownw(), pownq(), powlln(), powllnf(), powllnl(), powllnw(), powllnq() ........................................................................................................................................ power functions powf(): power function (float) ......................................................................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description ..................................................................................................................................... see privileges(3) privset_free(): privilege manipulation operations for checking and debugging purposes .....................................................................................................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description pthread_attr_setstack(): set stacksize and stackaddr attributes . see pthread_attr_getdetachstate(3T) pthread_attr_setstackaddr(): set stackaddr attribute ................. see pthread_attr_getdetachstate(3T) pthread_attr_setstacksize(): set stacksize attribute .................. see pthread_attr_getdetachstate(3T) pthread_cancel(3T): thread_cancel() .............................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description ..................................................................................................... see pthread_mutex_getspin_np(3T) pthread_mutex_init(3T): pthread_mutex_init(), pthread_mutex_destroy() ..................................................................................................................... initialize or destroy a mutex pthread_mutex_lock(3T): pthread_mutex_lock(), pthread_mutex_trylock() .
Table of Contents Volumes Six and Seven Entry Name(Section): name Description ........................................................................................................... see pthread_rwlock_rdlock(3T) pthread_rwlock_trywrlock(): attempt to lock a read-write lock for writing .......................................................................................................... see pthread_rwlock_wrlock(3T) pthread_rwlock_unlock(3T): pthread_rwlock_unlock() ..................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description ..................................................................................................... return a stream to a remote command rcmd(): return a stream to a remote command .......................................................................... see rcmd(3N) readdir(): get pointer to current entry in open directory ...................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description rnusers(3N): rnusers(), rusers() .................................. return information about users on remote machines round(3M): round(), roundf(), roundl(), roundw(), roundq() ....................................... round functions roundf(): round function (float) ............................................................................................... see round(3M) roundl(): round function (long double) ...................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description rpc_svc_create(3N): svc_control(), svc_create(), svc_destroy(), svc_dg_create(), svc_fd_create(), svc_raw_create(), svc_tli_create(), svc_tp_create(), svc_vc_create() ............................................... library routines for the creation of server handles, rpc rpc_svc_err(3N): svcerr_auth(), svcerr_decode(), svcerr_noproc(), svcerr_noprog(), svcerr_progvers(), svcerr_systemerr(), svcerr_weakauth() ......................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description secure_rpc(3N): authdes_getucred(), authdes_seccreate(), getnetname(), host2netname(), key_decryptsession(), key_encryptsession(), key_gendes(), key_setsecret(), key_secretkey_is_set(), netname2host(), netname2user(), user2netname() ........................................................ library routines for secure remote procedure calls seed48(): generate pseudo-random numbers ....................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description shl_findsym(): explicit load of shared libraries ................................................................... see shl_load(3X) shl_findsym(): explicit load of shared libraries for Integrity systems ............................. see shl_load_ia(3X) shl_findsym(): explicit load of shared libraries for PA-RISC systems ............................ see shl_load_pa(3X) shl_get(): explicit load of shared libraries ................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description sindf(): sine function of degree argument (float) ........................................................................ see sind(3M) sindl(): sine function of degree argument (long double) ............................................................. see sind(3M) sindq(): sine function of degree argument (quad) .......................................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description smfi_getsymval(3N): smfi_getsymval() ................................................. gets the value of a sendmail macro smfi_insheader(3N): smfi_insheader() ...................... prepends a header to the sendmail current message smfi_main(3N): smfi_main() .......................................................... passes control to the libmilter event loop smfi_opensocket(3N): smfi_opensocket() ..................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description strstr(): character string operations ....................................................................................... see string(3C) strtoacl(3C): strtoacl(), strtoacl_r(), strtoaclpatt(), strtoaclpatt_r(), aclentrystart ............. convert string form to access control list (ACL) structure, HFS file system only strtoacl_r(): convert string form to access control list (ACL) structure, HFS file system only ...............
Table of Contents Volumes Six and Seven Entry Name(Section): name Description svcerr_noprog(): library routine for server side remote procedure call errors .............. see rpc_svc_err(3N) svcerr_progvers(): library routine for server side remote procedure call errors .......... see rpc_svc_err(3N) svcerr_systemerr(): library routine for server side remote procedure call errors ........ see rpc_svc_err(3N) svcerr_weakauth(): library routine for server side remote procedure call errors ..........
Table of Contents Volumes Six and Seven Entry Name(Section): name Description tcdrain(): tty line control functions ...................................................................................... see tccontrol(3C) tcflow(): tty line control functions ........................................................................................ see tccontrol(3C) tcflush(): tty line control functions ......................................................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description uaddr2taddr(): generic transport name-to-address translation ..............................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description uwx_self_init_context(3X): uwx_self_init_context ........ initialize the current context for self-unwinding uwx_self_init_info(3X): uwx_self_init_info ............................................................... create and initialize a callback info structure for self-unwinding uwx_set_nofr(3X): uwx_set_nofr .................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description wchgat(): change renditions of characters in a window ................................................................ see chgat(3X) wclear(): clear a window .............................................................................................................. see clear(3X) wclrtobot(): clear from cursor to end of window ....................................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description wgetstr(): get a multi-byte character string from the terminal ................................................... see getstr(3X) whline(): draw lines from single-byte characters and renditions .................................................. see hline(3X) whline_set(): draw lines from complex characters and renditions ........................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description xdr_char(): library routine for external data representation .......................................... see xdr_simple(3N) xdr_complex(3N): xdr_array(), xdr_bytes(), xdr_opaque(), xdr_pointer(), xdr_reference(), xdr_string(), xdr_string(), xdr_vector(), xdr_wrapstring() ......................................................................................
Table of Contents Volumes Six and Seven Entry Name(Section): name Description yp_get_default_domain(): Network Information Service client interface ............................. see ypclnt(3C) yp_master(): Network Information Service client interface ..................................................... see ypclnt(3C) yp_match(): Network Information Service client interface ....................................................... see ypclnt(3C) yp_next(): Network Information Service client interface ........
Notes 64 Hewlett-Packard Company HP-UX 11i Version 3: February 2007
Section 3 Part 1 Library Functions A-M
Section 3 Part 1 Library Functions A-M
intro(3C) intro(3C) NAME intro - introduction to subroutines and libraries DESCRIPTION This section describes functions found in various libraries, other than those functions that directly invoke HP-UX system primitives, which are described in Section 2.
intro(3C) intro(3C) /usr/lib/hpuxXX/libelf.so (For Itanium-based systems.) ELF 32-bit and 64-bit shared libraries. /usr/lib/libm.a (For HP 9000 systems.) SVID3, XPG4.2, and ANSI C compliant math archive library. /usr/lib/libm.sl (For HP 9000 systems.) SVID3, XPG4.2, and ANSI C compliant math archive library. /usr/lib/hpuxXX/libm.so (For Itanium-based systems.) SVID3, XPG4.2, and ANSI C compliant 32-bit and 64-bit math shared libraries.
_UNW_createContextForSelf(3X) _UNW_createContextForSelf(3X) (Integrity Systems Only) NAME _UNW_createContextForSelf(), _UNW_createContext(), _UNW_destroyContext() - allocate and deallocate unwind library data structure SYNOPSIS _ #include
_UNW_createContextForSelf(3X) _UNW_createContextForSelf(3X) (Integrity Systems Only) valid user process instruction address including instruction addresses associated with __user_sendsig. Unwind_base (which is the location of the unwind header), and text_base, (which is the location at which the ELF .text segment is loaded), must each be full 64-bit addresses (as opposed to 32-bit un-swizzled pointers). Linkage_ptr is the (full 64-bit) value of a procedure’s GP register.
_UNW_createContextForSelf(3X) _UNW_createContextForSelf(3X) (Integrity Systems Only) EXAMPLES Example 1 Allocate and initialize an _Unwind_Context for unwinding the currently running process: #include #include
_UNW_currentContext(3X) _UNW_currentContext(3X) (Integrity Systems Only) _ NAME _UNW_currentContext(), _UNW_clear(), _UNW_jmpbufContext(), _UNW_setAR(), _UNW_setBR(), _UNW_setCFM(), _UNW_setFR(), _UNW_setGR(), _UNW_setGR_NaT(), _UNW_setIP(), _UNW_setPR(), _UNW_setPreds(), _UNW_step(), _UNW_FR_PhysicalNumber(), _UNW_GR_PhysicalNumber(), _UNW_PR_PhysicalNumber() - manipulate values in unwind library data structure SYNOPSIS #include
_UNW_currentContext(3X) _UNW_currentContext(3X) (Integrity Systems Only) meaning the client can now use the _UNW_set routines to initialize values in the _Unwind_Context. The Init state is discussed further in unwind(5). _UNW_setGR() initializes the value of numbered general register num to value in the _Unwind_Context pointed to by parameter p. The NAT bit for the register is set to _UNW_FALSE .
_UNW_currentContext(3X) _UNW_currentContext(3X) (Integrity Systems Only) The transition into the Init state happens when _UNW_clear() , _UNW_createContextForSelf(), or _UNW_createContext() is called. In the Init state, _UNW_set...
_UNW_currentContext(3X) _UNW_currentContext(3X) (Integrity Systems Only) can no longer step. This return code is produced when _UNW_step is called for any _Unwind_Context describing a procedure whose frame is marked with the bottom of stack convention — a saved return link of 0 (see Itanium Processor Family Software Conventions and Runtime Architecture, "Chapter 11.1 Unwinding the stack"). _UNW_OK _ All’s well. _UNW_STEP_ERROR Some generic problem occurred during step.
_UNW_currentContext(3X) _UNW_currentContext(3X) (Integrity Systems Only) Bad. See the STATES section in unwind(5). _UNW_STEP_NO_DESCRIPTOR_FOR_NON_LEAF The stack unwind library could not find an unwind descriptor for a procedure which the stack unwind library can prove is not a leaf procedure. All non-leaf procedures are required to have unwind descriptors.
_UNW_currentContext(3X) _UNW_currentContext(3X) (Integrity Systems Only) SEE ALSO U_STACK_TRACE(3X), _UNW_createContextForSelf(3X), _UNW_getGR(3X), unwind(5).
_UNW_getGR(3X) _UNW_getGR(3X) (Integrity Systems Only) NAME _UNW_getGR(), _UNW_getAR(), _UNW_getAlertCode(), _UNW_getBR(), _UNW_getCFM(), _UNW_getFR(), _UNW_getGR_NaT(), _UNW_getIP(), _UNW_getKernelSavedContext(), _UNW_getPR(), _UNW_getPreds(), _UNW_clearAlertCode() - query values in unwind library data structure _ SYNOPSIS #include
_UNW_getGR(3X) _UNW_getGR(3X) (Integrity Systems Only) _UNW_getKernelSavedContext() provides the means for a tool such as a kernel debugger to obtain some of the information it needs about a kernel interruption. The values are returned via a structure of type _UNW_KernelSavedContext structure from which the client can obtain the two fields, p10_abi_value and p10_context_value of the format P10 unwind descriptor.
a64l(3C) a64l(3C) NAME a64l( ), l64a( ) - convert between long integer and base-64 ASCII string SYNOPSIS #include long int a64l(const char *s); char *l64a(long int l); a Obsolescent Interface int l64a_r(long int l, char *buffer, int buflen); DESCRIPTION These functions are used to maintain numbers stored in base-64 ASCII characters. This is a notation by which long integers can be represented by up to six characters; each character represents a "digit" in a radix-64 notation.
abort(3C) abort(3C) NAME abort( ) - generate a software abort fault SYNOPSIS #include void abort(void); a DESCRIPTION abort() first closes all open files, streams, directory streams, and message catalogue descriptors, if possible, then causes the signal SIGABRT to be sent to the calling process. This may cause a core dump to be generated (see signal(2)). If the signal SIGABRT is caught, the handling function is executed.
abs(3C) abs(3C) NAME abs( ), labs( ), llabs( ), imaxabs( ) - return integer absolute value SYNOPSIS #include int abs(int i); long int labs(long int i); long long llabs(long long i); #include intmax_t imaxabs(intmax_t i); a DESCRIPTION abs() computes the absolute value of its integer operand. labs() computes the absolute value of its long integer operand. llabs() computes the absolute value of its long long integer operand.
aclsort(3C) aclsort(3C) NAME aclsort( ) - sort an Access Control List (JFS File Systems only) SYNOPSIS #include #include int aclsort(int nentries, int calclass, struct acl *aclbufp); a DESCRIPTION The aclsort() routine sorts JFS Access Control List (ACL) entries into the correct order to be accepted by the acl(2) system call.
aclsort(3C) aclsort(3C) AUTHOR aclsort() was developed by AT&T. a SEE ALSO acl(2), aclv(5).
acltostr(3C) acltostr(3C) NAME acltostr() - convert access control list (ACL) structure to string form (HFS File Systems only) SYNOPSIS #include char *acltostr(int nentries, const struct acl_entry acl[], int form); a Obsolescent Interface int acltostr_r( int nentries, const struct acl_entry acl[], int form, char *strbuf, int length); Remarks To ensure continued conformance with emerging industry standards, features described in this manual entry are likely to change in a future release.
acltostr(3C) acltostr(3C) fputs (acltostr (nentries, acl, FORM_SHORT), stdout); a WARNINGS The value returned by acltostr() is a pointer into a buffer, the contents of which are overwritten by subsequent calls to acltostr() by the same thread. acltostr_r() is an obsolescent interface supported only for compatibility with existing DCE applications. New multithreaded applications should use acltostr() . DEPENDENCIES acltostr() is only supported on HFS file system on standard HP-UX operating system.
acos(3M) acos(3M) NAME acos( ), acosf( ), acosl( ), acosw( ), acosq( ) - arccosine functions SYNOPSIS #include double acos(double x); float acosf(float x); a HP Integrity Server Only long double acosl(long double x); extended acosw(extended x); quad acosq(quad x); DESCRIPTION acos() returns the arccosine of x, in the range 0 to π. acosf() is a float version of acos() ; it takes a float argument and returns a float result.
acos(3M) acos(3M) STANDARDS CONFORMANCE acos() : SVID3, XPG4.
acosd(3M) acosd(3M) NAME acosd( ), acosdf( ), acosdl( ), acosdw( ), acosdq( ) - degree-valued arccosine functions SYNOPSIS #include double acosd(double x); float acosdf(float x); a HP Integrity Server Only long double acosdl(long double x); extended acosdw(extended x); quad acosdq(quad x); DESCRIPTION acosd() returns the degree-valued arccosine of x, in the range 0 to 180. acosdf() is a float version of acosd() ; it takes a float argument and returns a float result.
acosh(3M) acosh(3M) NAME acosh( ), acoshf( ), acoshl( ), acoshw( ), acoshq( ) - arc hyperbolic cosine functions SYNOPSIS #include double acosh(double x); a HP Integrity Server Only float acoshf(float x); long double acoshl(long double x); extended acoshw(extended x); quad acoshq(quad x); DESCRIPTION acosh() returns the arc hyperbolic cosine of x, in the range +zero to +INFINITY.
acps(3) acps(3) NAME ACPS - Access Control Policy Switch SYNOPSIS #include #include #include cc [flag]... file... -lacps [library]... a DESCRIPTION The Access Control Policy Switch (ACPS) provides a layer of separation between applications that must make authorization decisions and the underlying modules that provide a decision response by interpreting some form of pre-configured policy.
acps(3) acps(3) Credential Types ACPS_CRED_KERBTICKET ACPS_CRED_PASSWORD ACPS_CRED_PIN ACPS_CRED_SAML ACPS_CRED_X509CERT a Kerberos ticket encoded in ASN.1 DER. Cleartext password. Cleartext pin represented as a string. SAML credential assertion. Base64 ASCII encoded certificate. Subject Attributes ACPS_SUBATTR_ASSIGNEDROLES Comma-delineated list of (active) roles associated with the subject.
acps(3) acps(3) SEE ALSO acps_api(3), acps_spi(3), acps.conf(4), rbac(5).
acps_api(3) acps_api(3) NAME acps_api: acps_addenvattr(), acps_addobjattr(), acps_addopattr(), acps_addsubattr(), acps_addsubcred(), acps_checkauth(), acps_end(), acps_setobj(), acps_setop(), acps_setsubid(), acps_start() - ACPS Application Programming Interface a SYNOPSIS #include #include cc [flag]... file... -lacps [library]...
acps_api(3) acps_api(3) The subsequent calls to to acps_setX() and acps_addX() essentially encode information into the handle in preparation for a call to acps_checkauth(). The five pieces of information encoded are as follows: Identity Subject identification (for example a username, uid, or X.500 DN) and associated attributes (for example, role, groups). Credentials Operation Object Environment Subject credentials (for example, a password and/or Kerberos token). Operation and associated attributes.
acps_api(3) acps_api(3) return ret; } SEE ALSO acps(3), acps_spi(3).
acps_spi(3) acps_spi(3) NAME acps_spi: acpm_getenvattrs(), acpm_getobj(), acpm_getobjattrs(), acpm_getop(), acpm_getopattrs(), acpm_getsubattrs(), acpm_getsubcreds(), acpm_getsubid() - ACPS Service Provider Interface SYNOPSIS a #include #include cc [flag]... file... -lacps [library]...
acps_spi(3) acps_spi(3) EXAMPLES The following example illustrates a sample policy module that enforces the policy: "users Ron, Ren, and Bill may read or write the password object" #include #include
add_wch(3X) add_wch(3X) (ENHANCED CURSES) NAME add_wch, mvadd_wch, mvwadd_wch, wadd_wch — add a complex character and rendition to a window SYNOPSIS #include
add_wchnstr(3X) add_wchnstr(3X) (ENHANCED CURSES) NAME add_wchnstr, add_wchstr, mvadd_wchnstr, mvadd_wchstr, mvwadd_wchnstr, mvwadd_wchstr, wadd_wchnstr, wadd_wchstr — add an array of complex characters and renditions to a window a SYNOPSIS #include
addch(3X) addch(3X) (CURSES) NAME addch, mvaddch, mvwaddch, waddch — add a single-byte character and rendition to a window and advance the cursor SYNOPSIS a #include
addchnstr(3X) addchnstr(3X) (ENHANCED CURSES) NAME addchnstr, mvaddchnstr, mvwaddchnstr, waddchnstr — add length limited string of single-byte characters and renditions to a window a SYNOPSIS #include
addchstr(3X) addchstr(3X) (CURSES) NAME addchstr, mvaddchstr, mvwaddchstr, waddchstr — add string of single-byte characters and renditions to a window SYNOPSIS a #include
addnstr(3X) addnstr(3X) (ENHANCED CURSES) NAME addnstr, addstr, mvaddnstr, mvaddstr, mvwaddnstr, mvwaddstr, waddnstr, waddstr - add a string of multi-byte characters without rendition to a window and advance cursor a SYNOPSIS #include
addnwstr(3X) addnwstr(3X) (ENHANCED CURSES) NAME addnwstr, addwstr, mvaddnwstr, mvaddwstr, mvwaddnwstr, mvwaddwstr, waddnwstr, waddwstr — add a wide-character string to a window and advance the cursor SYNOPSIS a #include
addsev(3C) addsev(3C) NAME addsev() - define additional severities for formatting routines SYNOPSIS #include int addsev(int sev, const char *sev_string); a DESCRIPTION The addsev() routine allows the user to define additional severities to be used by formatting routines (see pfmt(3C)) in the standard message format. sev is the severity level. It must be between 5 and 255 inclusively. sev_string is a character string to be associated for this severity level.
annuity(3M) annuity(3M) (HP Integrity Server Only) NAME annuity( ), annuityf( ), annuityl( ), annuityw( ), annuityq( ) - present value factor for annuity SYNOPSIS #include
annuity(3M) annuity(3M) (HP Integrity Server Only) SEE ALSO compound(3M), exp(3M), expm1(3M), pow(3M), math(5). a STANDARDS CONFORMANCE These functions are not specified by any standard.
asin(3M) asin(3M) NAME asin( ), asinf( ), asinl( ), asinw( ), asinq( ) - arcsine functions SYNOPSIS #include double asin(double x); float asinf(float x); a HP Integrity Server Only long double asinl(long double x); extended asinw(extended x); quad asinq(quad x); DESCRIPTION asin() returns the arcsine of x, in the range −π/2 to π/2. asinf() is a float version of asin() ; it takes a float argument and returns a float result.
asin(3M) asin(3M) STANDARDS CONFORMANCE asin() : SVID3, XPG4.
asind(3M) asind(3M) NAME asind( ), asindf( ), asindl( ), asindw( ), asindq( ) - degree-valued arcsine functions SYNOPSIS #include double asind(double x); float asindf(float x); a HP Integrity Server Only long double asindl(long double x); extended asindw(extended x); quad asindq(quad x); DESCRIPTION asind() returns the degree-valued arcsine of x, in the range −90 to 90. asindf() is a float version of asind() ; it takes a float argument and returns a float result.
asinh(3M) asinh(3M) NAME asinh( ), asinhf( ), asinhl( ), asinhw( ), asinhq( ) - arc hyperbolic sine functions SYNOPSIS #include double asinh(double x); a HP Integrity Server Only float asinhf(float x); long double asinhl(long double x); extended asinhw(extended x); quad asinhq(quad x); DESCRIPTION asinh() returns the arc hyperbolic sine of x. Integrity Server Only asinhf() is a float version of asinh() ; it takes a float argument and returns a float result.
assert(3X) assert(3X) NAME assert( ) - verify program assertion SYNOPSIS #include void assert(int expression); a DESCRIPTION This macro is useful for putting diagnostics into programs. When it is executed, if expression is false (zero), assert() prints: Assertion failed: expression , file xyz , line nnn on the standard error output and aborts. In the error message, xyz is the name of the source file and nnn the source line number of the assert() statement.
atan(3M) atan(3M) NAME atan( ), atanf( ), atanl( ), atanw( ), atanq( ) - arctangent functions SYNOPSIS #include double atan(double x); float atanf(float x); a HP Integrity Server Only long double atanl(long double x); extended atanw(extended x); quad atanq(quad x); DESCRIPTION atan() returns the arctangent of x, in the range −π/2 to π/2. atanf() is a float version of atan() ; it takes a float argument and returns a float result.
atan2(3M) atan2(3M) NAME atan2( ), atan2f( ), atan2l( ), atan2w( ), atan2q( ) - arctangent and quadrant functions SYNOPSIS #include
atan2(3M) atan2(3M) If y is ±INFINITY and x is finite, atan2() returns ±π/2 respectively. If y is ±INFINITY and x is −INFINITY, atan2() returns ±3π/4 respectively. If y is ±INFINITY and x is +INFINITY, atan2() returns ±π/4 respectively. If x or y is NaN, atan2() returns NaN. a Whether atan2() raises the inexact exception is unspecified. ERRORS No errors are defined. SEE ALSO acos(3M), asin(3M), atan(3M), atan2d(3M), carg(3M), cos(3M), sin(3M), tan(3M), math(5).
atan2d(3M) atan2d(3M) NAME atan2d( ), atan2df( ), atan2dl( ), atan2dw( ), atan2dq( ) - degree-valued arctangent-and-quadrant functions SYNOPSIS #include double atan2d(double y, double x); float atan2df(float y, float x); a HP Integrity Server Only long double atan2dl(long double y, long double x); extended atan2dw(extended y, extended x); quad atan2dq(quad y, quad x); DESCRIPTION atan2d() is a degree-valued version of the atan2() function.
atan2d(3M) atan2d(3M) ERRORS No errors are defined. a SEE ALSO acosd(3M), asind(3M), atand(3M), atan2(3M), cosd(3M), sind(3M), tand(3M), math(5). STANDARDS CONFORMANCE These functions are not specified by any standard.
atand(3M) atand(3M) NAME atand( ), atandf( ), atandl( ), atandw( ), atandq( ) - degree-valued arctangent functions SYNOPSIS #include double atand(double x); float atandf(float x); a HP Integrity Server Only long double atandl(long double x); extended atandw(extended x); quad atandq(quad x); DESCRIPTION atand() returns the degree-valued arctangent of x, in the range −90 to 90. atandf() is a float version of atand() ; it takes a float argument and returns a float result.
atanh(3M) atanh(3M) NAME atanh( ), atanhf( ), atanhl( ), atanhw( ), atanhq( ) - arc hyperbolic tangent functions SYNOPSIS #include double atanh(double x); a HP Integrity Server Only float atanhf(float x); long double atanhl(long double x); extended atanhw(extended x); quad atanhq(quad x); DESCRIPTION atanh() returns the arc hyperbolic tangent of x. Integrity Server Only atanhf() is a float version of atanh() ; it takes a float argument and returns a float result.
atexit(3) atexit(3) NAME atexit - register a function to be called at program termination SYNOPSIS #include int atexit(void (*func)(void)); a DESCRIPTION atexit() registers the function func to be called, without arguments, at normal program termination. Functions registered by atexit() are called in reverse order of registration. An atexit() call during exit processing is always unsuccessful. The number of registered functions should not exceed ATEXIT_MAX as specified in .
attr_get(3X) attr_get(3X) (ENHANCED CURSES) NAME attr_get, attr_off, attr_on, attr_set, color_set, wattr_get, wattr_off, wattr_on, wattr_set, wcolor_set — window attribute control functions a SYNOPSIS #include
attroff(3X) attroff(3X) (CURSES) NAME attroff, attron, attrset, wattroff, wattron, wattrset — restricted window attribute control functions SYNOPSIS #include int attroff(int attrs); int attron(int attrs); int attrset(int attrs); int wattroff(WINDOW *win, int attrs); int wattron(WINDOW *win, int attrs); int wattrset(WINDOW *win, int attrs); a DESCRIPTION These functions manipulate the window attributes of the current or specified window.
basename(3C) basename(3C) NAME basename( ), dirname( ) - extract components of a path name SYNOPSIS #include char *basename(char *path); char *dirname(char *path); b DESCRIPTION basename() takes the path name pointed to by path and returns a pointer to the final component of the path name, deleting any trailing ’/’ characters. If the string consists entirely of ’/’ characters, basename() returns a pointer to the string "/".
basename(3C) basename(3C) SEE ALSO basename(1), thread_safety(5). STANDARDS CONFORMANCE basename() : XPG4.2 dirname() : XPG4.
baudrate(3X) baudrate(3X) (CURSES) NAME baudrate — get terminal baud rate SYNOPSIS #include int baudrate(void); b DESCRIPTION The baudrate() function extracts the output speed of the terminal in bits per second. RETURN VALUE The baudrate() function returns the output speed of the terminal. ERRORS No errors are defined. SEE ALSO tcgetattr() (in the X/Open System Interfaces and Headers, Issue 4, Version 2 specification), . CHANGE HISTORY First released in X/Open Curses, Issue 2.
beep(3X) beep(3X) (CURSES) NAME beep — audible signal SYNOPSIS #include int beep(void); DESCRIPTION The beep() function alerts the user. It sounds the audible alarm on the terminal, or if that is not possible, it flashes the screen (visible bell). If neither signal is possible, nothing happens. RETURN VALUE The beep() function always returns OK. ERRORS No errors are defined. APPLICATION USAGE Nearly all terminals have an audible alarm, but only some can flash the screen.
bgets(3G) bgets(3G) NAME bgets() - read stream up to next delimiter SYNOPSIS #include char *bgets( char *buffer , size_t *count , FILE *stream , const char *breakstring ); b DESCRIPTION bgets reads characters from stream into buffer until either count is exhausted or one of the characters in breakstring is encountered in the stream. The read data is terminated with a null byte (\0 ) and a pointer to the trailing null is returned.
bigcrypt(3C) bigcrypt(3C) (TO BE OBSOLETED) NAME bigcrypt() - generate hashing encryption on large strings SYNOPSIS #include #include char *bigcrypt(char *key, char *salt); b DESCRIPTION bigcrypt() acts like crypt(3C), but handles much larger strings. bigcrypt() takes the segments of cleartext and encrypts them individually, at first using the salt passed in, and then using the first two characters of the previous encrypted segment as the salt for the next segment.
bkgd(3X) bkgd(3X) (ENHANCED CURSES) NAME bkgd, bkgdset, getbkgd, wbkgd, wbkgdset — set or get background character and rendition using a singlebyte character SYNOPSIS #include int bkgd(chtype ch); void bkgdset(chtype ch); chtype getbkgd(WINDOW *win); int wbkgd(WINDOW *win, chtype ch); void wbkgdset(WINDOW *win, chtype ch); b DESCRIPTION The bkgdset() and wbkgdset() functions set the background property of the current or specified window based on the information in ch.
bkgrnd(3X) bkgrnd(3X) (ENHANCED CURSES) NAME bkgrnd, bkgrndset, getbkgrnd, wbkgrnd, wbkgrndset, wgetbkgrnd — set or get background character and rendition using a complex character SYNOPSIS #include
border(3X) border(3X) (ENHANCED CURSES) NAME border, wborder — draw borders from single-byte characters and renditions SYNOPSIS #include int border(chtype ls, chtype rs, chtype ts, chtype bs, chtype tl, chtype tr, chtype bl, chtype br); int wborder(WINDOW *win, chtype ls, chtype rs, chtype ts, chtype bs, chtype tl, chtype tr, chtype bl, chtype br); b DESCRIPTION The border() and wborder() functions draw a border around the edges of the current or specified window.
border_set(3X) border_set(3X) (ENHANCED CURSES) NAME border_set, wborder_set — draw borders from complex characters and renditions SYNOPSIS #include
box(3X) box(3X) (CURSES) NAME box — draw borders from single-byte characters and renditions SYNOPSIS #include int box(WINDOW *win, chtype verch, chtype horch); b DESCRIPTION The box() function draws a border around the edges of the specified window. This function does not advance the cursor position. This function does not perform special character processing. This function does not perform wrapping.
box_set(3X) box_set(3X) (ENHANCED CURSES) NAME box_set — draw borders from complex characters and renditions SYNOPSIS #include int box_set(WINDOW *win, const cchar_t *verch, const cchar_t *horch); DESCRIPTION The box_set() function draws a border around the edges of the specified window. This function does not advance the cursor position. This function does not perform special character processing. This function does not perform wrapping.
bsdproc(3C) bsdproc(3C) NAME bsdproc: killpg(), getpgrp(), setpgrp(), signal(), sigvec() - 4.2 BSD-compatible process control facilities SYNOPSIS #include
bsearch(3C) bsearch(3C) NAME bsearch( ) - binary search a sorted table SYNOPSIS #include void *bsearch( const void *key, const void *base, size_t nel, size_t size, int (*compar)(const void *, const void *) ); b DESCRIPTION bsearch() is a binary search routine generalized from Knuth (6.2.1) Algorithm B. It returns a pointer into a table indicating where a datum may be found. The table must be previously sorted in increasing order according to a provided comparison function.
bsearch(3C) bsearch(3C) node.string = str_space; while (scanf("%s", node.string) != EOF) { node_ptr = (struct node *)bsearch((void *)(&node), (void *)table, TABSIZE, sizeof(struct node), node_compare); if (node_ptr != NULL) { (void)printf("string = %20s, length = %d\n", node_ptr->string, node_ptr->length); } else { (void)printf("not found: %s\n", node.string); } } b } /* This routine compares two nodes based on an alphabetical ordering of the string field.
btowc(3C) btowc(3C) NAME btowc(), wctob() - conversion between single-byte and wide character SYNOPSIS #include #include wint_t btowc(int c ); int wctob(wint_t c ); b DESCRIPTION btowc() The btowc() function determines whether c constitutes a valid (one-byte) character in the initial shift state. wctob() The wctob() function determines whether c corresponds to a member of the extended character set whose character representation is a single byte when in the initial shift state.
bufsplit(3G) bufsplit(3G) NAME bufsplit() - split buffer into fields SYNOPSIS #include size_t bufsplit(char *buf, size_t n , char **a ); b DESCRIPTION bufsplit examines the buffer, buf, and assigns values to the pointer array, a, so that the pointers point to the first n fields in buf that are delimited by tabs or new-lines. To change the characters used to separate fields, call bufsplit with buf pointing to the string of characters, and n and a set to zero. For example, to use ’:’, ’.
bwtmps(3C) bwtmps(3C) NAME bwtmps: bwtmpname(), updatebwdb(), getbwent(), setbwent(), endbwent() - access and update routines for the wtmps and btmps databases SYNOPSIS #include void bwtmpname(char *file); int updatebwdb(struct utmps *utmps, size_t size); struct utmps * getbwent(size_t size); void setbwent(void); void endbwent(void); b DESCRIPTION getbwent() returns a pointer to a utmps structure.
bwtmps(3C) bwtmps(3C) WARNINGS Applications should not access the wtmps and btmps databases directly, but should use these functions as the structure written to these databases is a superset of the utmps structure. updatebwdb() does not update /var/adm/wtmp and /var/adm/btmp files. bwtmps(3C) interfaces load shared library libuseracct.so.1/libuseracct.1.
byteorder(3N) byteorder(3N) NAME htonl( ), htons( ), ntohl( ), ntohs( ) - convert values between host and network byte order SYNOPSIS #include _XOPEN_SOURCE_EXTENDED only #include unsigned long htonl(unsigned long hostlong); unsigned short htons(unsigned short hostshort); unsigned long ntohl(unsigned long netlong); unsigned short ntohs(unsigned short netshort); b DESCRIPTION These routines convert 16- and 32-bit quantities between network byte order and host byte order.
cabs(3M) cabs(3M) (HP Integrity Server Only) NAME cabs( ), cabsf( ), cabsl( ), cabsw( ), cabsq( ) - complex absolute value (also called norm, modulus, or magnitude) functions SYNOPSIS #include double cabs(double complex z); float cabsf(float complex z); long double cabsl(long double complex z); extended cabsw(extended complex z); quad cabsq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers. cabs() returns the complex absolute value of z.
cacos(3M) cacos(3M) (HP Integrity Server Only) NAME cacos( ), cacosf( ), cacosl( ), cacosw( ), cacosq( ) - complex arccosine functions SYNOPSIS #include double complex cacos(double complex z); float complex cacosf(float complex z); long double complex cacosl(long double complex z); extended complex cacosw(extended complex z); quad complex cacosq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers.
cacos(3M) cacos(3M) (HP Integrity Server Only) STANDARDS CONFORMANCE cacos() , cacosf() , cacosl() : ISO/IEC C99 (including Annex G, ‘‘IEC 60559-compatible complex arithmetic’’) c 146 Hewlett-Packard Company −2− HP-UX 11i Version 3: February 2007
cacosh(3M) cacosh(3M) (HP Integrity Server Only) NAME cacosh( ), cacoshf( ), cacoshl( ), cacoshw( ), cacoshq( ) - complex arc hyperbolic cosine functions SYNOPSIS #include double complex cacosh(double complex z); float complex cacoshf(float complex z); long double complex cacoshl(long double complex z); extended complex cacoshw(extended complex z); quad complex cacoshq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers.
cacosh(3M) cacosh(3M) (HP Integrity Server Only) STANDARDS CONFORMANCE cacosh() , cacoshf() , cacoshl() : ISO/IEC C99 (including Annex G, ‘‘IEC 60559-compatible complex arithmetic’’) c 148 Hewlett-Packard Company −2− HP-UX 11i Version 3: February 2007
can_change_color(3X) can_change_color(3X) (ENHANCED CURSES) NAME can_change_color, color_content, has_colors, init_color, init_pair, start_color, pair_content — color manipulation functions SYNOPSIS #include
can_change_color(3X) can_change_color(3X) (ENHANCED CURSES) User-Defined Colour Pairs Calling init_pair() defines or redefines colour-pair number pair to have foreground colour f and background colour b. Calling init_pair() changes any characters that were displayed in the colour pair’s old definition to the new definition and refreshes the screen. After defining the colour pair, the macro COLOR_PAIR (n) returns the value of colour pair n.
carg(3M) carg(3M) (HP Integrity Server Only) NAME carg( ), cargf( ), cargl( ), cargw( ), cargq( ) - complex argument (also called phase angle) functions SYNOPSIS #include double carg(double complex z); float cargf(float complex z); long double cargl(long double complex z); extended cargw(extended complex z); quad cargq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers. carg() returns the complex argument of z in the interval [-pi,+pi].
casin(3M) casin(3M) (HP Integrity Server Only) NAME casin( ), casinf( ), casinl( ), casinw( ), casinq( ) - complex arcsine functions SYNOPSIS #include double complex casin(double complex z); float complex casinf(float complex z); long double complex casinl(long double complex z); extended complex casinw(extended complex z); quad complex casinq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers.
casinh(3M) casinh(3M) (HP Integrity Server Only) NAME casinh( ), casinhf( ), casinhl( ), casinhw( ), casinhq( ) - complex arc hyperbolic sine functions SYNOPSIS #include double complex casinh(double complex z); float complex casinhf(float complex z); long double complex casinhl(long double complex z); extended complex casinhw(extended complex z); quad complex casinhq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers.
catan(3M) catan(3M) (HP Integrity Server Only) NAME catan( ), catanf( ), catanl( ), catanw( ), catanq( ) - complex arctangent functions SYNOPSIS #include double complex catan(double complex z); float complex catanf(float complex z); long double complex catanl(long double complex z); extended complex catanw(extended complex z); quad complex catanq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers.
catan(3M) catan(3M) (HP Integrity Server Only) STANDARDS CONFORMANCE catan() , catanf() , catanl() : ISO/IEC C99 (including Annex G, ‘‘IEC 60559-compatible complex arithmetic’’) c HP-UX 11i Version 3: February 2007 −2− Hewlett-Packard Company 155
catanh(3M) catanh(3M) (HP Integrity Server Only) NAME catanh( ), catanhf( ), catanhl( ), catanhw( ), catanhq( ) - complex arc hyperbolic tangent functions SYNOPSIS #include double complex catanh(double complex z); float complex catanhf(float complex z); long double complex catanhl(long double complex z); extended complex catanhw(extended complex z); quad complex catanhq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers.
catanh(3M) catanh(3M) (HP Integrity Server Only) STANDARDS CONFORMANCE catanh() , catanhf() , catanh() : ISO/IEC C99 (including Annex G, ‘‘IEC 60559-compatible complex arithmetic’’) c HP-UX 11i Version 3: February 2007 −2− Hewlett-Packard Company 157
catgets(3C) catgets(3C) NAME catgets( ) - get a program message SYNOPSIS #include char *catgets( nl_catd catd, int set_num, int msg_num, const char *def_str ); c DESCRIPTION The catgets() function reads message msg_num in set set_num from the message catalog identified by catd , a catalog descriptor returned from a previous call to catopen() (see catopen(3C)). If the call fails, def_str points to a default message string returned by catgets() .
catopen(3C) catopen(3C) NAME catopen( ), catclose( ) - open and close a message catalog for reading SYNOPSIS #include nl_catd catopen(const char *name, int oflag); int catclose(nl_catd catd); DESCRIPTION The catopen() function opens a message catalog and returns a catalog descriptor. The name specifies the name of the message catalog being opened. A name containing a slash (/) specifies a path name for the message catalog. Otherwise, the environment variable NLSPATH is used (see environ(5)).
catopen(3C) [ENAMETOOLONG] catopen(3C) The length of the specified path name exceeds PATH_MAX bytes, or the length of a component of the path name exceeds NAME_MAX bytes while _POSIX_NO_TRUNC is in effect. [ENFILE] The system file table is full. [ENOENT] The named catalog does not exist or the path is null. [ENOTDIR] A component of the path prefix is not a directory. catgets() can be used to provide default messages when called following a failed catopen() (see catgets(3C)).
cbreak(3X) cbreak(3X) (CURSES) NAME cbreak, nocbreak, noraw, raw — input mode control functions SYNOPSIS #include int cbreak(void); int nocbreak(void); int noraw(void); int raw(void); c DESCRIPTION The cbreak() function sets the input mode for the current terminal to cbreak mode and overrides a call to raw() . The nocbreak() function sets the input mode for the current terminal to Cooked Mode without changing the state of ISIG and IXON.
cbrt(3M) cbrt(3M) NAME cbrt( ), cbrtf( ), cbrtl( ), cbrtw( ), cbrtq( ) - cube root functions SYNOPSIS #include double cbrt(double x); float cbrtf(float x); c HP Integrity Server Only long double cbrtl(long double x); extended cbrtw(extended x); quad cbrtq(quad x); DESCRIPTION cbrt() computes the cube root of x. cbrtf() is a float version of cbrt() ; it takes a float argument and returns a float result.
ccos(3M) ccos(3M) (HP Integrity Server Only) NAME ccos( ), ccosf( ), ccosl( ), ccosw( ), ccosq( ) - complex cosine functions SYNOPSIS #include double complex ccos(double complex z); float complex ccosf(float complex z); long double complex ccosl(long double complex z); extended complex ccosw(extended complex z); quad complex ccosq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers. ccos() returns the complex cosine of z.
ccos(3M) ccos(3M) (HP Integrity Server Only) SEE ALSO cos(3M), cacos(3M), complex(5).
ccosh(3M) ccosh(3M) (HP Integrity Server Only) NAME ccosh( ), ccoshf( ), ccoshl( ), ccoshw( ), ccoshq( ) - complex hyperbolic cosine functions SYNOPSIS #include double complex ccosh(double complex z); float complex ccoshf(float complex z); long double complex ccoshl(long double complex z); extended complex ccoshw(extended complex z); quad complex ccoshq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers.
ccosh(3M) ccosh(3M) (HP Integrity Server Only) SEE ALSO cosh(3M), cacosh(3M), complex(5).
ceil(3M) ceil(3M) NAME ceil( ), ceilf( ), ceill( ), ceilw( ), ceilq( ) - ceiling functions SYNOPSIS #include double ceil(double x); HP Integrity Server Only float ceilf(float x); long double ceill(long double x); extended ceilw(extended x); quad ceilq(quad x); c DESCRIPTION The ceil() returns the smallest integer (represented as a double-precision number) not less than x. Integrity Server Only ceilf() is a float version of ceil() ; it takes a float argument and returns a float result.
cexp(3M) cexp(3M) (HP Integrity Server Only) NAME cexp( ), cexpf( ), cexpl( ), cexpw( ), cexpq( ) - complex exponential functions SYNOPSIS #include double complex cexp(double complex z); float complex cexpf(float complex z); long double complex cexpl(long double complex z); extended complex cexpw(extended complex z); quad complex cexpq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers. cexp() returns the complex base-e exponential of z.
cexp(3M) cexp(3M) (HP Integrity Server Only) SEE ALSO exp(3M), cis(3M), clog(3M), complex(5).
cfspeed(3C) cfspeed(3C) NAME cfgetospeed( ), cfsetospeed( ), cfgetispeed( ), cfsetispeed( ) - tty baud rate functions SYNOPSIS #include speed_t cfgetospeed(const struct termios *termios_p); int cfsetospeed(struct termios *termios_p, speed_t speed); speed_t cfgetispeed(const struct termios *termios_p); int cfsetispeed(struct termios *termios_p, speed_t speed); c DESCRIPTION These functions set and get the input and output speed codes in the termios structure referenced by termios_p .
chgat(3X) chgat(3X) (ENHANCED CURSES) NAME chgat, mvchgat, mvwchgat, wchgat — change renditions of characters in a window SYNOPSIS #include
chownacl(3C) chownacl(3C) NAME chownacl( ) - change owner and/or group represented in a file’s access control list (ACL) (HFS File Systems only) SYNOPSIS #include void chownacl( int nentries, const struct acl_entry *acl, uid_t olduid, gid_t oldgid, uid_t newuid, gid_t newgid ); c Remarks: To ensure continued conformance with emerging industry standards, features described in this manual entry are likely to change in a future release.
chownacl(3C) chownacl(3C) int nentries; struct acl_entry acl [NACLENTRIES]; struct stat statbuf; if (stat ("oldfile", & statbuf) < 0) error (...); if ((nentries = getacl ("oldfile", NACLENTRIES, acl)) < 0) error (...); c chownacl (nentries, acl, statbuf.st_uid, statbuf.st_gid, geteuid(), getegid()); if (setacl ("newfile", nentries, acl)) error (...); DEPENDENCIES chownacl() is only supported on HFS file system on standard HP-UX operating system. AUTHOR chownacl() was developed by HP.
cimag(3M) cimag(3M) (HP Integrity Server Only) NAME cimag( ), cimagf( ), cimagl( ), cimagw( ), cimagq( ) - the imaginary part of a complex value SYNOPSIS #include double cimag(double complex z); float cimagf(float complex z); long double cimagl(long double complex z); extended cimagw(extended complex z); quad cimagq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers. cimag() returns the imaginary part of z (as a real).
cis(3M) cis(3M) (HP Integrity Server Only) NAME cis( ), cisf( ), cisl( ), cisw( ), cisq( ) - complex value with unit magnitude and given angle (specified in radians) SYNOPSIS #include double complex cis(double x); float complex cisf(float x); long double complex cisl(long double x); extended complex cisw(extended x); quad complex cisq(quad x); c DESCRIPTION These functions are available only for Integrity servers.
clear(3X) clear(3X) (CURSES) NAME clear, erase, wclear, werase — clear a window SYNOPSIS #include int clear(void); int erase(void); int wclear(WINDOW *win); int werase(WINDOW *win); c DESCRIPTION The clear() , erase() , wclear() and werase() functions clear every position in the current or specified window.
clearenv(3C) clearenv(3C) NAME clearenv - clear the process environment SYNOPSIS #include int clearenv(void); DESCRIPTION clearenv() clears the process environment. No environment variables are defined immediately after a call to clearenv() . clearenv() modifies the value of the pointer environ. This means that copies of that pointer are invalid after a call to clearenv() .
clearok(3X) clearok(3X) (CURSES) NAME clearok(), idlok(), leaveok(), scrollok(), setscrreg(), wsetscrreg() - terminal output control functions SYNOPSIS #include int clearok(WINDOW *win , bool bf ); int idlok(WINDOW *win , bool bf ); int leaveok(WINDOW *win , bool bf ); int scrollok(WINDOW *win , bool bf ); int setscrreg(int top , int bot ); int wsetscrreg(WINDOW *win , int top , int bot ); c DESCRIPTION These functions set options that deal with output within Curses.
clock(3C) clock(3C) NAME clock() - report CPU time used SYNOPSIS #include clock_t clock(void); DESCRIPTION clock() returns the amount of CPU time (in microseconds) used since the first call to clock() . The time reported is the sum of the user and system times of the calling process and its terminated child processes for which it has executed wait() , system() , or pclose() (see wait(2), system (3S), and popen(3S)).
clog(3M) clog(3M) (HP Integrity Server Only) NAME clog( ), clogf( ), clogl( ), clogw( ), clogq( ) - complex natural (base-e) logarithm functions SYNOPSIS #include double complex clog(double complex z); float complex clogf(float complex z); long double complex clogl(long double complex z); extended complex clogw(extended complex z); quad complex clogq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers.
clog(3M) clog(3M) (HP Integrity Server Only) STANDARDS CONFORMANCE clog() , clogf() , clogl() : ISO/IEC C99 (including Annex G, ‘‘IEC 60559-compatible complex arithmetic’’) c HP-UX 11i Version 3: February 2007 −2− Hewlett-Packard Company 181
clrtobot(3X) clrtobot(3X) (CURSES) NAME clrtobot, wclrtobot — clear from cursor to end of window SYNOPSIS #include int clrtobot(void); int wclrtobot(WINDOW *win); c DESCRIPTION The clrtobot() and wclrtobot() functions erase all lines following the cursor in the current or specified window, and erase the current line from the cursor to the end of the line, inclusive. RETURN VALUE Upon successful completion, these functions return OK. Otherwise, they return ERR. ERRORS No errors are defined.
clrtoeol(3X) clrtoeol(3X) (CURSES) NAME clrtoeol, wclrtoeol — clear from cursor to end of line SYNOPSIS #include int clrtoeol(void); int wclrtoeol(WINDOW *win); DESCRIPTION The clrtoeol() and wclrtoeol() functions erase the current line from the cursor to the end of the line, inclusive, in the current or specified window. RETURN VALUE Upon successful completion, these functions return OK. Otherwise, they return ERR. ERRORS No errors are defined. SEE ALSO doupdate(3X), .
cmpt_change(3) cmpt_change(3) NAME cmpt_change(), cmpt_get() - set and get process’ compartment SYNOPSIS #include int cmpt_change(cmpt_t cid ); cmpt_t cmpt_get(pid_t pid ); c Parameters cid Compartment ID. pid Process ID of the target process or 0 for the calling process. DESCRIPTION The cmpt_change() and cmpt_get() functions query and manipulate the compartment of a process. The cmpt_get() function returns the given process’ compartment ID.
cmpt_change(3) cmpt_change(3) DEPENDENCIES These functions are a part of the libsec library. SEE ALSO cmpt_getbynum(3), cmpt_getbyname(3), compartments(4), compartments(5), privileges(5).
cmpt_get_ifcid(3) cmpt_get_ifcid(3) NAME cmpt_get_ifcid(), cmpt_get_addrcid() - get the compartment IDs associated with a network interfaces SYNOPSIS #include cmpt_t cmpt_get_ifcid(const char *ifname ); cmpt_t cmpt_get_addrcid(int family , void *addr , uint32_t mask) ; c Parameters ifname Pointer to network interface name string. family Address family of the ipaddress specified. Currently, the AF_INET and AF_INET6 address families are supported.
cmpt_get_peer_cid(3) cmpt_get_peer_cid(3) NAME cmpt_get_peer_cid(), cmpt_get_endpoint_cid() - get the compartment IDs for INET domain communications. SYNOPSIS #include #include cmpt_t cmpt_get_endpoint_cid(int s ); cmpt_t cmpt_get_peer_cid(int s ); c Parameters s INET domain socket or stream. DESCRIPTION The cmpt_get_endpoint_cid() and cmpt_get_peer_cid() functions return the compartments associated with an INET domain transport endpoint (a socket or a stream).
cmpt_getbynum(3) cmpt_getbynum(3) NAME cmpt_getbynum(), cmpt_endent(), cmpt_getbyname(), cmpt_getent(), cmpt_setent() - map compartment name to number or number to name SYNOPSIS #include
cmpt_getbynum(3) cmpt_getbynum(3) 0 Successful completion. -1 Function failed. errno is set to indicate the error. cmpt_getent() returns the following values: pointer Succesaful completions. Returns a non-null pointer to a cmpt_pair structure. NULL pointer Function failed or entries are exhausted. In case of an error, errno is set to indicate the error. cmpt_getent() sets errno to 0 and returns a null pointer when all entries have been exhausted.
cmpt_getbynum(3) cmpt_getbynum(3) exit(1); } /* get entries until a NULL returned */ while ( pair = cmpt_getent(&state) ) { printf("\nCompartment Nnumber : %d Name : %s\n", pair->cmpt_num, pair->cmpt_name); } c if (errno == 0) { printf("\nAll Entries printed\n"); } else { printf("\nError getting compartment entry\n"); } cmpt_endent(); } DEPENDENCIES These functions are a part of the libsec library, which can be linked with your executable with the -lsec option. SEE ALSO compartments(4), compartments(5).
COLS(3X) COLS(3X) (ENHANCED CURSES) NAME COLS — number of columns on terminal screen SYNOPSIS #include extern int COLS; DESCRIPTION The external variable COLS indicates the number of columns on the terminal screen. c SEE ALSO initscr(3X), . CHANGE HISTORY First released in X/Open Curses, Issue 4.
compound(3M) compound(3M) (HP Integrity Server Only) NAME compound( ), compoundf( ), compoundl( ), compoundw( ), compoundq( ) - compound interest factor SYNOPSIS #include
confstr(3C) confstr(3C) NAME confstr( ) - get string-valued configuration values SYNOPSIS #include size_t confstr(int name, char *buf, size_t len); DESCRIPTION confstr() provides a method for applications to get configuration-defined string values. Its use and purpose are similar to sysconf() (see sysconf(2)), except that it is used where string values rather than numeric values are returned. The name parameter can take on the following name values, which are defined in .
confstr(3C) confstr(3C) programming model with 32-bit int, long, pointer, and off_t types. _CS_XBS5_ILP32_OFFBIG_CFLAGS The set of initial options to be given to the cc and c89 utilities to build an application using a programming model with 32-bit int, long, and pointer types, and an off_t type using at least 64-bits.
confstr(3C) confstr(3C) _CS_POSIX_V6_ILP32_OFFBIG_CFLAGS The set of initial options to be given to the c99 utility to build an application using a programming model with 32-bit int, long, and pointer types, and an off_t type using at least 64 bits. _CS_POSIX_V6_ILP32_OFFBIG_LDFLAGS The set of final options to be given to the c99 utility to build an application using a programming model with 32-bit int, long, and pointer types, and an off_t type using at least 64 bits.
confstr(3C) confstr(3C) EXAMPLES The following code fragment calls confstr() to determine the correct buffer size for _CS_PATH , allocates space for this buffer, then gets the configuration value for _CS_PATH . #include #include size_t bufsize; char *buffer; c bufsize=confstr(_CS_PATH,NULL,(size_t)0); buffer=(char *)malloc(bufsize); confstr(_CS_PATH,buffer,bufsize); AUTHOR confstr() was developed by HP. FILES /usr/include/unistd.
conj(3M) conj(3M) (HP Integrity Server Only) NAME conj( ), conjf( ), conjl( ), conjw( ), conjq( ) - complex conjugate functions SYNOPSIS #include double complex conj(double complex z); float complex conjf(float complex z); long double complex conjl(long double complex z); extended complex conjw(extended complex z); quad complex conjq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers.
conv(3C) conv(3C) NAME toupper( ), tolower( ), _toupper( ), _tolower( ), toascii( ) - translate characters SYNOPSIS #include int toupper(int c); int tolower(int c); int _toupper(int c); int _tolower(int c); int toascii(int c); c DESCRIPTION toupper() and tolower() have as domain the range of getc(3S): the integers from −1 through 255. If the argument of toupper() represents a lower-case letter, the result is the corresponding upper-case letter.
conv(3C) conv(3C) ... } EXTERNAL INFLUENCES Locale The LC_CTYPE category determines the translations to be done. International Code Set Support Single-byte character code sets are supported. c AUTHOR conv() was developed by IBM, OSF, and HP. SEE ALSO ctype(3C), getc(3S), setlocale(3C), lang(5), thread_safety(5).
copylist(3G) copylist(3G) NAME copylist() - copy a file into memory SYNOPSIS #include char *copylist(const char *filenm , off_t *szptr ); DESCRIPTION copylist copies a list of items from a file into freshly allocated memory, replacing new-lines with null characters. It expects two arguments: a pointer filenm to the name of the file to be copied, and a pointer szptr to a variable where the size of the file will be stored. c Upon success, copylist returns a pointer to the memory allocated.
copysign(3M) copysign(3M) NAME copysign( ), copysignf( ), copysignl( ), copysignw( ), copysignq( ) - copysign functions SYNOPSIS #include double copysign(double x, double y); float copysignf(float x, float y); c HP Integrity Server Only long double copysignl(long double x, long double y); extended copysignw(extended x, extended y); quad copysignq(quad x, quad y); DESCRIPTION The copysign() function returns x with its sign changed to the sign of y.
copywin(3X) copywin(3X) (CURSES) NAME copywin — copy a region of a window SYNOPSIS #include int copywin(const WINDOW *srcwin, WINDOW *dstwin, int sminrow, int smincol, int dminrow, int dmincol, int dmaxrow, int dmaxcol, int overlay); c DESCRIPTION The copywin() function provides a finer granularity of control over the overlay() and overwrite() functions.
cos(3M) cos(3M) NAME cos( ), cosf( ), cosl( ), cosw( ), cosq( ) - cosine functions SYNOPSIS #include double cos(double x); float cosf(float x); HP Integrity Server Only c long double cosl(long double x); extended cosw(extended x); quad cosq(quad x); DESCRIPTION cos() returns the cosine of x (x specified in radians). On PA-RISC systems, cos() may lose accuracy when x is far from zero. cosf() is a float version of cos() ; it takes a float argument and returns a float result.
cos(3M) cos(3M) cosf() , cosl() : ISO/IEC C99 (including Annex F, ‘‘IEC 60559 floating-point arithmetic’’) c 204 Hewlett-Packard Company −2− HP-UX 11i Version 3: February 2007
cosd(3M) cosd(3M) NAME cosd( ), cosdf( ), cosdl( ), cosdw( ), cosdq( ) - cosine functions of an argument specified in degrees SYNOPSIS #include double cosd(double x); float cosdf(float x); HP Integrity Server Only c long double cosdl(long double x); extended cosdw(extended x); quad cosdq(quad x); DESCRIPTION cosd() returns the cosine of x (x specified in degrees). On PA-RISC systems, cosd() may lose accuracy when x is far from zero.
cosh(3M) cosh(3M) NAME cosh( ), coshf( ), coshl( ), coshw( ), coshq( ) - hyperbolic cosine functions SYNOPSIS #include double cosh(double x); float coshf(float x); c HP Integrity Server Only long double coshl(long double x); extended coshw(extended x); quad coshq(quad x); DESCRIPTION cosh() returns the hyperbolic cosine of x. coshf() is a float version of cosh() ; it takes a float argument and returns a float result.
cot(3M) cot(3M) (HP Integrity Server Only) NAME cot( ), cotf( ), cotl( ), cotw( ), cotq( ) - cotangent functions SYNOPSIS #include double cot(double x); float cotf(float x); long double cotl(long double x); extended cotw(extended x); quad cotq(quad x); c DESCRIPTION These functions are available only for Integrity servers. cot() returns the cotangent of x (x specified in radians). cotf() is a float version of cot() ; it takes a float argument and returns a float result.
cotd(3M) cotd(3M) (HP Integrity Server Only) NAME cotd( ), cotdf( ), cotdl( ), cotdw( ), cotdq( ) - cotangent functions of an argument specified in degrees SYNOPSIS #include double cotd(double x); float cotdf(float x); long double cotdl(long double x); extended cotdw(extended x); quad cotdq(quad x); c DESCRIPTION These functions are available only for Integrity servers. cotd() returns the cotangent of x (x specified in degrees).
cpacl(3C) cpacl(3C) NAME cpacl(), fcpacl() - copy the access control list (ACL) and mode bits from one file to another (HFS and JFS File Systems only) SYNOPSIS #include
cpacl(3C) cpacl(3C) −1 Unable to perform acl() or getacl() (fgetacl() ) on a local fromfile (fromfd). −2 Unable to perform chmod() (fchmod() ) on tofile (tofd) to set its file miscellaneous mode bits. cpacl() (fcpacl() ) attempts this regardless of whether a file is local or remote, as long as fromfile (fromfd) is local. c −3 Unable to perform acl() or setacl() (fsetacl() ) on a local tofile (tofd).
cpow(3M) cpow(3M) (HP Integrity Server Only) NAME cpow( ), cpowf( ), cpowl( ), cpoww( ), cpowq( ) - complex power functions SYNOPSIS #include
cproj(3M) cproj(3M) (HP Integrity Server Only) NAME cproj( ), cprojf( ), cprojl( ), cprojw( ), cprojq( ) - functions that project all infinities onto the one on the positive real axis SYNOPSIS #include double complex cproj(double complex z); float complex cprojf(float complex z); long double complex cprojl(long double complex z); extended complex cprojw(extended complex z); quad complex cprojq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers.
cr_close(3) cr_close(3) NAME cr_close - close a crash dump descriptor SYNOPSIS #include int cr_close(CRASH *crash_cb); DESCRIPTION The cr_close() function closes the crash dump descriptor structure pointed to by crash_cb. The crash_cb structure is a crash dump descriptor filled in by a cr_open(3) call. All associated resources (memory and files) are released. RETURN VALUE Returns zero for success. Other possible return values are described in libcrash(5).
cr_info(3) cr_info(3) NAME cr_info - retrieve crash dump information SYNOPSIS #include cr_info_t *cr_info(CRASH *crash_cb); c DESCRIPTION The cr_info() function returns a pointer to a cr_info_t structure with information about an open crash dump. cr_info_t The cr_info_t structure contains the following fields. Note that there is no necessary correlation between the placement in this list and the order in the structure, and the structure may contain other, reserved fields.
cr_info(3) cr_info(3) #include CRASH *crshdes; cr_info_t *cri; cri = cr_info(crshdes); AUTHOR cr_info() was developed by HP. c SEE ALSO cr_open(3), libcrash(5).
cr_isaddr(3) cr_isaddr(3) NAME cr_isaddr - validate whether physical page number was dumped SYNOPSIS #include int cr_isaddr(CRASH *crash_cb, uint64_t pagenum, int *avail); c DESCRIPTION The cr_isaddr() checks to see if the specified page number, pagenum, is present in the open crash dump represented by crash_cb. It sets the Boolean to which avail points to indicate the presence (1) or absence (0) of the page. RETURN VALUE Returns zero for success.
cr_open(3) cr_open(3) NAME cr_open() - open crash dump for reading SYNOPSIS #include int cr_open(const char *path, CRASH **crash_cb, int flags); DESCRIPTION The cr_open() library call opens a crash dump and passes back a crash dump descriptor. The path argument points to a path name naming a crash dump directory or file, and must not exceed PATH_MAX bytes in length.
cr_perror(3) cr_perror(3) NAME cr_perror - print a libcrash error or warning message SYNOPSIS #include void cr_perror(CRASH *crash_cb, int error); DESCRIPTION cr_perror() prints to standard error an error or warning message corresponding to error, which should be the return value from an immediately previous call to one of the libcrash calls. The message describes the problem that occurred, explains its implications when appropriate, and gives corrective action where appropriate.
cr_read(3) cr_read(3) NAME cr_read - read from crash dump SYNOPSIS #include int cr_read(CRASH *crash_cb, void *buf, uint64_t mem_page, int *num_pages); DESCRIPTION The cr_read() function attempts to read the memory area defined by mem_page and num_pages into the buffer pointed to by buf from the crash dump opened using crash_cb. The cr_read() starts at the position in the crash dump associated with the physical memory offset given by mem_page.
cr_set_node(3) cr_set_node(3) NAME cr_set_node - set node number SYNOPSIS #include int cr_set_node(CRASH *crash_cb, int node_num, int *old_node_num); c DESCRIPTION The cr_set_node() function expects the physical node number passed in node_num . The node number will be used by cr_read() and cr_isaddr() to access the node private memory contained on a particular node. This function is only valid for ccnumadir (version 4) dumps.
cr_uncompress(3) cr_uncompress(3) NAME cr_uncompress - uncompress a file in a crash dump SYNOPSIS #include int cr_uncompress(CRASH *crash_cb, const char *pathname, uint64_t size, uint64_t checksum); DESCRIPTION The cr_uncompress() ensures that a file, part of a crash dump described by crash_cb, is uncompressed and matches its expected size and checksum (as computed by cksum(1)).
cr_verify(3) cr_verify(3) NAME cr_verify - verify integrity of crash dump SYNOPSIS #include int cr_verify(CRASH *crash_cb, int flags); DESCRIPTION cr_verify() uncompresses and verifies the sizes and checksums of every file in the crash dump identified by crash_cb. c flags is a bitmask of zero or more of the following flag values: CR_NOCHECKSUM cr_verify() will not attempt to verify checksums of files in the crash dump if this flag is set. Only sizes will be verified.
creal(3M) creal(3M) (HP Integrity Server Only) NAME creal( ), crealf( ), creall( ), crealw( ), crealq( ) - the real part of a complex value SYNOPSIS #include double creal(double complex z); float crealf(float complex z); long double creall(long double complex z); extended crealw(extended complex z); quad crealq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers. creal() returns the real part of z.
crt0(3) crt0(3) NAME crt0: crt0.o, gcrt0.o, mcrt0.o - execution startup routines SYNOPSIS Remarks For Integrity systems, see crt0_ia(3). For PA-RISC systems, see crt0_pa(3). Use the uname command to determine your system type. uname -m returns ia64 on Integrity systems. All other values represent PA-RISC systems. c SEE ALSO crt0_ia(3), crt0_pa(3), uname(1).
crt0_ia(3) crt0_ia(3) Integrity Systems Only NAME crt0_ia: crt0.o - execution startup routines for Integrity systems SYNOPSIS Remarks This manpage describes crt0.o for Integrity systems. For crt0.o on PA-RISC systems, see crt0_pa(3). DESCRIPTION The C, aC++, and FORTRAN compilers link in the object file crt0.o for statically-bound programs to provide startup capabilities and environments for program execution. It contains startup code that must be linked using ld to every statically-bound program.
crt0_pa(3) crt0_pa(3) PA-RISC Systems Only NAME crt0_pa: crt0.o, gcrt0.o, mcrt0.o - execution startup routines for PA-RISC systems SYNOPSIS Remarks PA-RISC 64-bit ELF uses crt0.o only. This manpage describes crt0.o on PA-RISC systems. For crt0.o on Integrity systems, see crt0_ia(3). c DESCRIPTION PA-RISC 32-bit SOM The C, Pascal, and FORTRAN compilers link in the object files crt0.o , gcrt0.o , or mcrt0.o to provide startup capabilities and environments for program execution.
crt0_pa(3) crt0_pa(3) PA-RISC Systems Only dependent libraries are initialized before the libraries that depend on them. Terminators, on the other hand, are invoked in the forward order. Unlike the SOM version of crt0.o , crt0.o for PA-RISC 64-bit ELF does not define any variables. It, however, sets the following global variables: _ _argc A variable of type long containing the number of arguments. _ _argv An array of character pointers to the arguments themselves.
crypt(3C) crypt(3C) NAME crypt - generate hashing encryption SYNOPSIS #include #include char *crypt(const char *key, const char *salt); c Obsolescent Interfaces char void void void void *crypt_r(const char *key, const char *salt, CRYPTD *cd); setkey_r(const char *key, CRYPTD *cd); encrypt_r(char block[64], int edflag, CRYPTD *cd); setkey(const char *key); encrypt(char block[64], int edflag); DESCRIPTION crypt( ): crypt() is the password encryption function.
csin(3M) csin(3M) (HP Integrity Server Only) NAME csin( ), csinf( ), csinl( ), csinw( ), csinq( ) - complex sine functions SYNOPSIS #include double complex csin(double complex z); float complex csinf(float complex z); long double complex csinl(long double complex z); extended complex csinw(extended complex z); quad complex csinq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers. csin() returns the complex sine of z.
csin(3M) csin(3M) (HP Integrity Server Only) SEE ALSO sin(3M), casin(3M), complex(5).
csinh(3M) csinh(3M) (HP Integrity Server Only) NAME csinh( ), csinhf( ), csinhl( ), csinhw( ), csinhq( ) - complex hyperbolic sine functions SYNOPSIS #include double complex csinh(double complex z); float complex csinhf(float complex z); long double complex csinhl(long double complex z); extended complex csinhw(extended complex z); quad complex csinhq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers. csinh() returns the complex hyperbolic sine of z.
csinh(3M) csinh(3M) (HP Integrity Server Only) SEE ALSO sinh(3M), casinh(3M), complex(5).
csqrt(3M) csqrt(3M) (HP Integrity Server Only) NAME csqrt( ), csqrtf( ), csqrtl( ), csqrtw( ), csqrtq( ) - complex square root functions SYNOPSIS #include double complex csqrt(double complex z); float complex csqrtf(float complex z); long double complex csqrtl(long double complex z); extended complex csqrtw(extended complex z); quad complex csqrtq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers.
ctan(3M) ctan(3M) (HP Integrity Server Only) NAME ctan( ), ctanf( ), ctanl( ), ctanw( ), ctanq( ) - complex tangent functions SYNOPSIS #include double complex ctan(double complex z); float complex ctanf(float complex z); long double complex ctanl(long double complex z); extended complex ctanw(extended complex z); quad complex ctanq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers. ctan() returns the complex tangent of z.
ctanh(3M) ctanh(3M) (HP Integrity Server Only) NAME ctanh( ), ctanhf( ), ctanhl( ), ctanhw( ), ctanhq( ) - complex hyperbolic tangent functions SYNOPSIS #include double complex ctanh(double complex z); float complex ctanhf(float complex z); long double complex ctanhl(long double complex z); extended complex ctanhw(extended complex z); quad complex ctanhq(quad complex z); c DESCRIPTION These functions are available only for Integrity servers.
ctermid(3S) ctermid(3S) NAME ctermid( ) - generate file name for terminal SYNOPSIS #include char *ctermid(char *s); DESCRIPTION ctermid() generates a string that, when used as a pathname, refers to the controlling terminal for the c current process. If s is a NULL pointer, the string is stored in an internal static area, the contents of which are overwritten at the next call to ctermid() , and the address of which is returned.
ctime(3C) ctime(3C) NAME ctime(), ctime_r(), asctime(), asctime_r(), daylight(), difftime(), gmtime(), gmtime_r(), localtime_r(), mktime(), timezone(), tzname(), tzset() - convert date and time to string localtime(), SYNOPSIS #include
ctime(3C) ctime(3C) below. The minimum date supported by gmtime() in both 32-bit and 64-bit HP-UX is Friday December 13 20:45:52 UTC 1901. The maximum dates supported by gmtime() are Tuesday January 19 03:14:07 UTC 2038 and Friday December 31 23:59:59 UTC 9999 in 32-bit HP-UX and 64-bit HP-UX, respectively. In 64-bit HP-UX, gmtime() returns NULL and sets errno to [ERANGE] if timer is less than the number of seconds that corresponds to the minimum date supported (i.e., INT_MIN , as defined in limits.
ctime(3C) ctime(3C) If the value of the timezone cannot be determined using the environment variable TZ or the file /etc/default/tz, it is set to the default value of EST5EDT. If the timezone is set to the default value of EST5EDT and the timezone adjustment file is not available, the timezone is set to a default value of UTC (Coordinated Universal Time). /etc/default/tz can be modified for an appropriate default value for timezone. The
ctime(3C) ctime(3C) never reflect any leap seconds. Upon successful completion, mktime() forces the value of the tm_sec component to the range [0,59]. AUTHOR ctime() was developed by AT&T and HP. SEE ALSO time(2), getdate(3C), setlocale(3C), strftime(3C), tztab(4), environ(5), lang(5), langinfo(5), thread_safety(5). c STANDARDS CONFORMANCE ctime() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C asctime() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.
ctype(3C) ctype(3C) NAME ctype: isalnum(), isalpha(), isascii(), isblank(), iscntrl(), isdigit(), isgraph(), islower(), isprint(), ispunct(), isspace(), isupper(), isxdigit() - classify characters according to type SYNOPSIS #include
ctype(3C) ctype(3C) International Code Set Support Single-byte character code sets are supported. c WARNINGS These functions are supplied both as library functions and as macros defined in the header. Normally, the macro versions are used. To obtain the library function, either use a #undef to remove the macro definition or, if compiling in ANSI-C mode, enclose the function name in parenthesis or take its address.
cur_term(3X) cur_term(3X) (ENHANCED CURSES) NAME cur_term — current terminal information SYNOPSIS #include extern TERMINAL *cur_term; DESCRIPTION The external variable cur_term identifies the record in the terminfo database associated with the terminal currently in use. SEE ALSO del_curterm(3X), tigetflag(3X), . CHANGE HISTORY First released in X/Open Curses, Issue 4.
curs_set(3X) curs_set(3X) (ENHANCED CURSES) NAME curs_set — set the cursor mode SYNOPSIS #include int curs_set(int visibility ); c DESCRIPTION The curs_set() function sets the appearance of the cursor based on the value of visibility: Value of visibility 0 1 2 Appearance of Cursor Invisible Terminal-specific normal mode Terminal-specific high visibility mode The terminal does not necessarily support all the above values.
curscr(3X) curscr(3X) (ENHANCED CURSES) NAME curscr — current window SYNOPSIS #include extern WINDOW *curscr; DESCRIPTION The external variable curscr points to an internal data structure. It can be specified as an argument to certain functions, such as clearok() , where permitted in this specification. SEE ALSO clearok(3X), . CHANGE HISTORY First released in X/Open Curses, Issue 4.
curses_intro(3X) curses_intro(3X) (X/Open CURSES) NAME curses_intro - terminal and printer handling and optimization package c DESCRIPTION Use and Implementation of Interfaces These routines provide a method for updating screens with reasonable optimization in a terminal independent manner. Each of the following statements applies unless explicitly stated otherwise in the detailed descriptions that follow.
curses_intro(3X) curses_intro(3X) (X/Open CURSES) visible all library functions referenced in this specification and labelled ENHANCED CURSES. An application that uses any API specified as ENHANCED CURSES must define _XOPEN_SOURCE_EXTENDED = 1 in each source file or as part of its compilation environment. When _XOPEN_SOURCE_EXTENDED = 1 is defined in a source file, it must appear before any header is included.
curses_intro(3X) curses_intro(3X) (X/Open CURSES) All the identifiers defined in this document that have external linkage are always reserved for use as identifiers with external linkage. No other identifiers are reserved. Applications must not declare or define identifiers with the same name as an identifier reserved in the same context.
curses_intro(3X) curses_intro(3X) (X/Open CURSES) empty wide-character string. Arrays of cchar_t objects are terminated by a null cchar_t object. WINDOW An opaque window representation. Interface Overview Components A Curses initialisation function, usually initscr() , determines the terminal model in use, by reference to either an argument or an environment variable. If that model is defined in terminfo , then the same terminfo entry tells Curses exactly how to operate the terminal.
curses_intro(3X) curses_intro(3X) (X/Open CURSES) Subwindows can be created from a parent window by calling subwin() . The position and size of subwindows on the screen must be identical to or totally within the parent window. Changes to either the parent window or the subwindow affect both. Window clipping is not a property of subwindows. Ancestors The term ancestor refers to a window’s parent, or its parent, or so on.
curses_intro(3X) curses_intro(3X) (X/Open CURSES) Rendition The rendition of a character displayed on the screen is its attributes and a colour-pair. The rendition of a character written to the screen becomes a property of the character and moves with the character through any scrolling and insert/delete line/character operations. To the extent possible on a particular terminal, a character’s rendition corresponds to the graphic rendition of the character put on the screen.
curses_intro(3X) curses_intro(3X) (X/Open CURSES) Window Rendition Each window has a rendition, which is separate from the rendition component of the window’s background property described below. Window Background Each window has a background property. The background property specifies: c • A spacing complex character (the background character) that will be used in a variety of situations where visible information is deleted from the screen.
curses_intro(3X) curses_intro(3X) (X/Open CURSES) The scrollok() function enables and disables scrolling. Some add functions move the cursor just beyond the end of the last character added. If this position is beyond the end of a line, it causes wrapping and scrolling under the conditions specified in the second bullet above. Insertion Insertion functions (such as insch() ) insert characters immediately before the character at the specified or implied cursor position.
curses_intro(3X) curses_intro(3X) (X/Open CURSES) Special Characters Some functions process special characters as specified below. In functions that do not move the cursor based on the information placed in the window, these special characters would only be used within a string in order to affect the placement of subsequent characters; the cursor movement specified below does not persist in the visible cursor beyond the end of the operation.
curses_intro(3X) curses_intro(3X) (X/Open CURSES) key must be done by the application. The complete set of key codes for keypad keys that Curses can process is specified by the constants defined in whose names begin with KEY_ . Each terminal type described in the terminfo database may support some or all of these key codes. The terminfo database specifies the sequence of input characters from the terminal type that correspond to each key code (see Keypad in terminfo(4)).
curses_intro(3X) curses_intro(3X) (X/Open CURSES) Raw Mode Raw mode gives the application maximum control over terminal input. The application sees each character as it is typed. This achieves the same effect as noncanonical mode, Case D input processing as specified in the X/Open System Interface Definitions, Issue 4, Version 2 specification . The ISIG and IXON flags are cleared upon entering this mode.
curses_intro(3X) curses_intro(3X) (X/Open CURSES) • A function with the basic name is often provided for historical compatibility and operates only on single-byte characters. A function with the same name plus the w infix operates on wide (multibyte) characters. A function with the same name plus the _w infix operates on complex characters and their renditions.
curses_intro(3X) curses_intro(3X) (X/Open CURSES) c s Y means these functions perform special-character processing (see Special Characters). N means they do not. ? means the results are unspecified when these functions are applied to special characters. w Y means these functions perform wrapping (see Truncation, Wrapping and Scrolling). N means they do not. c Y means these functions advance the cursor (see Truncation, Wrapping and Scrolling). N means they do not.
curses_intro(3X) curses_intro(3X) (X/Open CURSES) Input Because of the nature of operation of synchronous (block-mode) and NWA terminals, it might not be possible to support all or any of the Curses input functions. In particular, the following points should be noted: • Single-character input might not be possible. It may be necessary to press a special key to cause all characters typed at the terminal to be transmitted to the host. • It is sometimes not possible to disable echo.
cuserid(3S) cuserid(3S) (TO BE OBSOLETED) NAME cuserid( ) - get character login name of the user SYNOPSIS #include char *cuserid(char *s); c Remarks: Because this function behaved differently in previous releases of HP-UX, and behaves differently on other systems, its use is not recommended. It is provided only for conformance to current industry standards, and is subject to withdrawal in future releases of HP-UX.
datalock(3C) datalock(3C) NAME datalock( ) - lock process into memory after allocating data and stack space SYNOPSIS #include int datalock(size_t datsiz, size_t stsiz); DESCRIPTION datalock() allocates at least datsiz bytes of data space and stsiz bytes of stack space, then locks the program in memory. The data space is allocated by malloc() (see malloc(3C)). After the program is locked, this space is released by free() (see malloc(3C)), making it available for use.
dbm(3C) dbm(3C) NAME dbminit, fetch, store, delete, firstkey, nextkey, dbmclose - database subroutines SYNOPSIS #include int dbminit(const char *file); datum fetch(datum key); int store(datum key, datum content); int delete(datum key); datum firstkey(void); datum nextkey(datum key); void dbmclose(void); d DESCRIPTION These functions maintain key/content pairs in a database.
dbm(3C) dbm(3C) A store or delete during a pass through the keys by firstkey and nextkey may yield unexpected results. AUTHOR dbm(3C) was developed by the University of California, Berkeley. SEE ALSO ndbm(3X).
def_prog_mode(3X) def_prog_mode(3X) (CURSES) NAME def_prog_mode(), def_shell_mode(), reset_prog_mode(), reset_shell_mode() - save or restore program or shell terminal modes SYNOPSIS #include int def_prog_mode(void); int def_shell_mode(void); int reset_prog_mode(void); int reset_shell_mode(void); d DESCRIPTION The def_prog_mode() function saves the current terminal modes as the "program" (in Curses) state for use by reset_prog_mode().
del_curterm(3X) del_curterm(3X) (ENHANCED CURSES) NAME del_curterm(), restartterm(), set_curterm(), setupterm() - interfaces to the terminfo database SYNOPSIS #include int del_curterm(TERMINAL *oterm); int restartterm(char *term, int fildes, int *errret); TERMINAL *set_curterm(TERMINAL *nterm); int setupterm(char *term, int fildes, int *errret); extern TERMINAL *cur_term; d DESCRIPTION These functions retrieve information from the terminfo database.
del_curterm(3X) del_curterm(3X) (ENHANCED CURSES) SEE ALSO baudrate(3X), erasechar(3X), has_ic(3X), longname(3X), putc(3S), termattrs(3X), termname(3X), tgetent(3X), tigetflag(3X), use_env(3X), terminfo(4), see section Selecting a Terminal, .
delay_output(3X) delay_output(3X) (CURSES) NAME delay_output — delay output SYNOPSIS #include int delay_output(int ms); DESCRIPTION On terminals that support pad characters, delay_output() pauses the output for at least ms milliseconds. Otherwise, the length of the delay is unspecified. d RETURN VALUE Upon successful completion, delay_output() returns OK. Otherwise, it returns ERR. ERRORS No errors are defined.
delch(3X) delch(3X) (CURSES) NAME delch, mvdelch, mvwdelch, wdelch — delete a character from a window. SYNOPSIS d #include int delch(void); int mvdelch(int y, int x); int mvwdelch(WINDOW *win, int y, int x); int wdelch(WINDOW *win); DESCRIPTION These functions delete the character at the current or specified position in the current or specified window. This function does not change the cursor position. RETURN VALUE Upon successful completion, these functions return OK.
deleteln(3X) deleteln(3X) (CURSES) NAME deleteln, wdeleteln — delete lines in a window SYNOPSIS #include int deleteln(void); int wdeleteln(WINDOW *win); DESCRIPTION The deleteln() and wdeleteln() functions delete the line containing the cursor in the current or specified window and move all lines following the current line one line toward the cursor. The last line of the window is cleared. The cursor position does not change. RETURN VALUE Upon successful completion, these functions return OK.
delscreen(3X) delscreen(3X) (CURSES) NAME delscreen — free storage associated with a screen SYNOPSIS #include void delscreen(SCREEN *sp); DESCRIPTION The delscreen() function frees storage associated with the SCREEN pointed to by sp. d RETURN VALUE The delscreen() function does not return a value. ERRORS No errors are defined. SEE ALSO endwin(3X), initscr(3X), . CHANGE HISTORY First released in X/Open Curses, Issue 4.
delwin(3X) delwin(3X) (CURSES) NAME delwin — delete a window SYNOPSIS #include int delwin(WINDOW *win); DESCRIPTION The delwin() function deletes win, freeing all memory associated with it. The application must delete subwindows before deleting the main window. d RETURN VALUE Upon successful completion, delwin() returns OK. Otherwise, it returns ERR. ERRORS No errors are defined. SEE ALSO derwin(3X), dupwin(3X), . CHANGE HISTORY First released in X/Open Curses, Issue 2.
derwin(3X) derwin(3X) (CURSES) NAME derwin - relative window creation function SYNOPSIS #include WINDOW *derwin(WINDOW int begin_x); d *orig, int nlines, int ncols, int begin_y, DESCRIPTION The derwin() function creates a new window with nlines lines and ncols columns, positioned so that the origin is at (begin_y, begin_x) relative to the origin of the window orig. If any part of the new window is outside orig, the function fails and the window is not created.
devnm(3) devnm(3) NAME devnm - map device ID to file path SYNOPSIS #include int devnm ( mode_t devtype, dev_t devid, char *path, size_t pathlen, int cache ); d DESCRIPTION Given a device type, a device ID, and a string in which to return the result, devnm() maps the type and ID to a block or character special file (device file) name by searching /dev . It returns in path the full path name of the first special file encountered with a matching device type and ID.
devnm(3) devnm(3) SEE ALSO devnm(1M), stat(2), ftw(3C), malloc(3C), ttyname(3C), stat(5), thread_safety(5).
dial(3C) dial(3C) NAME dial(), undial() - establish an outgoing terminal line connection SYNOPSIS #include int dial(CALL call); void undial(int fd); DESCRIPTION The dial() function returns a file descriptor for a terminal line open for read/write. The argument to dial() is a CALL structure (defined in the header file). When finished with the terminal line, the calling program must invoke undial() to release the semaphore that has been set during the allocation of the terminal device.
dial(3C) d dial(3C) attr Pointer to a termio structure, as defined in the header file. A NULL value for this pointer element can be passed to the dial() function, but if such a structure is included, the elements specified in it are set for the outgoing terminal line before the connection is established. This is often important for certain attributes such as parity and baud rate. device Holds the device name that establishes the connection.
directory(3C) directory(3C) NAME directory: closedir(), opendir(), readdir(), readdir_r(), rewinddir(), seekdir(), telldir() - directory operations SYNOPSIS #include
directory(3C) d directory(3C) readdir_r() upon successful completion returns a 0. On successful return, the pointer returned at result has the same value as the argument entry . Upon reaching end of the directory stream, result has the value NULL. An error number is returned upon error. telldir() upon successful completion, returns a long value indicating the current position in the directory. Otherwise it returns -1 and sets errno to indicate the error.
directory(3C) directory(3C) dirp = opendir("."); while ((dp = readdir(dirp)) != NULL) { if (strcmp(dp->d_name, name) == 0) { (void) closedir(dirp); return FOUND; } } (void) closedir(dirp); return NOT_FOUND; WARNINGS readdir() and getdirentries() (see getdirentries(2)) are the only ways to access remote NFS directories. Attempting to read a remote directory via NFS by using read() returns -1 and sets errno to [EISDIR] (see read(2)).
div(3C) div(3C) NAME div( ), ldiv( ), lldiv( ), imaxdiv( ) - integer division and remainder SYNOPSIS #include div_t div(int numer, int denom); ldiv_t ldiv(long int numer, long int denom); lldiv_t lldiv(long long numer, long long denom); #include imaxdiv_t imaxdiv(intmax_t numer, intmax_t denom); d DESCRIPTION div() Computes the quotient and remainder of the division of the numerator numer by the denominator denom.
dladdr(3C) dladdr(3C) NAME dladdr() - get the symbolic information for an address SYNOPSIS cc [flag]... cfile ... -ldl [library]... #include int dladdr(void *address, Dl_info *dlip); Multithread Usage This routine is thread-safe. d DESCRIPTION dladdr() is one of a family of routines that give the user direct access to the dynamic linking facilities (using the -ldl option on the compiler or ld command line).
dladdr(3C) dladdr(3C) DIAGNOSTICS If no symbol is found within the load module containing address whose value is less than or equal to address, the dli_sname, dli_saddr, and dli_size fields are set to 0; the dli_bind field is set to STB_LOCAL , and the dli_type field is set to STT_NOTYPE . For a.out ’s, only a subset of externally visible symbols are typically exported: specifically those referenced by the load modules with which the a.out is linked.
dlclose(3C) dlclose(3C) NAME dlclose() - close a shared library SYNOPSIS cc [flag ... ] file ... -ldl [library]... #include int dlclose(void *handle); Multithread Usage This routine is thread-safe. NOTE: The dynamic loader serializes the loading and unloading of shared libraries in multithreaded applications using a recursive pthread mutex lock. See the HP-UX Linker and Libraries Online User Guide for more information.
dlclose(3C) dlclose(3C) d 284 Hewlett-Packard Company −2− HP-UX 11i Version 3: February 2007
dlerrno(3C) dlerrno(3C) (ELF Applications Only) NAME dlerrno() - get error code for dynamic linking calls SYNOPSIS cc [flag... ] file... -ldl [library]... #include int *dlerrno(void); DESCRIPTION dlerrno() is one of a family of routines that give the user direct access to the dynamic linking facilities (using the -ldl option on the compiler or ld command line). dlerrno() returns a numeric error code that corresponds to the last error that occurred during dynamic linking processing.
dlerrno(3C) dlerrno(3C) (ELF Applications Only) [RTLD_ERR_CODE_UNSAT] Unsatisfied code symbol in load module. [RTLD_ERR_DATA_UNSAT] Unsatisfied data symbol in load module. [RTLD_ERR_BAD_SYMNAME] Invalid symbol name for shl_findsym(). [RTLD_ERR_BAD_SYMTYPE] Invalid symbol type. [RTLD_ERR_SHL_LOAD_BAD_FLAGS] Invalid flags for shl_load() . [RTLD_ERR_BAD_TYPE_DEFINESYM] Invalid symbol type for shl_definesym(). d [RTLD_ERR_UNKNOWN_HANDLE] Unknown handle.
dlerrno(3C) dlerrno(3C) (ELF Applications Only) [RTLD_ERR_DLDD_COMM_FAILURE] Unable to get shared fixed address from dldd . [RTLD_ERR_BAD_DLL_SEGMENT_COUNT] Cannot use fixed address due to multiple data segments. [RTLD_ERR_SHL_LOAD_NULL_FILE_NAME] Invalid NULL library name. [RTLD_ERR_BAD_SHL_GETSYMBOLS_FLAG] Bad flags or type for shl_getsymbols(). [RTLD_ERR_INV_DLMODADD_ARGUMENT] Invalid argument for dlmodadd() .
dlerrno(3C) dlerrno(3C) (ELF Applications Only) [RTLD_ERR_ARCH_EXT_NOT_SUPPORTED] Cannot load library because required extensions not present in the hardware. MULTITHREAD USAGE This routine is thread-safe. SEE ALSO dlclose(3C), dlerror(3C), dlopen(3C), dlsym(3C).
dlerror(3C) dlerror(3C) NAME dlerror - get diagnostic information SYNOPSIS cc [flag ... ] file ... -ldl [library] ... #include char *dlerror(void); DESCRIPTION dlopen is one of a family of routines that give the user direct access to the dynamic linking facilities (using the -ldl option on the compiler or ld command line). dlerror returns a null-terminated character string (with no trailing newline) that describes the last error that occurred during dynamic linking processing.
dlget(3C) dlget(3C) (ELF Applications Only) NAME dlget() - retrieve information about a loaded module (program or shared library) SYNOPSIS cc [flag]... file... -ldl [library]... #include void *dlget(int index, struct load_module_desc *desc, size_t desc_size); d Multithread Usage This routine is thread-safe. DESCRIPTION dlget() is one of a family of routines that give the user direct access to the dynamic linking facilities. dlget() returns information about a loaded module for a process.
dlget(3C) dlget(3C) (ELF Applications Only) SEE ALSO System Tools exec(2) ld(1) Miscellaneous a.out(4) dlclose(3C) dlerror(3C) dlerrno(3C) dlgetname(3C) dlmodinfo(3C) dlopen(3C) dlsym(3C) System loader. Invokes the link editor. Assembler, compiler, and linker output. Unloads a shared library previously loaded by dlopen() . Prints the last error message recorded by dld . Returns an error code for the last error recorded by dld . Returns the name of the storage containing a load module.
dlgetfileinfo(3C) dlgetfileinfo(3C) NAME dlgetfileinfo() - return file information for a library prior to loading it SYNOPSIS cc [flag... ] file... #include -ldl [library]... uint64_t dlgetfileinfo(const char *file, size_t info_size, struct dlfileinfo *info); d Multithread Usage This routine is thread-safe. DESCRIPTION dlgetfileinfo() is one of a family of routines that give the user direct access to the dynamic linking facilities (using the -ldl option on the compiler or ld command line).
dlgetfileinfo(3C) dlgetfileinfo(3C) if (status == 0) { /* Make a copy of the library pathname returned by * dlgetfileinfo(). */ pathname = strdup(info.filename); /* Allocate data segment */ opts.data_addr = allocate_data(info.data_size); /* Not preallocating text segment */ opts.text_addr = 0; d /* Set dlopene() flags to indicate the data segment * has been preallocated. */ opts.
dlgetfileinfo(3C) dlgetfileinfo(3C) [RTLD_ERR_BAD_ABI1] ABI mismatch because a 64-bit program found a 32-bit shared library. [RTLD_ERR_BAD_ABI2] ABI mismatch because a 32-bit program found a 64-bit shared library. [RTLD_ERR_BAD_DLL_MAGIC_NUM] The library is invalid due to a bad magic number. [RTLD_ERR_BAD_DLL_BAD_MACHINE] The library is invalid due to a bad machine type. [RTLD_ERR_BAD_DLL_BAD_OBJFILE] The library is invalid due to a bad object file type.
dlgetmodinfo(3C) dlgetmodinfo(3C) NAME dlgetmodinfo() - retrieve information about a loaded module (program or shared library) SYNOPSIS cc [flag... ] file ... -ldl [library] ... #include uint64_t dlgetmodinfo(int index, struct load_module_desc *desc, size_t desc_size, void *(*read_tgt_mem)(void* buffer, uint64_t ptr, size_t bufsiz, int ident), int ident_parm, uint64_t load_map_parm); d Multithread Usage Thread safe in libdl.sl but not in libxpdl.sl .
dlgetmodinfo(3C) Miscellaneous a.out(4) dlclose(3C) dlerror(3C) dlerrno(3C) dlget(3C) dlgetname(3C) dlopen(3C) dlsym(3C) dlmodinfo(3C) d dlgetmodinfo(3C) Assembler, compiler, and linker output. Unloads a shared library previously loaded by dlopen() . Returns the last error message recorded by dld . Returns an error code for the last error recorded by dld . Returns information about a loaded module. Returns the name of the storage containing a load module. Loads a shared library.
dlgetname(3C) dlgetname(3C) (ELF Application Only) NAME dlgetname() - retrieve the name of a load module given a load module descriptor SYNOPSIS cc [flag]... file... -ldl [library]... #include char *dlgetname(struct load_module_desc *desc, size_t desc_size, void *(*read_tgt_mem)(void* buffer, unsigned long long ptr, size_t bufsiz, int ident), int ident_parm, unsigned long long load_map_parm); d Multithread Usage This routine is thread-safe.
dlgetname(3C) dlgetname(3C) (ELF Application Only) Texts and Tutorials HP-UX Linker and Libraries Online User Guide (See the +help option) HP-UX Linker and Libraries User’s Guide (See manuals(5) for ordering information) d 298 Hewlett-Packard Company −2− HP-UX 11i Version 3: February 2007
dlmodadd(3C) dlmodadd(3C) NAME dlmodadd() - register information about dynamically generated functions SYNOPSIS cc [flag]... file... -ldl [library]... #include void* dlmodadd(void* associate_handle, void *func_start, size_t func_size, void *linkage_ptr, void *unwind_info); d DESCRIPTION dlmodadd() registers information about a dynamically generated function, which can be retrived through dlmodinfo() . The dlmodremove() interface can be used to remove the registered information.
dlmodadd(3C) dlmodadd(3C) AUTHOR dlmodadd() was developed by HP. SEE ALSO ld(1), dlclose(3C), dlerrno(3C), dlerror(3C), dlget(3C), dlmodremove(3C), dlopen(3C), dlsym(3C), a.out(4), dld.so(5).
dlmodinfo(3C) dlmodinfo(3C) (ELF Applications Only) NAME dlmodinfo() - retrieve information about a loaded module (program or shared library) SYNOPSIS cc [flag]... file... -ldl [library]... #include uint64_t dlmodinfo(uint64_t ip_value, struct load_module_desc *desc, size_t desc_size, void *(*read_tgt_mem)(void* buffer, uint64_t ptr, size_t bufsiz, int ident), int ident_parm, uint64_t load_map_parm); d Multithread Usage Thread safe in libdl.sl but not in libxpdl.sl .
dlmodinfo(3C) dlmodinfo(3C) (ELF Applications Only) ERRORS If dlmodinfo() fails, a subsequent call to dlerrno() returns one of the following values: [RTLD_ERR_CANT_APPLY_RELOC] Cannot apply relocation in library. [RTLD_ERR_INV_ADDRESS] Invalid address. [RTLD_ERR_INV_BUFFER_ARGUMENT] Invalid descriptor argument [RTLD_ERR_INV_DESC_VERSION] Invalid descriptor version. [RTLD_ERR_NO_MEMORY] Out of memory. [RTLD_ERR_READ_TGT_MEM_FAILED] read_tgt_mem failed in reading target memory.
dlmodremove(3C) dlmodremove(3C) NAME dlmodremove() - remove information registered using dlmodadd SYNOPSIS cc [flag]... file... -ldl [library]... #include int dlmodremove(void* handle); Multithread Usage This routine is thread-safe. d DESCRIPTION dlmodremove() removes the registered information of individual dynamically generated functions. handle must be a handle returned by dlmodadd() .
dlopen(3C) dlopen(3C) NAME dlopen() - open a shared library SYNOPSIS Remarks For Integrity systems, see dlopen_ia(3C). For PA-RISC systems, see dlopen_pa(3C). Use the uname command to determine your system type. uname -m returns ia64 on Integrity systems. All other values represent PA-RISC systems. d SEE ALSO dlopen_ia(3C), dlopen_pa(3C), uname(1).
dlopen_ia(3C) dlopen_ia(3C) (Integrity Systems Only) NAME dlopen_ia: dlopen(), dlopene() - open a shared library on Integrity systems SYNOPSIS Command: cc [flag]... cfile... -ldl [library]... #include void *dlopen(const char *file, int mode); void *dlopene(const char *file, int mode, struct dlopen_opts *opts); Remarks This manpage describes dlopen() on Integrity systems. For dlopen() on HP 9000 systems, see dlopen_pa(3C). Multithread Usage These routines are thread-safe.
dlopen_ia(3C) dlopen_ia(3C) (Integrity Systems Only) RTLD_TEXT_PRIVATE Under this mode, the shared library loaded has its text segment mapped private. This can be useful for debugging. RTLD_LAZY Under this mode, only references to data symbols are relocated when the object is loaded. References to functions are not relocated until a given function is invoked for the first time.
dlopen_ia(3C) dlopen_ia(3C) (Integrity Systems Only) existing object. Symbols introduced into a program through calls to dlopen() may be used in relocation activities. Symbols so introduced may duplicate symbols already defined by the program or previous dlopen() operations. To resolve the ambiguities such a situation might present, the resolution of a symbol reference to a symbol definition is based on a symbol resolution order. Two such resolution orders are defined: load and dependency ordering.
dlopen_ia(3C) dlopen_ia(3C) (Integrity Systems Only) RETURN VALUE If file cannot be found, cannot be opened for reading, is not a shared object, or if an error occurs during the process of loading file or relocating its symbolic references, dlopen() returns NULL. More detailed diagnostic information is available through dlerror() or dlerrno() .
dlopen_ia(3C) dlopen_ia(3C) (Integrity Systems Only) [RTLD_ERR_IO] I/O error mapping library. [RTLD_ERR_LIB_OPEN] Unable to find library. [RTLD_ERR_MMAP_FAILED] mmap() failed for library. [RTLD_ERR_MPROTECT_FAILED] mprotect() failed for the library. [RTLD_ERR_NO_MEMORY] Out of memory. [RTLD_ERR_NOMMAP_FAILED] Encounter error while loading library (dlopene() only). d [RTLD_ERR_NON_TLS_RELOC_TO_TLS_SYM] Non-thread-specific relocation referencing TLS symbol. [RTLD_ERR_OPEN] Unable to open library.
dlopen_ia(3C) dlopen_ia(3C) (Integrity Systems Only) /* free memory */ munmap(opts.data_addr, info.data_size); } WARNINGS The environment variable LD_LIBRARY_PATH and SHLIB_PATH should contain a colon-separated list of directories, in the same format as the PATH variable (see sh(1)). LD_LIBRARY_PATH and SHLIB_PATH are ignored if the process’ real user id is different from its effective user id or its real group id is different from its effective group id (see exec(2)).
dlopen_pa(3C) dlopen_pa(3C) (HP 9000 Systems Only) NAME dlopen_pa: dlopen(), dlopene() - open an HP 9000 shared library; open an HP 9000 64-bit shared library with explicit load address SYNOPSIS Command: cc [flag]... cfile... -ldl [library]... #include void *dlopen(const char *file, int mode); void *dlopene(const char *file, int mode, struct dlopen_opts *opts); Remarks This manpage describes dlopen() on HP 9000 systems. For dlopen() on Integrity systems, see dlopen_ia(3C).
dlopen_pa(3C) dlopen_pa(3C) (HP 9000 Systems Only) #include #include main(int argc, char **argv) { char * str; shl_t shl; void (*fptr)(void); char *strpath[267]; sprintf(strpath, %s%s", SHLIB_PATH= ,argv[1]); putenv(strpath); dld_getenv(); shl = shl_load( a.sl", BIND_IMMEDIATE | DYNAMIC_PATH, 0); if(!shl) { printf("shl_load failed\n"); exit(-1); } } If the value of file is 0, dlopen() provides a handle on a "global symbol object".
dlopen_pa(3C) dlopen_pa(3C) (HP 9000 Systems Only) To determine the scope of symbols that are made available for relocation processing of objects loaded in a dlopen() invocation, the mode parameter can be bitwise or’ed with one of the following values: RTLD_GROUP Under this mode, the specified object, and its dependencies, behave as if they were built with -B group (see ld(1)). Only symbols from objects loaded in the same dlopen() invocation are made available for relocation.
dlopen_pa(3C) dlopen_pa(3C) (HP 9000 Systems Only) }; flags contains the load option, defined by the logical OR of the following values: RTLD_EXT_TEXT_ADDR Indicates that an explicit base address for the shared library text segment is provided. RTLD_EXT_DATA_ADDR Indicates that an explicit base address for the shared library private data segment is provided. RTLD_EXT_DATA_NO_ZERO_FILL If this flag is set, dlopene() does not zero fill the bss part of the data segment.
dlopen_pa(3C) dlopen_pa(3C) (HP 9000 Systems Only) [RTLD_ERR_CODE_UNSAT] Unsatisfied code symbol in library. [RTLD_ERR_DATA_UNSAT] Unsatisfied data symbol in library. [RTLD_ERR_DLDD_COMM_FAILURE] Library needs a shared fixed address but unable to obtain it from dldd . [RTLD_ERR_DLOPEN_BAD_FLAGS] Invalid flags for dlopen() . [RTLD_ERR_DLOPEN_TLS_LIB] Cannot dlopen() library because it contains TLS data. [RTLD_ERR_DLOPENE_BAD_ADDR] Invalid load address for segment (dlopene() only).
dlopen_pa(3C) dlopen_pa(3C) (HP 9000 Systems Only) int status; memset(&info, 0, sizeof(info)); memset(&opts, 0, sizeof(opts)); /* Get file info */ status = dlgetfileinfo("libfoo.so", sizeof(info), &info); opts.flags = RTLD_EXT_DATA_ADDR; /* allocate memory for the data segment */ opts.data_addr = (char*) mmap(0, info.data_size, PROT_READ|PROT_WRITE, MAP_SHARED|MAP_ANONYMOUS, -1, 0); d /* call dlopene */ handle = dlopene("libfoo.
dlsetlibpath(3C) dlsetlibpath(3C) NAME dlsetlibpath() - set the dynamic search path used to locate shared libraries SYNOPSIS cc [flag]... file... -ldl [library]... #include int dlsetlibpath(const char *libpath, int flags) Multithread Usage This routine is thread-safe. Calls to dlsetlibpath() affect all subsequent calls to dlopen() , dlopene() , and dlgetfileinfo(), on any thread.
dlsetlibpath(3C) dlsetlibpath(3C) EXAMPLES The following example illustrates the use of dlsetlibpath() to set the dynamic search path and disable other search paths. For simplicity, error checking has been omitted. #include int main() { void *handle; int status; int flags; /* Set dynamic search path and disable the embedded * path and the standard library directory.
dlsym(3C) dlsym(3C) NAME dlsym() - get the address of a symbol in shared library SYNOPSIS cc [flag]... file... -ldl [library]... #include void *dlsym(void *handle, const char *name); Multithread Usage This routine is thread-safe. DESCRIPTION dlsym() is one of a family of routines that give the user direct access to the dynamic linking facilities (using the -ldl option on the compiler or ld command line).
dlsym(3C) dlsym(3C) RTLD_NEXT to find the "real" malloc() , which would perform the actual memory allocation. Of course, this "real" malloc() could be another user-defined interface that added its own value and then used RTLD_NEXT to find the system malloc() . EXAMPLES The following example shows how you can use dlopen() and dlsym() to access either function or data objects. For simplicity, error checking has been omitted.
doupdate(3X) doupdate(3X) (CURSES) NAME doupdate, refresh, wnoutrefresh, wrefresh — refresh windows and lines SYNOPSIS #include int doupdate(void); int refresh(void); int wnoutrefresh(WINDOW *win); int wrefresh(WINDOW *win); DESCRIPTION The refresh() and wrefresh() functions refresh the current or specified window.
drand48(3C) drand48(3C) NAME drand48( ), erand48( ), lrand48( ), nrand48( ), mrand48( ), jrand48( ), srand48( ), seed48( ), lcong48( ) - generate uniformly distributed pseudo-random numbers SYNOPSIS #include
drand48(3C) drand48(3C) and jrand48() do not require an initialization entry point to be called first. All the routines work by generating a sequence of 48-bit integer values, X[i], according to the linear congruential formula X[n+1] = (a*X[n] + c) modulo m n>=0 The parameter m = 2ˆ48; hence 48-bit integer arithmetic is performed.
drand48(3C) drand48(3C) lrand48() : AES, SVID2, SVID3, XPG2, XPG3, XPG4 mrand48() : AES, SVID2, SVID3, XPG2, XPG3, XPG4 nrand48() : AES, SVID2, SVID3, XPG2, XPG3, XPG4 seed48() : AES, SVID2, SVID3, XPG2, XPG3, XPG4 srand48() : AES, SVID2, SVID3, XPG2, XPG3, XPG4 d 324 Hewlett-Packard Company −3− HP-UX 11i Version 3: February 2007
dupwin(3X) dupwin(3X) (ENHANCED CURSES) NAME dupwin — duplicate a window SYNOPSIS #include WINDOW *dupwin(WINDOW *win); DESCRIPTION The dupwin() function creates a duplicate of the window win. RETURN VALUE Upon successful completion, dupwin() returns a pointer to the new window. Otherwise, it returns a null pointer. ERRORS No errors are defined. SEE ALSO derwin(3X), doupdate(3X), . CHANGE HISTORY First released in X/Open Curses, Issue 4.
echo(3X) echo(3X) (CURSES) NAME echo, noecho — enable/disable terminal echo SYNOPSIS #include int echo(void); int noecho(void); e DESCRIPTION The echo() function enables Echo mode for the current screen. The noecho() function disables Echo mode for the current screen. Initially, curses software echo mode is enabled and hardware echo mode of the tty driver is disabled. RETURN VALUE Upon successful completion, these functions return OK. Otherwise, they return ERR. ERRORS No errors are defined.
echo_wchar(3X) echo_wchar(3X) (ENHANCED CURSES) NAME echo_wchar, wecho_wchar — write a complex character and immediately refresh the window SYNOPSIS #include int echo_wchar(const cchar_t *wch); int wecho_wchar(WINDOW *win, const cchar_t *wch); DESCRIPTION The echo_wchar() function is equivalent to calling add_wch() and then calling refresh() . The wecho_wchar() function is equivalent to calling wadd_wch() and then calling wrefresh() .
echochar(3X) echochar(3X) (ENHANCED CURSES) NAME echochar, wechochar — echo single-byte character and rendition to a window and refresh SYNOPSIS #include int echochar(const chtype ch); int wechochar(WINDOW *win, const chtype ch); DESCRIPTION The echochar() function is equivalent to a call to addch() followed by a call to refresh() . The wechochar() function is equivalent to a call to waddch() followed by a call to wrefresh() .
ecvt(3C) ecvt(3C) NAME ecvt( ), fcvt( ), gcvt( ) - convert floating-point number to string SYNOPSIS #include
ecvt(3C) ecvt(3C) ecvt_r() and fcvt_r() are obsolescent interfaces supported only for compatibility with existing DCE applications. New multi-threaded applications should use ecvt() and fcvt() . AUTHOR ecvt() and fcvt() were developed by AT&T. gcvt() was developed by AT&T and HP. SEE ALSO setlocale(3C), printf(3S), lang(5), thread_safety(5), glossary(9).
elf(3E) elf(3E) NAME elf - object file access library SYNOPSIS cc [flag... ] file... -lelf [library] ... #include DESCRIPTION Functions in the ELF access library let a program manipulate ELF (Executable and Linking Format) object files, archive files, and archive members. The header file provides type and function declarations for all library services. Programs communicate with many of the higher-level routines using an ELF descriptor.
elf(3E) elf(3E) Programs may translate data explicitly, taking full control over the object file layout and semantics. If the program prefers not to have and exercise complete control, the library provides a higher-level interface that hides many object file details. elf_begin and related functions let a program deal with the native memory types, converting between memory objects and their file equivalents automatically when reading or writing an object file.
elf(3E) elf(3E) ELF32_FSZ_TYPE These constants give the file sizes in bytes of the basic ELF types for the 32-bit class of files. See elf_fsize for more information. ELF64_FSZ_TYPE These constants give the file sizes in bytes of the basic ELF types for the 64-bit class of files. See elf_fsize for more information. ELF_K_KIND The function elf_kind identifies the KIND of file associated with an ELF descriptor.
elf_begin(3E) elf_begin(3E) NAME elf_begin() - make file descriptor for ELF file SYNOPSIS Command: cc [flag]... file... -lelf [library]... #include Elf *elf_begin( int fildes , Elf_Cmd cmd , Elf *ref ); e DESCRIPTION elf_begin() , elf_next() , elf_rand() , and elf_end() work together to process ELF object files, either individually or as members of archives.
elf_begin(3E) elf_begin(3E) descriptor. If, however, a program must process many files simultaneously and the underlying operating system limits the number of open files, the program can use elf_cntl() to let it reuse file descriptors. After calling elf_cntl() with appropriate arguments, the program may close the file descriptor without interfering with the library. All data associated with an ELF descriptor remain allocated until elf_end() terminates the descriptor’s last activation.
elf_begin(3E) elf_begin(3E) The following outline shows how one might create a new ELF file. This example is simplified to show the overall flow.
elf_cntl(3E) elf_cntl(3E) NAME elf_cntl - control a file descriptor SYNOPSIS cc [flag... ] file... -lelf [library] ... #include int elf_cntl(Elf *elf, Elf_Cmd cmd); DESCRIPTION elf_cntl instructs the library to modify its behavior with respect to an ELF descriptor, elf. As elf_begin(3E) describes, an ELF descriptor can have multiple activations, and multiple ELF descriptors may share a single file descriptor. Generally, elf_cntl commands apply to all activations of elf.
elf_end(3E) elf_end(3E) NAME elf_end - finish using an object file SYNOPSIS cc [flag... ] file... -lelf [library] ... #include int elf_end(Elf *elf); e DESCRIPTION A program uses elf_end to terminate an ELF descriptor, elf, and to deallocate data associated with the descriptor. Until the program terminates a descriptor, the data remain allocated. elf should be a value previously returned by elf_begin ; a null pointer is allowed as an argument, to simplify error handling.
elf_error(3E) elf_error(3E) NAME elf_errmsg, elf_errno - error handling SYNOPSIS cc [flag... ] file... -lelf [library] ... #include const char *elf_errmsg(int err); int elf_errno(void); DESCRIPTION If an ELF library function fails, a program may call elf_errno to retrieve the library’s internal error number. As a side effect, this function resets the internal error number to zero, which indicates no error.
elf_fill(3E) elf_fill(3E) NAME elf_fill - set fill byte SYNOPSIS cc [flag... ] file... -lelf [library] ... #include void elf_fill(int fill); e DESCRIPTION Alignment constraints for ELF files sometimes require the presence of ‘‘holes.’’ For example, if the data for one section are required to begin on an eight-byte boundary, but the preceding section is too ‘‘short,’’ the library must fill the intervening bytes. These bytes are set to the fill character.
elf_flag(3E) elf_flag(3E) NAME elf_flagdata, elf_flagehdr, elf_flagelf, elf_flagphdr, elf_flagscn, elf_flagshdr - manipulate flags SYNOPSIS cc [flag... ] file... #include unsigned unsigned unsigned unsigned unsigned unsigned -lelf [library] ...
elf_fsize(3E) elf_fsize(3E) NAME elf32_fsize, elf64_fsize - return the size of an object file type for elf32 files, return the size of an object file type for elf64 files, respectively. SYNOPSIS cc [flag... ] file... -lelf [library] ... #include size_t elf32_fsize(Elf_Type type, size_t count, unsigned ver); size_t elf64_fsize(Elf_Type type, size_t count, unsigned ver); DESCRIPTION elf32_fsize gives the size in bytes of the 32-bit file representation of count data objects with the given type.
elf_getarhdr(3E) elf_getarhdr(3E) NAME elf_getarhdr - retrieve archive member header SYNOPSIS cc [flag... ] file... -lelf [library] ... #include Elf_Arhdr *elf_getarhdr(Elf *elf); DESCRIPTION elf_getarhdr returns a pointer to an archive member header, if one is available for the ELF descriptor elf. Otherwise, no archive member header exists, an error occurred, or elf was null; elf_getarhdr then returns a null value. The header includes the following members.
elf_getarsym(3E) elf_getarsym(3E) NAME elf_getarsym - retrieve archive symbol table SYNOPSIS cc [flag... ] file... -lelf [library] ... #include Elf_Arsym *elf_getarsym(Elf *elf, size_t *ptr); DESCRIPTION elf_getarsym returns a pointer to the archive symbol table, if one is available for the ELF descriptor elf . Otherwise, the archive does not have a symbol table, an error occurred, or elf was null; elf_getarsym then returns a null value.
elf_getbase(3E) elf_getbase(3E) NAME elf_getbase - get the base offset for an object file SYNOPSIS cc [flag... ] file... -lelf [library] ... #include off_t elf_getbase(Elf *elf); DESCRIPTION elf_getbase returns the file offset of the first byte of the file or archive member associated with elf, if it is known or obtainable, and -1 otherwise. A null elf is allowed, to simplify error handling; the return value in this case is -1.
elf_getdata(3E) elf_getdata(3E) NAME elf_getdata, elf_newdata, elf_rawdata - get section data SYNOPSIS cc [flag... ] file... #include Elf_Data Elf_Data Elf_Data e -lelf [library] ... *elf_getdata(Elf_Scn *scn, Elf_Data *data); *elf_newdata(Elf_Scn *scn); *elf_rawdata(Elf_Scn *scn, Elf_Data *data); DESCRIPTION These functions access and manipulate the data associated with a section descriptor, scn. When reading an existing file, a section will have a single data buffer associated with it.
elf_getdata(3E) elf_getdata(3E) entire section will be aligned to the maximum of its constituents, thus ensuring appropriate alignment for a buffer within the section and within the file. d_version This member holds the version number of the objects in the buffer. When the library originally read the data from the object file, it used the working version to control the translation to memory objects. Data Alignment As mentioned above, data buffers within a section have explicit alignment constraints.
elf_getdata(3E) elf_getdata(3E) /* not a string table */ } data = 0; if ((data = elf_getdata(scn, data)) == 0 || data->d_size == 0) { /* error or no data */ } The e_shstrndx member in an ELF header holds the section table index of the string table. The program gets a section descriptor for that section, verifies it is a string table, and then retrieves the data. When this fragment finishes, data->d_buf points at the first byte of the string table, and data->d_size holds the string table’s size in bytes.
elf_getehdr(3E) elf_getehdr(3E) NAME elf_getehdr: elf32_getehdr(), elf32_newehdr(), elf64_getehdr(), elf64_newehdr() - retrieve class-dependent object file header for elf32 or elf64 file SYNOPSIS Command: cc [flag]... file... -lelf [library]... #include
elf_getehdr(3E) elf_getehdr(3E) elf64_newehdr() automatically sets the ELF_F_DIRTY bit (see elf_flag(3E)). A program may use elf_getident to inspect the identification bytes from a file. SEE ALSO elf(3E), elf_begin(3E), elf_flag(3E), elf_getident(3E).
elf_getident(3E) elf_getident(3E) NAME elf_getident - retrieve file identification data SYNOPSIS cc [flag... ] file... -lelf [library] ... #include char *elf_getident(Elf *elf, size_t *ptr); DESCRIPTION As elf(3E) explains, ELF provides a framework for various classes of files, where basic objects may have 32 bits, 64 bits, and so forth.
elf_getphdr(3E) elf_getphdr(3E) NAME elf32_getphdr, elf32_newphdr, elf64_getphdr, elf64_newphdr - retrieve class-dependent program header table for elf32 and elf64 files, respectively SYNOPSIS cc [flag... ] file... -lelf [library] ... #include
elf_getphdr(3E) elf_getphdr(3E) SEE ALSO elf(3E), elf_begin(3E), elf_flag(3E), elf_getehdr(3E).
elf_getscn(3E) elf_getscn(3E) NAME elf_getscn(), elf_ndxscn(), elf_newscn(), elf_nextscn() - get section information for ELF files SYNOPSIS Command: cc [flag]... file... -lelf [library]... #include Elf_Scn *elf_getscn( Elf *elf , size_t index ); size_t elf_ndxscn( Elf_Scn *scn ); Elf_Scn *elf_newscn( Elf *elf ); Elf_Scn *elf_nextscn( Elf * elf , Elf_Scn *scn ); e DESCRIPTION These functions provide indexed and sequential access to the sections associated with the ELF descriptor elf.
elf_getscn(3E) elf_getscn(3E) SEE ALSO elf(3E), elf_begin(3E), elf_flag(3E), elf_getdata(3E), elf_getehdr(3E), elf_getshdr(3E).
elf_getshdr(3E) elf_getshdr(3E) NAME elf32_getshdr, elf64_getshdr - retrieve class-dependent section header for elf32 and elf64 files, respectively SYNOPSIS cc [flag... ] file... -lelf [library] ... #include Elf32_Shdr *elf32_getshdr(Elf_Scn *scn); Elf64_Shdr *elf64_getshdr(Elf_Scn *scn); e DESCRIPTION For a 32-bit class file, elf32_getshdr returns a pointer to a section header for the section descriptor scn.
elf_hash(3E) elf_hash(3E) NAME elf_hash - compute hash value SYNOPSIS cc [flag... ] file... -lelf [library] ... #include unsigned long elf_hash(const char *name); DESCRIPTION elf_hash computes a hash value, given a null terminated string, name. The returned hash value, h, can be used as a bucket index, typically after computing h mod x to ensure appropriate bounds.
elf_kind(3E) elf_kind(3E) NAME elf_kind - determine file type SYNOPSIS cc [flag... ] file... -lelf [library] ... #include Elf_Kind elf_kind(Elf *elf); DESCRIPTION This function returns a value identifying the kind of file associated with an ELF descriptor elf. Currently defined values appear below. e ELF_K_AR The file is an archive (see ar(4)). An ELF descriptor may also be associated with an archive member, not the archive itself, and then elf_kind identifies the member’s type.
elf_next(3E) elf_next(3E) NAME elf_next - sequential archive member access SYNOPSIS cc [flag... ] file... -lelf [library] ... #include Elf_Cmd elf_next(Elf *elf); DESCRIPTION elf_next , elf_rand , and elf_begin manipulate simple object files and archives. elf is an ELF descriptor previously returned from elf_begin . elf_next provides sequential access to the next archive member.
elf_rand(3E) elf_rand(3E) NAME elf_rand - random archive member access SYNOPSIS cc [flag... ] file... -lelf [library] ... #include size_t elf_rand(Elf *elf, size_t offset); DESCRIPTION elf_rand , elf_next , and elf_begin manipulate simple object files and archives. elf is an ELF descriptor previously returned from elf_begin . elf_rand provides random archive processing, preparing elf to access an arbitrary archive member.
elf_rawfile(3E) elf_rawfile(3E) NAME elf_rawfile - retrieve uninterpreted file contents SYNOPSIS cc [flag... ] file... -lelf [library] ... #include char *elf_rawfile(Elf *elf, size_t *ptr); DESCRIPTION elf_rawfile returns a pointer to an uninterpreted byte image of the file. This function should be used only to retrieve a file being read. For example, a program might use elf_rawfile to retrieve the bytes for an archive member.
elf_strptr(3E) elf_strptr(3E) NAME elf_strptr - make a string pointer SYNOPSIS cc [flag... ] file... -lelf [library] ... #include char *elf_strptr(Elf *elf, size_t section, size_t offset); e DESCRIPTION This function converts a string section offset to a string pointer. elf identifies the file in which the string section resides, and section gives the section table index for the strings.
elf_update(3E) elf_update(3E) NAME elf_update - update an ELF descriptor SYNOPSIS cc [flag... ] file... -lelf [library] ... #include off_t elf_update(Elf *elf, Elf_Cmd cmd); DESCRIPTION elf_update causes the library to examine the information associated with an ELF descriptor, elf, and to recalculate the structural data needed to generate the file’s image. cmd may have the following values.
elf_update(3E) elf_update(3E) p_memsz p_flags p_align Member sh_name sh_type sh_flags sh_addr sh_offset Section Header e sh_size sh_link sh_info sh_addralign Notes Only when ELF_F_LAYOUT asserted Only when ELF_F_LAYOUT asserted Only when ELF_F_LAYOUT asserted sh_entsize Member Data Descriptor d_buf d_type d_size d_off Notes Only when ELF_F_LAYOUT asserted d_align d_version Note the program is responsible for two particularly important members (among others) in the ELF header.
elf_version(3E) elf_version(3E) NAME elf_version() - coordinate ELF library and application versions SYNOPSIS Command: cc [flag]... file... -lelf [library]... #include unsigned elf_version(unsigned ver ); DESCRIPTION As elf(3E) explains, the program, the library, and an object file have independent notions of the "latest" ELF version. elf_version() lets a program determine the ELF library’s internal version.
elf_xlate(3E) elf_xlate(3E) NAME elf32_xlatetof, elf32_xlatetom, elf64_xlatetof, elf64_xlatetom - class-dependent data translation for elf32 and elf64 files, respectively SYNOPSIS cc [flag... ] file... -lelf [library] ... #include
elf_xlate(3E) elf_xlate(3E) For elf32 files: Elf_Type 32-Bit Memory Type ELF_T_ADDR ELF_T_BYTE ELF_T_DYN ELF_T_EHDR ELF_T_HALF ELT_T_OFF ELF_T_PHDR ELF_T_REL ELF_T_RELA ELF_T_SHDR ELF_T_SWORD ELF_T_SYM ELF_T_WORD Elf32_Addr unsigned char Elf32_Dyn Elf32_Ehdr Elf32_Half Elf32_Off Elf32_Phdr Elf32_Rel Elf32_Rela Elf32_Shdr Elf32_Sword Elf32_Sym Elf32_Word e For elf64 files: Elf_Type 64-Bit Memory Type ELF_T_ADDR Elf64_Addr ELF_T_BYTE unsigned char ELF_T_DYN Elf64_Dyn ELF_T_EHDR Elf64_Ehdr ELF_T_HALF
end(3C) end(3C) NAME end, edata, etext, __data_start, __text_start - last locations in program SYNOPSIS extern void *_end, *end, *_etext, *__data_start, *__text_start; *etext, *_edata, *edata, DESCRIPTION These names refer neither to routines nor to locations with interesting contents. The address of the symbols _etext and etext is the first address above the program text. The address of _edata and edata is the first address above the initialized data region.
endwin(3X) endwin(3X) (CURSES) NAME endwin — suspend Curses session SYNOPSIS #include int endwin(void); DESCRIPTION The endwin() function restores the terminal after Curses activity by at least restoring the saved shell terminal mode, flushing any output to the terminal and moving the cursor to the first column of the last line of the screen. Refreshing a window resumes program mode. The application must call endwin() for each terminal being used before exiting.
erasechar(3X) erasechar(3X) (CURSES) NAME erasechar, killchar — single-byte terminal environment query functions SYNOPSIS #include char erasechar(void); char killchar(void); e DESCRIPTION The erasechar() function returns the current erase character. The erasewchar() function stores the current erase character in the object pointed to by ch. If no erase character has been defined, the function will fail and the object pointed to by ch will not be changed.
erasewchar(3X) erasewchar(3X) (ENHANCED CURSES) NAME erasewchar, killwchar — terminal environment query functions SYNOPSIS #include int erasewchar(wchar_t *ch); int killwchar(wchar_t *ch); DESCRIPTION The erasewchar() function stores the current erase character in the object pointed to by ch. If no erase character has been defined, the function will fail and the object pointed to by ch will not be changed.
erf(3M) erf(3M) NAME erf( ), erff( ), erfl( ), erfw( ), erfq( ), erfc( ), erfcf( ), erfcl( ), erfcw( ), erfcq( ) - error function and complementary error functions SYNOPSIS #include
erf(3M) erf(3M) If x is −INFINITY, erfc() returns 2.0. Whether erf() and erfc() raise the inexact exception is unspecified. If x is NaN, erf() and erfc() return NaN. ERRORS No errors are defined. SEE ALSO exp(3M), pow(3M), sqrt(3M), math(5). STANDARDS CONFORMANCE erf() , erfc() : SVID3, XPG4.
EvmConnCheck(3) EvmConnCheck(3) NAME EvmConnCheck(), EvmConnWait(), EvmConnDispatch(), EvmConnFlush() - maintain connection with the EVM daemon SYNOPSIS #include #include
EvmConnCheck(3) EvmConnCheck(3) EvmERROR_INVALID_ARGUMENT One of the arguments to the function is invalid. EvmERROR_INVALID_VALUE A value in a structure member is invalid. EvmERROR_NO_MEMORY EvmERROR_READ EvmERROR_WRITE EvmERROR_SELECT An operation failed because an attempt to acquire heap memory failed. EvmERROR_TIMEOUT EvmERROR_SIGNAL EvmERROR_QUEUED A timeout period expired. A read error occurred while reading from the EVM daemon connection.
EvmConnControl(3) EvmConnControl(3) NAME EvmConnControl() - control information for an EVM connection SYNOPSIS #include EvmStatus_t EvmConnControl( EvmConnection_t connection , EvmInt32_t request , void *arg ); Library EVM Support Library (libevm.so ). e Parameters connection The EVM connection to be controlled. See the EvmConnCreate(3) manpage. request The control action requested. See the DESCRIPTION section for the available requests.
EvmConnControl(3) EvmConnControl(3) EvmCONN_POST_NONBLOCK_SET Controls the behavior of the calling process if an attempt to post an event would overflow the connection’s send buffer. If this option is set to EvmFALSE (the default state when the connection is established), the process blocks as necessary to synchronize message transfer to the EVM daemon. If it is set to EvmTRUE , EvmEventPost() returns EvmERROR_QUEUED if an event cannot be sent fully without blocking.
EvmConnCreate(3) EvmConnCreate(3) NAME EvmConnCreate(), EvmConnCreatePoster(), EvmConnCreateSubscriber(), EvmConnFdGet() - establish or destroy connection with the EVM daemon EvmConnDestroy(), SYNOPSIS #include
EvmConnCreate(3) EvmConnCreate(3) and then invoke EvmConnDispatch() to handle the activity. In most cases, the connection’s callback function is invoked to handle incoming messages. This response mode must be used for listening connections. transport Specify the type of connection to be made to the daemon. Because EVM currently supports only local connection the daemon, this argument must always be set to NULL. If this argument is not NULL, an error occurs.
EvmConnCreate(3) EvmConnCreate(3) FILES /var/evm/sockets/evmd Default pathname for the domain socket. SEE ALSO Commands evmget(1), evmpost(1), evmwatch(1). Functions connect(2), select(2), socket(2). Routines EvmConnControl(3), EvmConnDispatch(3), EvmConnWait(3). e Event Management EVM(5). Event Callback EvmCallback(5). Event Connection EvmConnection(5). EVM Events EvmEvent(5). EVM Programmer’s Guide.
EvmConnSubscribe(3) EvmConnSubscribe(3) NAME EvmConnSubscribe(), EvmConnRegistrationGet(), EvmConnTemplateScan() - establish a subscription for event notification SYNOPSIS #include
EvmConnSubscribe(3) events, through the EvmConnSubscribe(3) connection’s callback function, with a reason code of EvmREASON_TEMPLATE_INFO_DELIVERED. The first time the function is called, a single event template is returned, if one is available. On subsequent calls that have the filter_string parameter set to NULL, the next matching template is returned. The next matching template continues to be returned until all templates that match the original filter_string have been returned.
EvmEventCreate(3) EvmEventCreate(3) NAME EvmEventCreate(), EvmEventCreateVa(), EvmEventDestroy(), EvmEventDup() - create and destroy events SYNOPSIS #include EvmStatus_t EvmEventCreate( EvmEvent_t *event ); EvmStatus_t EvmEventCreateVa( EvmEvent_t *event ); [ EvmItemId_t item_id , const EvmItemValue_t item_value ...
EvmEventCreate(3) EvmEventCreate(3) SEE ALSO Commands evmpost(1). Routines EvmConnCreate(3) EvmEventPost(3) EvmItemSet(3) EvmEventWrite(3). Event Management EVM(5). EVM Events EvmEvent(5).
EvmEventDump(3) EvmEventDump(3) NAME EvmEventDump() - dump an event in displayable form SYNOPSIS #include #include EvmStatus_t EvmEventDump( EvmConstEvent_t event , FILE *fd ); Library EVM Support Library (libevm.so ). Parameters event fd e The event for which a formatted dump is requested. All data items and variables contained in the event are displayed. Points to a FILE structure where the formatted event is to be dumped. This is usually stdout or stderr.
EvmEventFormat(3) EvmEventFormat(3) NAME EvmEventFormat(), EvmEventFormatFromTemplate(), EvmVarFormat() - format events for display SYNOPSIS #include
EvmEventFormat(3) EvmEventFormat(3) Any token of the form @item_name [%width] or @{ item_name [% width]} is replaced by the value of the corresponding data item from the supplied event, if it is present. item_name is the name of the item stored in the event. If width is supplied, the value occupies a minimum of width character positions. width is an integer number specifying the size of the value stored in item_name. The item_name is the name of a standard event data item.
EvmEventNameMatch(3) EvmEventNameMatch(3) NAME EvmEventNameMatch(), EvmEventNameMatchStr() - match EVM event name SYNOPSIS #include EvmStatus_t EvmEventNameMatch( const char *pattern , EvmEvent_t event , EvmBoolean_t *match ); EvmStatus_t EvmEventNameMatchStr( const char *pattern , const char *candidate , EvmBoolean_t *match ); e Library EVM Support Library (libevm.so ). Parameters pattern The event name pattern sought. The pattern may be any valid event name string.
EvmEventNameMatch(3) EvmEventNameMatch(3) Event Management EVM(5). EVM Events EvmEvent(5). EVM Programmer’s Guide.
EvmEventPost(3) EvmEventPost(3) NAME EvmEventPost(), EvmEventPostVa() - post an EVM event SYNOPSIS #include EvmStatus_t EvmEventPost( EvmConnection_t connection , const EvmEvent_t event ); EvmStatus_t EvmEventPostVa( EvmConnection_t connection , const EvmEvent_t event ); [EvmItemId_t item_id , const EvmItemValue_t item_id ]..., EvmITEM_NONE ); e Library EVM Support Library (libevm.so ). Parameters connection The connection through which events are posted. See EvmConnCreate(3).
EvmEventPost(3) EvmEventPost(3) RETURN VALUE EvmERROR_NONE EvmERROR_EVENT_REJECTED The operation completed without error. The EVM daemon rejected the event. The most likely reasons are that no template has been registered for the event, or that the caller is not authorized to post the event. See evmtemplate (4) and evm.auth (4) for more information. EvmERROR_INVALID_ARGUMENT One of the arguments to the function is invalid. EvmERROR_INVALID_VALUE A value in a structure member is invalid.
EvmEventRead(3) EvmEventRead(3) NAME EvmEventRead(), EvmEventWrite() - perform I/O of EVM events to and from a file SYNOPSIS #include EvmStatus_t EvmEventRead( EvmFd_t fd , EvmEvent_t *event ); EvmStatus_t EvmEventWrite( EvmFd_t fd , const EvmEvent_t event ); e Library EVM Support Library (libevm.so ). Parameters event fd For EvmEventRead(), the return operand created for the event read. For EvmEventWrite(), the event to be written.
EvmEventValidate(3) EvmEventValidate(3) NAME EvmEventValidate() - perform a data integrity check on an event SYNOPSIS #include EvmStatus_t EvmEventValidate( EvmEvent_t event ); Library EVM Support Library (libevm.so ). Parameters event The event to be validated. e DESCRIPTION The EvmEventValidate() routine performs a data integrity check on an event. The data integrity check intends to validate an event that was received over a connection or was retrieved from storage.
EvmFilterCreate(3) EvmFilterCreate(3) NAME EvmFilterCreate(), EvmFilterDestroy(), EvmFilterIsFile(), EvmFilterReadFile(), EvmFilterSet(), EvmFilterTest() - event filter evaluator routines SYNOPSIS #include
EvmFilterCreate(3) EvmFilterCreate(3) EvmTRUE The event matches the filter_string. EvmFALSE The event does not match the filter_string. The indirect filter syntax, @filename, is supported by the EvmFilterIsFile() and EvmFilter ReadFile() routines. Programs which support indirect filters may use EvmFilterIsFile() to determine whether a user-supplied filter string is indirect. If so, then use EvmFilterReadFile() to expand the file to a regular filter string.
EvmItemGet(3) EvmItemGet(3) NAME EvmItemGet(), EvmItemListFree(), EvmItemListGet(), EvmItemRelease(), EvmItemSet(), EvmItemSetVa() - create and manipulate event items SYNOPSIS #include
EvmItemGet(3) EvmITEM_REF EvmITEM_VAR EvmITEM_KERNEL_ONLY EvmItemGet(3) Reference Variables Kernel distribution Only It is also possible to supply a separate item_id for each of the supported variable types. In these cases, an extra one or two operands (depending on the type) must be supplied in addition to the item_value . See the description below for more information.
EvmItemGet(3) EvmItemGet(3) EvmERROR_NO_MEMORY An operation failed because an attempt to acquire heap memory failed. EvmERROR_NOT_PRESENT A request specified an item or variable name component in an itemList or a varList that is not part of the event being processed. ERRORS The value of errno is not set. SEE ALSO Commands evmshow(1). e Routines EvmEventCreate(3), EvmEventDestroy(3), EvmEventFormat(3), EvmEventPost(3). Event Management EVM(5). EVM Events EvmEvent(5). EVM Programmer’s Guide.
EvmSrvStart(3) EvmSrvStart(3) NAME EvmSrvStart(), EvmSrvMessageGet() - event service functions SYNOPSIS #include EvmStatus_t EvmSrvStart( char *service_name , char *arg_string , EvmTransport_t *transport , EvmConnection_t *connection ); EvmStatus_t EvmSrvMessageGet( EvmConnection_t connection , EvmEvent_t *event , char **msg , char **errmsg , EvmInt32_t *info ); e Remarks EvmSrvMessageGet is not currently supported for general use. Library EVM Support Library (libevm.so ).
EvmSrvStart(3) EvmSrvStart(3) In each of these cases, the data is returned to the caller only if the address passed to the function as the corresponding argument is not NULL. The function returns a non-null value in at most one of these return arguments, and sets the others to NULL. If the incoming message does not include data (for example, if it is a protocol message indicating that the service is terminating) all three of the arguments are set to NULL.
EvmStatusTextGet(3) EvmStatusTextGet(3) NAME EvmStatusTextGet() - format text version of EVM status code SYNOPSIS #include EvmStatus_t EvmStatusTextGet( EvmStatus_t evm_status , EvmString_t buffer , EvmSize_t nBytes ); Library EVM Support Library (libevm.so ). Parameters evm_status e The status code for which a text description is to be prepared. buffer A pointer to a character string where EvmStatusTextGet() stores the formatted event data.
EvmVarGet(3) EvmVarGet(3) NAME EvmVarGet(), EvmVarGetOpaque(), EvmVarGetString(), EvmVarGetType(), EvmVarGetXxx(), EvmVarListFree(), EvmVarListGet(), EvmVarRelease(), EvmVarSet(), EvmVarSetOpaque(), EvmVarSetStringI18N(), EvmVarSetXxx() - manipulate event variables SYNOPSIS #include
EvmVarGet(3) EvmVarGet(3) EvmVarName_t v_name , const evm_type item_value ); Library EVM Support Library (libevm.so ). Parameters event The event to be processed. v_name The name of a variable in the event for which data is to be set or obtained. For EvmVarSet() , if the named variable exists, the associated data is modified. If the variable does not exist, it is created and added to the event. The value to be stored is passed in item_value .
EvmVarGet(3) EvmVarGet(3) required type name, and supply a value of the corresponding type as the item_value operand. The following types are supported: Boolean, Char, Int16, Int32, Int64, Uint8, Uint16, Uint32, Uint64, Float, Double, String. Use EvmVarSetStringI18N() to set a string variable with a non-zero I18N message-ID. Use EvmVarSetOpaque() to set an opaque variable. Each of these routines requires one more operand than the others in this group.
exp(3M) exp(3M) NAME exp( ), expf( ), expl( ), expw( ), expq( ) - exponential functions SYNOPSIS #include double exp(double x); float expf(float x); HP Integrity Server Only long double expl(long double x); extended expw(extended x); quad expq(quad x); e DESCRIPTION exp() returns ex. expf() is a float version of exp() ; it takes a float argument and returns a float result.
exp(3M) exp(3M) Integrity Server Only HP-UX libm functions on Integrity servers do not set errno by default. For errno setting, compile with the +Olibmerrno option. SEE ALSO cbrt(3M), cexp(3M), exp10(3M), exp2(3M), expm1(3M), log(3M), pow(3M), sqrt(3M), math(5). STANDARDS CONFORMANCE exp() : SVID3, XPG4.
exp10(3M) exp10(3M) NAME exp10( ), exp10f( ), exp10l( ), exp10w( ), exp10q( ) - base-10 exponential functions SYNOPSIS #include HP Integrity Server Only double exp10(double x); float exp10f(float x); long double exp10l(long double x); extended exp10w(extended x); quad exp10q(quad x); e DESCRIPTION Integrity Server Only exp10() returns 10x. exp10f() is a float version of exp10() ; it takes a float argument and returns a float result.
exp2(3M) exp2(3M) NAME exp2( ), exp2f( ), exp2l( ), exp2w( ), exp2q( ) - base-2 exponential functions SYNOPSIS #include double exp2(double x); HP Integrity Server Only float exp2f(float x); long double exp2l(long double x); extended exp2w(extended x); quad exp2q(quad x); e DESCRIPTION exp2() returns 2x. Integrity System Only exp2f() is a float version of exp2() ; it takes a float argument and returns a float result.
exp2(3M) exp2(3M) STANDARDS CONFORMANCE exp2() , exp2f() , exp2l() : ISO/IEC C99 (including Annex F, ‘‘IEC 60559 floating-point arithmetic’’) e HP-UX 11i Version 3: February 2007 −2− Hewlett-Packard Company 409
expm1(3M) expm1(3M) NAME expm1( ), expm1f( ), expm1l( ), expm1w( ), expm1q( ) - exponential minus 1 functions SYNOPSIS #include double expm1(double x); HP Integrity Server Only float expm1f(float x); long double expm1l(long double x); extended expm1w(extended x); quad expm1q(quad x); e DESCRIPTION The expm1() function is equivalent to exp( x ) - 1, but may be more accurate for very small values of x.
expm1(3M) expm1(3M) SEE ALSO annuity(3M), compound(3M), exp(3M), log1p(3M), math(5). STANDARDS CONFORMANCE expm1() : XPG4.
fabs(3M) fabs(3M) NAME fabs( ), fabsf( ), fabsl( ), fabsw( ), fabsq( ) - absolute value functions SYNOPSIS #include double fabs(double x); float fabsf(float x); HP Integrity Server Only long double fabsl(long double x); extended fabsw(extended x); quad fabsq(quad x); f DESCRIPTION The fabs() function returns the absolute value of x, |x|. fabsf() is a float version of fabs() ; it takes a float argument and returns a float result.
fattach(3C) fattach(3C) NAME fattach( ) - attach a STREAMS file descriptor to an object in the file system name space SYNOPSIS #include int fattach(int fd, const char *path); DESCRIPTION The fattach() function attaches the fd file descriptor to an object in the file system name space designated by path. fd specifies an open file descriptor to a STREAMS device or STREAMS-based pipe. path specifies the pathname of an existing object in the file system.
fclose(3S) fclose(3S) NAME fclose(), fflush(), fclose_unlocked(), fflush_unlocked() - close or flush a stream SYNOPSIS #include int fclose(FILE *stream); int fflush(FILE *stream); Obsolescent Interfaces int fclose_unlocked(FILE *stream); int fflush_unlocked(FILE *stream); DESCRIPTION fclose() causes any buffered data for the named stream to be written out, and the stream to be closed. Buffers allocated by the standard input/output system may be freed.
fclose(3S) fclose(3S) SEE ALSO close(2), exit(2), lseek(2), write(2), flockfile(3S), fopen(3S), setbuf(3S), thread_safety(5). STANDARDS CONFORMANCE fclose() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C fflush() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.
fdetach(3C) fdetach(3C) NAME fdetach( ) - detach a name from a STREAMS file descriptor SYNOPSIS #include int fdetach(const char *path); DESCRIPTION The fdetach() function detaches a file descriptor from a name in the file system designated by path. path specifies the path name of an existing object in the file system name space that was previously attached (see fattach(3C)).
fdim(3M) fdim(3M) NAME fdim( ), fdimf( ), fdiml( ), fdimw( ), fdimq( ) - positive difference functions SYNOPSIS #include double fdim(double x, double y); HP Integrity Server Only float fdimf(float x, float y); long double fdiml(long double x, long double y); extended fdimw(extended x, extended y); quad fdimq(quad x, quad y); f DESCRIPTION The fdim() function determines the positive difference between its arguments.
feclearexcept(3M) feclearexcept(3M) NAME feclearexcept( ) - clear floating-point exception flags SYNOPSIS #include HP Integrity Server Only int feclearexcept(int excepts); PA-RISC Only void feclearexcept(int excepts); f DESCRIPTION The feclearexcept() function clears the exception flags represented by its argument. The argument can be constructed as a bitwise OR of the exception macros: FE_INEXACT , FE_DIVBYZERO , FE_UNDERFLOW , FE_OVERFLOW , and FE_INVALID .
feclearexcept(3M) feclearexcept(3M) STANDARDS CONFORMANCE feclearexcept() : ISO/IEC C99 (including Annex F, "IEC 60559 floating-point arithmetic") f HP-UX 11i Version 3: February 2007 −2− Hewlett-Packard Company 419
fegetenv(3M) fegetenv(3M) NAME fegetenv( ) - get floating-point environment SYNOPSIS #include HP Integrity Server Only int fegetenv(fenv_t *envp); PA-RISC Only void fegetenv(fenv_t *envp); DESCRIPTION The fegetenv() function stores the current floating-point environment in the object pointed to by the argument envp. To use this function, compile either with the default -Ae option or with the -Aa and -D_HPUX_SOURCE options. f Make sure your program includes .
fegetexceptflag(3M) fegetexceptflag(3M) NAME fegetexceptflag( ) - get floating-point exception flags SYNOPSIS #include HP Integrity Server Only int fegetexceptflag(fexcept_t *flagp, int excepts); PA-RISC Only void fegetexceptflag(fexcept_t *flagp, int excepts); DESCRIPTION The fegetexceptflag() function stores a representation of the states of the floating-point exception flags indicated by the argument excepts in the object pointed to by the argument flagp.
fegetexceptflag(3M) SEE ALSO feclearexcept(3M), fegettrapenable(3M), fetestexcept(3M), fenv(5).
fegetflushtozero(3M) fegetflushtozero(3M) NAME fegetflushtozero( ) - get floating-point underflow mode SYNOPSIS #include int fegetflushtozero(void); DESCRIPTION The fegetflushtozero() function retrieves the value representing the current underflow mode, which is either IEEE-754-compliant (gradual) underflow mode or flush-to-zero mode. The default underflow mode is IEEE-754-compliant. Flush-to-zero mode, also known as fast underflow mode, is supported on most PA1.1 systems and on all PA2.
fegetflushtozero(3M) fegetflushtozero(3M) AUTHOR fegetflushtozero() was developed by HP and is not required by any current standard. SEE ALSO fesetflushtozero(3M), fenv(5).
fegetround(3M) fegetround(3M) NAME fegetround( ) - get floating-point rounding direction mode SYNOPSIS #include int fegetround(void); DESCRIPTION The fegetround() function gets the current rounding direction, as specified by the IEEE 754 (IEC 60559) floating-point standard. The default rounding direction mode is round to nearest (FE_TONEAREST ). USAGE To use this function, compile either with the default -Ae option or with the -Aa and -D_HPUX_SOURCE options.
fegetround(3M) fegetround(3M) SEE ALSO fesetround(3M), fenv(5).
fegettrapenable(3M) fegettrapenable(3M) NAME fegettrapenable( ) - get floating-point exception trap enables SYNOPSIS #include int fegettrapenable(void); DESCRIPTION The fegettrapenable() function determines which floating-point exception traps are currently enabled. USAGE To use this function, compile either with the default -Ae option or with the -Aa and -D_HPUX_SOURCE options. Make sure your program includes .
feholdexcept(3M) feholdexcept(3M) NAME feholdexcept( ) - save floating-point environment SYNOPSIS #include int feholdexcept(fenv_t *envp); DESCRIPTION The feholdexcept() function saves the current floating-point environment in the object pointed to by the argument envp. This function also clears the floating-point exception flags and disables all traps. Use feholdexcept() with feupdateenv() to hide spurious floating-point exceptions. Use it with fesetenv() to hide all floating-point exceptions.
feraiseexcept(3M) feraiseexcept(3M) NAME feraiseexcept( ) - raise floating-point exceptions SYNOPSIS #include HP Integrity Server Only int feraiseexcept(int excepts); PA-RISC Only void feraiseexcept(int excepts); DESCRIPTION The feraiseexcept() function raises the floating-point exceptions represented by its argument. The argument can be constructed as a bitwise OR of the exception macros: FE_INEXACT , FE_DIVBYZERO , FE_UNDERFLOW , FE_OVERFLOW , and FE_INVALID .
feraiseexcept(3M) feraiseexcept(3M) STANDARDS CONFORMANCE feraiseexcept() : ISO/IEC C99 (including Annex F, "IEC 60559 floating-point arithmetic") f 430 Hewlett-Packard Company −2− HP-UX 11i Version 3: February 2007
ferror(3S) ferror(3S) NAME ferror(), feof(), clearerr(), ferror_unlocked(), feof_unlocked(), clearerr_unlocked() - stream status inquiries SYNOPSIS #include
ferror(3S) ferror(3S) clearerr() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C feof() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.
fesetenv(3M) fesetenv(3M) NAME fesetenv( ) - set floating-point environment SYNOPSIS #include HP Integrity Server Only int fesetenv(const fenv_t *envp); PA-RISC Only void fesetenv(const fenv_t *envp); DESCRIPTION The fesetenv() function establishes the floating-point environment represented by the object pointed to by envp. The argument envp must point to an object set by a call to fegetenv() or feholdex cept() , or equal the macro FE_DFL_ENV .
fesetenv(3M) fesetenv(3M) fesetenv(FE_DFL_ENV); SEE ALSO fegetenv(3M), feholdexcept(3M), feupdateenv(3M), fenv(5).
fesetexceptflag(3M) fesetexceptflag(3M) NAME fesetexceptflag( ) - set floating-point exception flags SYNOPSIS #include HP Integrity Server Only int fesetexceptflag(const fexcept_t *flagp, int excepts); PA-RISC Only void fesetexceptflag(const fexcept_t *flagp, int excepts); DESCRIPTION The fesetexceptflag() function sets the status for the floating-point exception flags indicated by the argument excepts to the states stored in the object pointed to by flagp.
fesetexceptflag(3M) SEE ALSO feclearexcept(3M), fegetexceptflag(3M), fetestexcept(3M), fenv(5).
fesetflushtozero(3M) fesetflushtozero(3M) NAME fesetflushtozero( ) - set floating-point underflow mode SYNOPSIS #include void fesetflushtozero(int); DESCRIPTION The fesetflushtozero() function sets the current underflow mode. If the argument is 1, the underflow mode is set to flush-to-zero mode. If the argument is zero, the underflow mode is set to IEEE754-compliant (gradual) underflow mode. For arguments other than 1 or zero, the effect is undefined.
fesetflushtozero(3M) fesetflushtozero(3M) AUTHOR fesetflushtozero() was developed by HP and is not required by any current standard. SEE ALSO fegetflushtozero(3M), fenv(5).
fesetround(3M) fesetround(3M) NAME fesetround( ) - set floating-point rounding direction mode SYNOPSIS #include int fesetround(int round); DESCRIPTION The fesetround() function establishes the rounding direction represented by its argument round. The round argument must equal one of the macros: FE_TONEAREST , FE_UPWARD , FE_DOWNWARD , and FE_TOWARDZERO. If the argument does not match a rounding direction macro, the rounding direction is not changed.
fesettrapenable(3M) fesettrapenable(3M) NAME fesettrapenable( ) - set exception trap enables SYNOPSIS #include void fesettrapenable(int excepts); DESCRIPTION The fesettrapenable() function enables the exception traps indicated by the argument excepts and disables the exception traps not indicated by the argument. The argument can be constructed as a bitwise OR of the exception macros: FE_INEXACT , FE_DIVBYZERO , FE_UNDERFLOW , FE_OVERFLOW , and FE_INVALID .
fetestexcept(3M) fetestexcept(3M) NAME fetestexcept( ) - test floating-point exceptions SYNOPSIS #include int fetestexcept(int excepts); DESCRIPTION The fetestexcept() function determines which of a specified subset of the floating-point exception flags are currently set. The excepts argument specifies the floating-point exception flags to be queried. The argument can be constructed as a bitwise OR of the exception macros: FE_INEXACT , FE_DIVBYZERO , FE_UNDERFLOW , FE_OVERFLOW , and FE_INVALID .
feupdateenv(3M) feupdateenv(3M) NAME feupdateenv( ) - update floating-point environment SYNOPSIS #include HP Integrity Server Only int feupdateenv(const fenv_t *envp); PA-RISC Only void feupdateenv(const fenv_t *envp); f DESCRIPTION The feupdateenv() function saves the currently raised floating-point exceptions in its automatic storage, installs the floating-point environment represented by the object pointed to by envp, and then raises the saved floating-point exceptions.
feupdateenv(3M) feupdateenv(3M) SEE ALSO fegetenv(3M), feholdexcept(3M), fesetenv(3M), fenv(5).
fgetpos(3S) fgetpos(3S) NAME fgetpos( ), fsetpos( ) - save and restore a file position indicator for a stream SYNOPSIS #include int fgetpos(FILE *__restrict stream, fpos_t *__restrict pos); int fsetpos(FILE *stream, const fpos_t *pos); DESCRIPTION fgetpos() Store the current value of the file position indicator for the stream pointed to by stream in the object pointed to by pos.
fgetpos64(3S) fgetpos64(3S) NAME fgetpos64( ), fopen64( ), freopen64( ), fseeko64( ), fsetpos64( ), fstatvfsdev64( ), ftello64( ), ftw64( ), nftw64( ), statvfsdev64( ), tmpfile64( ) - non-POSIX standard API interfaces to support large files. SYNOPSIS #include int fgetpos64(FILE *stream, fpos64_t *pos); #include FILE *fopen64(const char *pathname, const char *type); #include FILE *freopen64(const char *pathname, const char *type, FILE *stream); #include
fgetpos64(3S) fgetpos64(3S) be used to grow the file past 2 GB if desired. All other functional behaviors, returns, and errors are identical to freopen() . fseeko64() The fseeko64() function is identical to fseeko() except that fseeko64() accepts an off64_t for the size parameter instead of off_t . All other functional behaviors, returns, and errors are identical.
fgetws(3C) fgetws(3C) NAME fgetws(), fgetws_unlocked() - get a wide-character string from a stream file SYNOPSIS #include #include wchar_t *fgetws(wchar_t *__restrict ws, int n, FILE *__restrict stream); Obsolescent Interface wchar_t *fgetws_unlocked(wchar_t *ws, int n, FILE *stream); Remarks fgetws() is compliant with the XPG4 Worldwide Portability Interface wide-character I/O functions. It parallels the 8-bit character I/O function defined in gets(3S).
fgetws(3C) fgetws(3C) signal or the process group of the process is orphaned. Additional errno values can be set by the underlying read() function (see read(2)). WARNINGS fgetws_unlocked() is an obsolescent interface supported only for compatibility with existing DCE applications. New multithreaded applications should use fgetws() . AUTHOR fgetws() was developed by OSF and HP.
fileno(3S) fileno(3S) NAME fileno( ) - map stream pointer to file descriptor SYNOPSIS #include int fileno(FILE *stream); Obsolescent Interfaces int fileno_unlocked(FILE *stream); DESCRIPTION fileno() returns the integer file descriptor associated with the named stream; see open(2). The following symbolic values in define the file descriptors associated with stdin , stdout , and stderr when a program is started : STDIN_FILENO Value of zero for standard input, stdin .
filter(3X) filter(3X) (ENHANCED CURSES) NAME filter — disable use of certain terminal capabilities SYNOPSIS #include void filter(void); DESCRIPTION The filter() function changes the algorithm for initialising terminal capabilities that assume that the terminal has more than one line. A subsequent call to initscr() or newterm() performs the following additional actions: • f Disable use of clear , cud , cud1 , cup , cuu1 and vpa .
flash(3X) flash(3X) (CURSES) NAME flash — flash the screen SYNOPSIS #include int flash(void); DESCRIPTION The flash() function alerts the user. It flashes the screen, or if that is not possible, it sounds the audible alarm on the terminal. If neither signal is possible, nothing happens. RETURN VALUE The flash() function always returns OK. ERRORS No errors are defined. f APPLICATION USAGE Nearly all terminals have an audible alarm, but only some can flash the screen.
flockfile(3S) flockfile(3S) NAME flockfile( ), ftrylockfile( ), funlockfile( ) - explicit locking of streams within a multithread application SYNOPSIS #include void flockfile(FILE *stream); int ftrylockfile(FILE *stream); void funlockfile(FILE *stream); DESCRIPTION The flockfile() , ftrylockfile(), and funlockfile() functions provide for explicit application-level locking of streams.
floor(3M) floor(3M) NAME floor( ), floorf( ), floorl( ), floorw( ), floorq( ) - floor functions SYNOPSIS #include double floor(double x); HP Integrity Server Only float floorf(float x); long double floorl(long double x); extended floorw(extended x); quad floorq(quad x); DESCRIPTION The floor() returns the largest integer (represented as a double-precision number) not greater than x.
flushinp(3X) flushinp(3X) (CURSES) NAME flushinp — discard input SYNOPSIS #include int flushinp(void); DESCRIPTION The flushinp() function discards (flushes) any characters in the input buffer associated with the current screen. RETURN VALUE The flushinp() function always returns OK. f ERRORS No errors are defined. SEE ALSO . CHANGE HISTORY First released in X/Open Curses, Issue 2. X/Open Curses, Issue 4 The entry is rewritten for clarity.
fma(3M) fma(3M) (HP Integrity Server Only) NAME fma( ), fmaf( ), fmaw( ), fmal( ), fmaq( ) - floating multiply-add functions SYNOPSIS #include
fmax(3M) fmax(3M) NAME fmax( ), fmaxf( ), fmaxl( ), fmaxw( ), fmaxq( ) - maximum value functions SYNOPSIS #include double fmax(double x, double y); HP Integrity Server Only float fmaxf(float x, float y); long double fmaxl(long double x, long double y); extended fmaxw(extended x, extended y); quad fmaxq(quad x, quad y); f DESCRIPTION The fmax() function determines the maximum numeric value of its arguments.
fmin(3M) fmin(3M) NAME fmin( ), fminf( ), fminl( ), fminw( ), fminq( ) - minimum value functions SYNOPSIS #include double fmin(double x, double y); HP Integrity Server Only float fminf(float x, float y); long double fminl(long double x, long double y); extended fminw(extended x, extended y); quad fminq(quad x, quad y); f DESCRIPTION The fmin() function determines the minimum numeric value of its arguments.
fmod(3M) fmod(3M) NAME fmod( ), fmodf( ), fmodl( ), fmodw( ), fmodq( ) - remainder functions SYNOPSIS #include
fmtmsg(3C) fmtmsg(3C) NAME fmtmsg() - displays formatted message on standard error and console SYNOPSIS #include int fmtmsg( long class, const char *label, int severity, const char *text, const char *action, const char *tag ); DESCRIPTION The fmtmsg() routine is intended as a language-independent error message service. Messages are displayed on the system console, standard error, or both, depending on the setting of the class parameter.
fmtmsg(3C) fmtmsg(3C) The tag component is intended to direct the user to the appropriate documentation to correct or avoid the error. It may be disabled by setting tag to MM_NULLTXT or RMM_NULL . EXTERNAL INFLUENCES The user may control the appearance of the message produced on standard error through the use of two environment variables: MSGVERB and SEV_LEVEL . These have no effect on the console message. The MSGVERB environment variable describes the components the user is interested in seeing.
fnmatch(3C) fnmatch(3C) NAME fnmatch( ) - match filename patterns SYNOPSIS #include int fnmatch(const char *pattern, const char *string, int flags); DESCRIPTION fnmatch() performs pattern matching as described in regexp(5) under PATTERN MATCHING NOTATION. By default, the rule qualifications for filename expansion do not apply; i.e., periods (dots) and slashes are matched as ordinary characters. This default behavior can be modified by using the flags described below.
fopen(3S) fopen(3S) NAME fopen(), freopen(), fdopen() - open/reopen a stream file or convert file to stream SYNOPSIS #include FILE *fopen(const char *__restrict pathname, const char *__restrict type); FILE *freopen(const char *__restrict pathname, const char *__restrict type, FILE *__restrict stream); FILE *fdopen(int fildes, const char *type); DESCRIPTION f fopen() Opens the file named by pathname and associates a stream with it. pointer to the FILE structure associated with the stream.
fopen(3S) fopen(3S) RETURN VALUE Upon successful completion, fopen() , fdopen() and freopen() return a FILE * pointer to the stream. Otherwise, a null pointer is returned and errno is set to indicate the error. ERRORS fopen() , fdopen() , and freopen() fail if: [EBADF] The fildes argument is not a valid file descriptor. [EINVAL] The type argument is not a valid mode. [ENOMEM] There is insufficient space to allocate a buffer.
fpclassify(3M) fpclassify(3M) NAME fpclassify( ) - floating-point value classification macro SYNOPSIS #include int fpclassify( floating-type x); DESCRIPTION The fpclassify() macro classifies its argument value as NaN, infinite, normalized, denormalized, or zero. The argument must be of floating type, and classification is based on the type of the argument. For HP Integrity servers, the argument can be any floating type. For PA-RISC, the argument must be either double or float .
fread(3S) fread(3S) NAME fread(), fwrite() - buffered binary input/output to a stream file SYNOPSIS #include
fread(3S) fread(3S) STANDARDS CONFORMANCE fread() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C fwrite() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.
frexp(3M) frexp(3M) NAME frexp( ), frexpf( ), frexpl( ), frexpw( ), frexpq( ) - extract mantissa and exponent from floating-point number SYNOPSIS #include
fseek(3S) fseek(3S) NAME fseek( ), fseeko( ), rewind( ), ftell( ), ftello( ) - reposition a file pointer in a stream SYNOPSIS #include
fseek(3S) fseek(3S) flushed, or if any of the following conditions are encountered: [EAGAIN] The O_NONBLOCK flag is set for the file descriptor and the process would be delayed in the write operation. [EBADF] The stream is NULL. [EBADF] The underlying file is not open for writing. [EFBIG] An attempt was made to write a file that exceeds the process’s file size limit or the maximum file size. See ulimit(2).
ftok(3C) ftok(3C) NAME ftok( ) - create interprocess communication identifier SYNOPSIS #include key_t ftok(const char *path, int id); DESCRIPTION All interprocess communication facilities require the user to supply a key to be used by the msgget() , semget() , and shmget() system calls to obtain interprocess communication identifiers (see msgget(2), semget (2), and shmget(2)).
ftw(3C) ftw(3C) NAME ftw(), nftw() - walk a file tree executing a function SYNOPSIS #include
ftw(3C) ftw(3C) performance, depth should be at least as large as the number of levels in the tree. nftw() is similar to ftw() except that it takes the additional argument flags, and does not report or enter a directory which has already been visited during the walk. The flags field is the inclusive OR of the following values, as defined in the header file: FTW_PHYS If set, nftw() does a physical walk. It will not follow symbolic links, but will follow hard links.
ftw(3C) ftw(3C) int base; int level; The value of base is the offset from the first character in the path name to where the base name of the object starts; this path name is passed as the first argument to fn. The value of level indicates depth relative to the start of the walk, where the start level has a value of zero. APPLICATION USAGE ftw() can execute concurrently in separate threads. nftw() and nftw2() are serialized if the path argument is relative (i.e.
ftw(3C) ftw(3C) Obsolescent Interfaces nftw2() is to be obsoleted at a future date. AUTHOR ftw() , nftw() , and nftw2() were developed by AT&T and HP. SEE ALSO stat(2), fgetpos64(3S), malloc(3C), thread_safety(5).
fwide(3C) fwide(3C) NAME fwide( ) - set stream orientation SYNOPSIS #include #include int fwide(FILE *stream, int mode); DESCRIPTION The fwide() function determines the orientation of the stream pointed to by stream. If mode is greater than zero, the function first attempts to make the stream wide-oriented. If mode is less than zero, the function first attempts to make the stream byte-oriented. Otherwise, mode is zero and the function does not alter the orientation of the stream.
fwprintf(3C) fwprintf(3C) NAME fwprintf(), wprintf(), swprintf() - print formatted wide-character output SYNOPSIS #include #include int fwprintf( FILE *__restrict stream , const wchar_t *__restrict format , ... ); int wprintf( const wchar_t *__restrict format , ... ); int swprintf( wchar_t *__restrict s , size_t n , const wchar_t *__restrict format , ... ); f DESCRIPTION The fwprintf function places output on the named output stream.
fwprintf(3C) 5.
fwprintf(3C) f fwprintf(3C) - The result of the conversion will be left-justified within the field. The conversion will be right-justified if this flag is not specified. + The result of a signed conversion will always begin with a sign (+ or -). The conversion will begin with a sign only when a negative value is converted if this flag is not specified.
fwprintf(3C) fwprintf(3C) g, G The double argument is converted in the style f,F or e (or in the style E in the case of a G conversion wide-character), with the precision specifying the number of significant digits. If an explicit precision is 0, it is taken as 1. The style used depends on the value converted; style e (or E) will be used only if the exponent resulting from such a conversion is less than -4 or greater than or equal to the precision.
fwprintf(3C) fwprintf(3C) ERRORS For the conditions under which fwprintf() and wprintf() fails, refer to fputwc() ; see putwc(3C). In addition, all forms of fwprintf() may fail if one of the following occurs: [EILSEQ] A wide-character code that does not correspond to a valid character has been detected. [EINVAL] There are insufficient arguments. [ENOMEM] Insufficient storage space is available. In addition, wprintf() may fail if: stdout is byte-oriented.
fwscanf(3C) fwscanf(3C) NAME fwscanf( ), wscanf( ), swscanf( ) - convert formatted wide-character input SYNOPSIS #include #include int fwscanf(FILE *__restrict stream, const wchar_t *__restrict format, ... ); int wscanf(const wchar_t *__restrict format, ... ); int swscanf(const wchar_t *__restrict s, const wchar_t *__restrict format, ... ); DESCRIPTION The fwscanf() function reads from the named input stream. The wscanf() function reads from the standard input stream stdin .
fwscanf(3C) fwscanf(3C) Similarly, the conversion wide-characters o, u and x must be preceded by h if the corresponding argument is a pointer to unsigned short int rather than a pointer to unsigned int, or by hh if it is a pointer to unsigned char, or by j if it is a pointer to uintmax_t, or by l (ell) if it is a pointer to unsigned long int, or by ll (ell-ell) if it is a pointer to unsigned long long, or by t if it is a pointer to unsigned ptrdiff_t, or by z if it is a pointer to size_t.
fwscanf(3C) a,e,f,g fwscanf(3C) Matches an optionally signed floating-point number, whose format is the same as expected for the subject sequence of wcstod() . In the absence of a size modifier, the corresponding argument must be a pointer to float.
fwscanf(3C) fwscanf(3C) If a conversion specification is invalid, the behavior is undefined. The conversion characters A, E, F, G and X are also valid and behave the same as, respectively, a, e, f, g and x. If end-of-file is encountered during input, conversion is terminated.
fwscanf(3C) fwscanf(3C) 25 54.32E-1 Hamster will assign to n the value 3, to i the value 25, x the value 5.432, and name will contain the string Hamster . The call: int i; float x; char name[50]; (void)wscanf(L"%2d%f%*d %[0123456789]", &i, &x, name); with input: 56789 0123 56a72 will assign 56 to i, 789.0 to x, skip 0123, and place the string 56 in name. The next call to getchar() will return the character a.
get_expiration_time(3T) get_expiration_time(3T) NAME get_expiration_time() - add a specific time interval to the current absolute system time SYNOPSIS #include int get_expiration_time( struct timespec *delta, struct timespec *abstime ); DESCRIPTION The get_expiration_time() function adds a specific time interval to the current absolute system time and returns the new absolute time. This new absolute time is used as the expiration time in a call to pthread_cond_timedwait(3T).
get_wch(3X) get_wch(3X) (ENHANCED CURSES) NAME get_wch, mvget_wch, mvwget_wch, wget_wch — get a wide character from a terminal SYNOPSIS #include int get_wch(wint_t *ch); int mvget_wch(int y, int x, wint_t *ch); int mvwget_wch(WINDOW *win, int y, int x, wint_t *ch); int wget_wch(WINDOW *win, wint_t *ch); DESCRIPTION These functions read a character from the terminal associated with the current or specified window.
getaddrinfo(3N) getaddrinfo(3N) NAME getaddrinfo(), getnameinfo(), freeaddrinfo(), gai_strerror() - get hostname and address entry SYNOPSIS #include #include
getaddrinfo(3N) getaddrinfo(3N) In this case, if the hostname argument is a NULL pointer, then the IP address portion of the socket address will be set to loopback address. If the AI_CANONNAME bit is set, then upon successful return, getaddrinfo() will return the ai_canonname member of the first addrinfo structure, which is a NULL terminated string containing the canonical name of the specified host.
getaddrinfo(3N) EAI_SERVICE EAI_SOCKTYPE EAI_SYSTEM getaddrinfo(3N) The servname is not supported for ai_socktype . ai_socktype not supported. System error returned in errno. freeaddrinfo() All the information returned by getaddrinfo() is dynamically allocated: the addrinfo structures, the socket address structures, and canonical host name strings pointed to by the addrinfo structures. To return this information to the system, the function freeaddrinfo() is called: #include
getaddrinfo(3N) getaddrinfo(3N) #define NI_MAXHOST #define NI_MAXSERV 1025 32 In recent versions of DNS/BIND, the first value NI_MAXHOST is actually defined as the constant MAXDNAME in the header file . (Older versions of BIND define this constant to be 256.) The final argument to the getnameinfo() function is a flag that changes the default actions of this function. By default, the fully-qualified domain name (FQDN) for the host is looked up in the DNS and returned.
getaddrinfo(3N) getaddrinfo(3N) WARNINGS Obsolescent Interfaces The following interfaces are included to support existing applications and may be removed in future releases. struct hostent *getipnodebyname(const char *name, int af, int flags, int *error_num); int getipnodebyaddr(const void *src, size_t len, int af, int *error_num); New applications must use the APIs getaddrinfo() and getnameinfo() for name/address resolution.
getauduser(3) getauduser(3) NAME getauduser - retrieve the accountable user for the current process SYNOPSIS #include int getauduser(char *user, char *stime, size_t usize, size_t tsize); DESCRIPTION getauduser() retrieves the accountable user for the current process and saves the information into the buffer pointed to by user. It also retrieves the time of authentication and saves it into the buffer pointed to by stime, if the information is available.
getbegyx(3X) getbegyx(3X) (ENHANCED CURSES) NAME getbegyx, getmaxyx, getparyx — get additional cursor and window coordinates SYNOPSIS #include void getbegyx(WINDOW *win, int y, int x); void getmaxyx(WINDOW *win, int y, int x); void getparyx(WINDOW *win, int y, int x); DESCRIPTION The getbegyx() macro stores the absolute screen coordinates of the specified window’s origin in y and x.
getbootpent(3X) getbootpent(3X) NAME getbootpent(), putbootpent(), setbootpent(), parse_bp_iaddr() - get or put bootptab entry endbootpent(), parse_bp_htype(), parse_bp_haddr(), SYNOPSIS #include
getbootpent(3X) getbootpent(3X) in the /etc/bootptab file (or from an alternate file specified by a call to setbootpent() ), including leading, or embedded, comment lines. Each subsequent call returns a pointer to the next entry in the file so that successive calls can be used to search the entire file. If no file is currently in memory, getbootpent() reads the /etc/bootptab file prior to doing its work.
getbootpent(3X) getbootpent(3X) Entry field strings are of the form: tag [@ ] [=" value" ] with surrounding whitespace, if any, removed (see bootpd(1M) for the full description). Double quotes, and backslashes, can appear anywhere in the field strings. Template entries (those referred to by other entries using tc fields) are not special. They can be managed like other entries.
getbootpent(3X) getbootpent(3X) if (putbootpent (bp, fields, newfilep)) { (handle error) } } if (fields < 0) { (handle error) } /* error reading file */ if (endbootpent()) { (handle error) } if (fclose (newfilep)) { (handle error) } g The following code fragment saves a copy of a bootptab entry returned by getbootpent(). #include #include #include
getc(3S) getc(3S) NAME getc(), getc_unlocked(), getchar(), getchar_unlocked(), fgetc(), getw(), getw_unlocked() - get character or word from a stream file SYNOPSIS #include int getc(FILE *stream); int getc_unlocked(FILE *stream); int getchar(void); int getchar_unlocked(void); int fgetc(FILE *stream); int getw(FILE *stream); Obsolescent Interface g int getw_unlocked(FILE *stream); DESCRIPTION getc() Returns the next character (i.e.
getc(3S) getc(3S) ferror() and feof() can be used to distinguish between an error condition and an end-of-file condition. ERRORS getc() , getc_unlocked(), getchar() , getchar_unlocked(), getw() , getw_unlocked(), and fgetc() fail if data needs to be read into the stream’s buffer, and: [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying stream and the process would be delayed in the read operation.
getc(3S) getc(3S) STANDARDS CONFORMANCE getc() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C getc_unlocked(): POSIX.1C fgetc() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, XPG4.2, FIPS 151-2, POSIX.1, ANSI C getchar() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C getchar_unlocked(): POSIX.
getcchar(3X) getcchar(3X) (ENHANCED CURSES) NAME getcchar() - get a wide-character string and rendition from a cchar_t SYNOPSIS #include
getch(3X) getch(3X) (CURSES) NAME getch, wgetch, mvgetch, mvwgetch — get a single-byte character from the terminal SYNOPSIS #include int getch(void); int mvgetch(int y, int x); int mvwgetch(WINDOW *win, int y, int x); int wgetch(WINDOW *win); DESCRIPTION These functions read a single-byte character from the terminal associated with the current or specified window. The results are unspecified if the input is not a single-byte character.
getclock(3C) getclock(3C) NAME getclock - get current value of system-wide clock SYNOPSIS #include int getclock(int clock_type, struct timespec *tp); DESCRIPTION The getclock() function gets the current value tp of the specified system-wide clock, clock_type . getclock() supports a clock_type of TIMEOFDAY , defined in , which represents the time-of-day clock for the system. For this clock, the values returned by getclock() represent the amount of time since the Epoch.
getcwd(3C) getcwd(3C) NAME getcwd( ) - get pathname of current working directory SYNOPSIS #include char *getcwd(char *buf, size_t size); DESCRIPTION The getcwd() function places the absolute pathname of the current working directory in the array pointed to by buf, and returns buf. The value of size must be at least one greater than the length of the pathname to be returned. If buf is a NULL pointer, getcwd() obtains size bytes of space using malloc() (see malloc(3C)).
getdate(3C) getdate(3C) NAME getdate() - convert user format date and time SYNOPSIS #include struct tm *getdate(const char *string); Obsolescent Interface int getdate_r(const char *string, struct tm *result, int *errnum); DESCRIPTION The getdate() function converts user definable date and/or time specifications pointed to by string into a struct tm. The structure declaration is in the header file (see ctime(3C)). User-supplied templates are used to parse and interpret the input string.
getdate(3C) getdate(3C) The field descriptors %c , %x, and %X are not supported if they include unsupported field descriptors. The following example shows the possible contents of a template: %m %A %B %d, %Y, %H:%M:%S %A %B %m/%d/%y %I %p %d,%m,%Y %H:%M at %A the %dst of %B in %Y run job at %I %p, %B %dnd %A den %d. %B %Y %H.
getdate(3C) Input Mon Sun Fri September January December Sep Mon Jan Fri Dec Mon Jan Wed 1989 Fri 9 Feb 10:30 10:30 13:30 g getdate(3C) Line in Template %a %a %a %B %B %B %b %a %b %a %b %a %b %a %Y %a %H %b %H:%S %H:%M %H:%M Date Mon Sep 22 12:19:47 EDT 1986 Sun Sep 28 12:19:47 EDT 1986 Fri Sep 26 12:19:47 EDT 1986 Mon Sep 1 12:19:47 EDT 1986 Thu Jan 1 12:19:47 EST 1987 Mon Dec 1 12:19:47 EST 1986 Mon Sep 1 12:19:47 EDT 1986 Fri Jan 2 12:19:47 EST 1987 Mon Dec 1 12:19:47 EST 1986 Wed Jan 4 12:19:47 EST
getdiskbyname(3C) getdiskbyname(3C) NAME getdiskbyname( ) - get disk description by its name SYNOPSIS #include struct disktab *getdiskbyname(const char *name); Obsolescent Interface int getdiskbyname_r( const char *name, struct disktab *result, char *buffer, int buflen); DESCRIPTION getdiskbyname() takes a disk name (such as hp7959B) and returns a pointer to a structure that describes its geometry information and the standard disk partition tables.
getdvagent(3) getdvagent(3) (TO BE OBSOLETED) NAME getdvagent(), getdvagnam(), setdvagent(), enddvagent(), putdvagnam(), copydvagent() - manipulate device assignment database entry for a trusted system SYNOPSIS #include #include #include
getdvagent(3) getdvagent(3) (TO BE OBSOLETED) table of character string pointers, whose last entry is a NULL pointer. fd_users is a pointer to a null-terminated table of character string pointers referring to user allowed access. For trusted system versions supporting network connections, the device name can be a 12 character host name, where the first 8 characters are the ASCII hex address of the device, and the last 4 characters are ASCII zeroes. For example, a host with Internet address 129.75.0.
getenv(3C) getenv(3C) NAME getenv( ) - return value for environment name SYNOPSIS #include char *getenv(const char *name); DESCRIPTION getenv() searches the environment list (see environ(5)) for a string of the form name =value, and returns a pointer to the value in the current environment if such a string is present, otherwise a NULL pointer.
getfsent(3X) getfsent(3X) (TO BE OBSOLETED) NAME getfsent( ), getfsspec( ), getfsfile( ), getfstype( ), setfsent( ), endfsent( ) - get file system descriptor file entry SYNOPSIS #include struct checklist *getfsent(void); struct checklist *getfsspec(const char *spec); struct checklist *getfsfile(const char *file); struct checklist *getfstype(const char *type); int setfsent(void); int endfsent(void); Remarks: These routines are included only for compatibility with 4.2 BSD.
getfsent(3X) getfsent(3X) (TO BE OBSOLETED) FILES /etc/fstab SEE ALSO fstab(4).
getgrent(3C) getgrent(3C) NAME getgrent(), getgrgid(), getgrgid_r(), getgrnam(), getgrnam_r(), setgrent(), endgrent(), fgetgrent() - get group file entry SYNOPSIS #include
getgrent(3C) getgrent(3C) Reentrant Interfaces getgrgid_r () and getgrnam_r() both update the struct group pointed to by grp and store a pointer to that structure at the location pointed to by result . The structure shall contain an entry from the group database with a matching gid or name . Storage referenced by the group structure pointed to by grp shall be allocated from the memory provided with the buffer parameter, which is buflen in size.
getgrent(3C) getgrent(3C) getgrnam() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1 setgrent() : SVID2, SVID3, XPG2 getgrnam_r(), getgrgid_r() : POSIX.
gethostent(3N) gethostent(3N) NAME gethostent(), gethostbyaddr(), gethostbyname(), sethostent(), endhostent() - get, set, or end network host entry SYNOPSIS #include #include #include
gethostent(3N) gethostent() sethostent() gethostent(3N) Always returns a NULL pointer. Requests the use of a connected stream socket for queries to the name server if the stayopen flag is non-zero. The connection is retained after each call to gethostbyname() or gethostbyaddr(). endhostent() Closes the stream socket connection. gethostbyname() gethostbyaddr() Each retrieves host information from the name server. Names are matched without respect to uppercase or lowercase. For example, berkeley.
gethostent(3N) gethostent(3N) constant AF_INET . RETURN VALUE If successful, gethostbyname(), gethostbyaddr(), and gethostent() return a pointer to the requested hostent structure. gethostbyname() and gethostbyaddr() return NULL if their host or addr parameters, respectively, cannot be found in the database. If /etc/hosts is being used, they also return NULL if they are unable to open /etc/hosts . gethostbyaddr() also returns NULL if either its addr or len parameter is invalid.
gethostent(3N) gethostent(3N) } for (p = hp->h_addr_list; *p!=0;p++){ struct in_addr in; char **q; (void)memcpy(&in.s_addr, *p, sizeof(in.s_addr)); (void)printf("%s\t%s",inet_ntoa(in), hp->h_name); for (q=hp->h_aliases;*q != 0; q++) (void) printf("%s", *q); (void)putchar(’\n’); } exit (0); } WARNINGS Programs that use the interfaces described in this manpage cannot be linked statically because the implementations of these functions employ dynamic loading and linking of shared objects at run time.
gethrtime(3C) gethrtime(3C) NAME gethrtime( ) - get high resolution time SYNOPSIS #include hrtime_t gethrtime(void); DESCRIPTION The gethrtime() function returns the current high-resolution real time. Time is expressed as nanoseconds since a certain time in the past. This API uses a fast light weight system call to get the nanoseconds from a certain time. It is not correlated in any way to the time of day.
getlogin(3C) getlogin(3C) NAME getlogin(), getlogin_r() - get name of user logged in on this terminal SYNOPSIS #include char *getlogin(void); int getlogin_r(char *buf, size_t buflen); DESCRIPTION The getlogin() function retrieves the name of the user currently logged in on a terminal associated with the calling process, as found in user-accounting database maintained by utmpd(1M). At least one of the standard input, standard output, or standard error must be a terminal.
getlogin(3C) getlogin(3C) WARNINGS Users of getlogin_r() should note getlogin_r() now conforms with the POSIX.1c Threads standard. The old prototype of getlogin_r() is supported for compatibility with existing DCE applications only. SEE ALSO utmpd(1M), getuid(2), sysconf(2), getgrent(3C), getpwent(3C), thread_safety(5). STANDARDS CONFORMANCE getlogin() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1 getlogin_r() : POSIX.
getmntent(3X) getmntent(3X) NAME getmntent(), getmntent_r(), setmntent(), addmntent(), delmntent(), endmntent(), hasmntopt() - get file system descriptor file entry SYNOPSIS #include
getmntent(3X) getmntent(3X) hasmntopt() Scans the mnt_opts field of the mntent structure mnt for a substring that matches opt. It returns the address of the substring if a match is found. Otherwise, the return value takes one of the following default behaviors: g Option String Corresponding Default Behavior MNTOPT_RW If the mnt_opts does not have the MNTOPT_RO option, MNTOPT_RW is returned. Otherwise, NULL is returned.
getmntent(3X) getmntent(3X) The following definitions are provided for file system swap in : #define #define #define #define MNTOPT_MIN MNTOPT_LIM MNTOPT_RES MNTOPT_PRI "min" "lim" "res" "pri" /* /* /* /* minimum file system swap */ maximum file system swap */ reserve space for file system */ file system swap priority */ NETWORKING FEATURES NFS The following definitions are provided in
getmntent(3X) getmntent(3X) retval = DELETED; (void)endmntent(fp); } return(retval); APPLICATION USAGE Data integrity is not guaranteed when reading the mntent data because setmntent() does not lock the file when opening it with read-only permission. To overcome this, as one approach, programs may need to loop until the last modification time and file size before and after reading the file are the same. The following code achieves the data integrity.
getmntent(3X) getmntent(3X) Programs should expect that the file accessed by these APIs may be write locked by another process because setmntent() attempts to establish an exclusive write lock when opening it for write/update. Use of a text editor to manipulate the file accessed by these APIs is not supported. setmntent() and endmntent() are safe for per process locking.
getn_wstr(3X) getn_wstr(3X) (ENHANCED CURSES) NAME getn_wstr(), get_wstr(), mvget_wstr(), mvgetn_wstr(), mvwget_wstr(), mvwgetn_wstr(), wget_wstr(), wgetn_wstr() - get an array of wide characters and function key codes from a terminal SYNOPSIS #include
getnetconfig(3N) getnetconfig(3N) NAME getnetconfig(), setnetconfig(), endnetconfig(), getnetconfigent(), freenetconfigent(), nc_perror(), nc_sperror() get network configuration database entry SYNOPSIS #include
getnetconfig(3N) getnetconfig(3N) RETURN VALUE setnetconfig() returns a unique handle to be used by getnetconfig(). In the case of an error, setnetconfig() returns NULL and nc_perror() or nc_sperror() can be used to print the reason for failure. getnetconfig() returns a pointer to the current entry in the netconfig() database, formatted as a struct netconfig . getnetconfig() returns NULL at the end of the file, or upon failure.
getnetent(3N) getnetent(3N) NAME getnetent(), getnetbyaddr(), getnetbyname(), setnetent(), endnetent() - get, set, or end network entry SYNOPSIS #include #include
getnetent(3N) getnetent(3N) of the supported name services used to resolve network names and addresses. RETURN VALUE getnetent() , getnetbyname(), and getnetbyaddr() return a null pointer (0) on EOF or when they are unable to open /etc/networks. getnetbyaddr() also returns a null pointer if its type parameter is invalid.
getnetgrent(3C) getnetgrent(3C) NAME getnetgrent( ), setnetgrent( ), endnetgrent( ), innetgr( ), - get network group entry SYNOPSIS int innetgr( char *netgroup, char *machine, char *user, char *domain ); int setnetgrent(char *netgroup); int endnetgrent(); int getnetgrent( char **machinep, char **userp, char **domainp ); g DESCRIPTION These functions are used to test membership in and enumerate members of ‘‘netgroup’’ network groups defined in a system database.
getnetgrent(3C) MULTITHREAD USAGE Thread Safe: Cancel Safe: Fork Safe: Async-cancel Safe: Async-signal Safe: getnetgrent(3C) Yes Yes No No No These functions can be called safely in a multithreaded environment. They may be cancellation points in that they call functions that are cancel points. In a multithreaded environment, these functions are not safe to be called by a child process after fork() and before exec() .
getnetpath(3N) getnetpath(3N) NAME getnetpath(), setnetpath(), endnetpath() - get /etc/netconfig entry corresponding to NETPATH component SYNOPSIS #include struct netconfig *getnetpath(void *handlep); void *setnetpath(void); int endnetpath(void *handlep); DESCRIPTION The routines described on this page are part of the Network Selection component.
getnetpath(3N) getnetpath(3N) SEE ALSO getnetconfig(3N), netconfig(4), environ(5).
getnstr(3X) getnstr(3X) (ENHANCED CURSES) NAME getnstr, mvgetnstr, mvwgetnstr, wgetnstr, — get a multi-byte character length limited string from the terminal SYNOPSIS #include
getopt(3C) getopt(3C) NAME getopt(), optarg, opterr, optind, optopt - get option letter from argument vector SYNOPSIS #include int getopt( int argc , char * const argv [], const char *optstring ); extern char *optarg; extern int optind, opterr, optopt; DESCRIPTION getopt() returns the next option letter in argv (starting from argv [1] ) that matches a letter in optstring. argc and argv are the argument count and argument array as passed to main() .
getopt(3C) getopt(3C) ERRORS getopt() fails under the following conditions: [EILSEQ] An invalid multibyte character sequence was encountered during option processing. EXAMPLES The following code fragment shows to process arguments for a command that can take the mutually exclusive options a and b, and the options f and o, both of which require arguments: #include #include
getopt(3C) getopt(3C) WARNINGS Options can be any ASCII characters except colon (:), question mark (?), or null (\0 ). SEE ALSO getopt(1), thread_safety(5). STANDARDS CONFORMANCE getopt() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, POSIX.2 optarg : AES, SVID2, SVID3, XPG2, XPG3, XPG4, POSIX.2 opterr : AES, SVID2, SVID3, XPG2, XPG3, XPG4, POSIX.2 optind : AES, SVID2, SVID3, XPG2, XPG3, XPG4, POSIX.2 optopt : AES, SVID3, XPG4, POSIX.
getpass(3C) getpass(3C) (TO BE OBSOLETED) NAME getpass( ) - read a password SYNOPSIS #include char *getpass(const char *prompt); DESCRIPTION getpass() reads up to a newline or EOF from the file /dev/tty , after prompting on the standard error output with the null-terminated string prompt and disabling echoing. A pointer is returned to a nullterminated string of at most 8 characters. If /dev/tty cannot be opened, a NULL pointer is returned.
getprdfent(3) getprdfent(3) (TO BE OBSOLETED) NAME getprdfent(), getprdfnam(), setprdfent(), endprdfent(), putprdfnam() - manipulate system default database entry for a trusted system SYNOPSIS #include #include #include
getprdfent(3) getprdfent(3) (TO BE OBSOLETED) A call to setprdfent has the effect of rewinding the default control file to allow repeated searches. endprdfent can be called to close the database when processing is complete. putprdfnam puts a new or replaced default control entry pr with key name into the database. If the prg.fd_name field is 0, the requested entry is deleted from the system default database.
getprotoent(3N) getprotoent(3N) NAME getprotoent(), getprotobynumber(), getprotobyname(), setprotoent(), endprotoent() - get, set, or end protocol entry SYNOPSIS #include
getprotoent(3N) getprotoent(3N) OBSOLESCENT INTERFACES int getprotoent_r(struct protoent *result, struct protoent_data *buffer); int getprotobyname_r(const char *name, struct protoent *result, struct protoent_data *buffer); int getprotobynumber_r(int proto, struct protoent *result, struct protoent_data *buffer); int setprotoent_r(int stayopen, struct protoent_data *buffer); int endprotoent_r(struct protoent_data *buffer); The above reentrant interfaces have been moved from libc to libd4r .
getprpwent(3) getprpwent(3) (TO BE OBSOLETED) NAME getprpwent(), getprpwuid(), getprpwnam(), getprpwaid(), setprpwent(), endprpwent(), putprpwnam() manipulate protected password database entries (for trusted systems only) SYNOPSIS #include #include #include
getprpwent(3) getprpwent(3) (TO BE OBSOLETED) int char int char fd_nlogins; fd_unsuctty[14]; fd_max_tries; fd_lock; /* /* /* /* consecutive unsuccessful logins */ tty of last unsuccessful login */ maximum unsuc login tries allowed */ Unconditionally lock account? */ }; struct pr_flag { unsigned short /* Identity: */ fg_name:1, fg_uid:1, fg_encrypt:1, fg_owner:1, fg_boot_auth:1, fg_pw_audid:1, fg_pw_audflg:1, /* /* /* /* /* /* /* /* Password maintenance fg_min:1, fg_maxlen:1, fg_expire:1, fg_lifetime
getprpwent(3) getprpwent(3) (TO BE OBSOLETED) fd_owner is the user name accountable for the account. The fd_boot_auth field is used when the system default file specifies boot authorization is required. The init command prompts for a user name and password. If the authentication succeeds, a value in this field allows the user to continue the system boot process. fd_min is the time, in seconds, that must elapse before the user can change passwords.
getprpwent(3) getprpwent(3) (TO BE OBSOLETED) A call to setprpwent has the effect of rewinding the protected password database to allow repeated searches. endprpwent can be called to close the protected password database when processing is complete. putprpwnam puts a new or replaces a protected password entry pr with key name into the database. If the uflg.fg_name field is 0, the requested entry is deleted from the protected password database.
getprtcent(3) getprtcent(3) (TO BE OBSOLETED) NAME getprtcent, getprtcnam, setprtcent, endprtcent, putprtcnam - manipulate terminal control database entry for a trusted system SYNOPSIS #include #include #include
getprtcent(3) getprtcent(3) (TO BE OBSOLETED) Note that ufld and uflg refer to user-specific entries, and sfld and sflg refer to the system default values (see authcap(4)). The value returned by getprtcent or getprtcnam refers to a structure that is overwritten by calls to these routines. To retrieve an entry, modify it, and replace it in the database, copy the entry using structure assignment and supply the modified buffer to putprtcnam .
getpublickey(3N) getpublickey(3N) NAME getpublickey(), getsecretkey(), publickey() - retrieve public or secret key SYNOPSIS #include #include int getpublickey( const char netname [MAXNETNAMELEN], char publickey[HEXKEYBYTES+1]); int getsecretkey( const char netname [MAXNETNAMELEN], char secretkey [HEXKEYBYTES+1], const char *passwd ); DESCRIPTION getpublickey() and getsecretkey() get public and secret keys for netname.
getpw(3C) getpw(3C) (TO BE OBSOLETED) NAME getpw( ) - get name from UID SYNOPSIS #include int getpw(uid_t uid, char *buf); DESCRIPTION getpw() searches the password file for a user ID number that equals uid, copies the line of the password file in which uid was found into the array pointed to by buf, and returns 0. getpw() returns non-zero if uid cannot be found. The line is null-terminated.
getpwent(3C) getpwent(3C) NAME getpwent(), getpwuid(), getpwuid_r(), getpwnam(), getpwnam_r(), setpwent(), endpwent(), fgetpwent() - get password file entry SYNOPSIS #include
getpwent(3C) getpwent(3C) getpwnam() Searches from the beginning of the password database until a login name matching name is found, and returns a pointer to the particular structure in which it was found. fgetpwent() Unlike the other functions above, does not use nsswitch.conf, nor access NIS It returns a pointer to the next passwd structure in the standard I/O stream stream, which should be open for reading, and its contents should match the format of /etc/passwd .
getpwent(3C) getpwent(3C) The following fields have numerical limitations as noted: • The user ID is an integer value between -2 and UID_MAX inclusive. • The group ID is an integer value between 0 and UID_MAX inclusive. Users of getpwuid_r() and getpwnam_r() should note that these interfaces now conform with POSIX.1c. getpwent_r() , setpwent_r() , endpwent_r() and fgetpwent_r() are obsolescent interfaces.
getresuid(3) getresuid(3) NAME getresuid, getresgid - get real, effective and saved user or group IDs SYNOPSIS #include int getresuid (uid_t *ruid, uid_t *euid, uid_t *suid); int getresgid (gid_t *rgid, gid_t *egid, gid_t *sgid); DESCRIPTION getresuid and getresgid return the real, effective, and saved user or group ID’s of the current process. RETURN VALUE On error, the return is -1, and errno is set appropriately. On success the return is 0.
getrpcent(3C) getrpcent(3C) NAME getrpcent(), getrpcbyname(), getrpcbynumber(), setrpcent(), endrpcent() - get RPC entry SYNOPSIS cc [ flag ]... file ... -lnsl [ library ]... #include struct rpcent *getrpcbyname(char *name ); struct rpcent *getrpcbynumber(int number ); struct rpcent *getrpcent(void); void setrpcent(int stayopen ); void endrpcent(); g DESCRIPTION These functions are used to obtain entries for RPC (Remote Procedure Call) services.
getrpcent(3C) int r_number; getrpcent(3C) /* rpc program number */ }; The functions getrpcbyname(), and getrpcbynumber() each return a pointer to a struct rpcent if they successfully locate the requested entry; otherwise they return NULL. The function getrpcent() returns a pointer to a struct rpcent if it successfully enumerates an entry; otherwise it returns NULL, indicating the end of the enumeration.
getrpcport(3N) getrpcport(3N) NAME getrpcport( ) - get RPC port number SYNOPSIS u_short getrpcport(char *host , rpcprog_t prognum , rpcvers_t versnum , rpcprot_t proto ); DESCRIPTION getrpcport() returns the port number for version versnum of the RPC program prognum running on host and using protocol proto. It returns 0 if the RPC system failed to contact the remote portmap service, the program associated with prognum is not registered, or there is no mapping between the program and a port.
gets(3S) gets(3S) NAME gets(), fgets() - get a string from a stream SYNOPSIS #include char *gets(char *s); char *fgets(char *__restrict s, int n, FILE *__restrict stream); Obsolescent Interface char *fgets_unlocked(char *s, int n, FILE *stream); DESCRIPTION gets() Reads characters from the standard input stream, stdin , into the array pointed to by s, until a new-line character is read or an end-of-file condition is encountered.
gets(3S) gets(3S) STANDARDS CONFORMANCE gets() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C fgets() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.
getservent(3N) getservent(3N) NAME getservent(), getservbyport(), getservbyname(), setservent(), endservent() - get, set, or end service entry SYNOPSIS #include
getservent(3N) getservent(3N) OBSOLESCENT INTERFACES int getservent_r(struct servent *result, struct servent_data *buffer); int getservbyname_r(const char *name, const char *proto, struct servent *result, struct servent_data *buffer); int getservbyport_r(int port, const char *proto, struct servent *result, struct servent_data *buffer); int setservent_r(int stayopen, struct servent_data *buffer); int endservent_r(struct servent_data *buffer); The above reentrant interfaces have been moved from libc to lib
getspent(3C) getspent(3C) NAME getspnam(), getspnam_r(), getspent(), setspent(), endspent(), fgetspent() - access shadow password entries SYNOPSIS #include
getspent(3C) getspent(3C) The routines getspent() , getspnam() and getspnam_r() depend on the configuration of the /etc/nsswitch.conf file. See nsswitch.conf(4). Entries may reside in any repository specified in /etc/nsswitch.conf. These routines use the switch for the passwd database; for example, an entry in /etc/nsswitch.conf would contain "passwd: nis files" . Programs using these routines must be compiled with -lsec .
getspwent(3X) getspwent(3X) (TO BE OBSOLETED) NAME getspwent(), getspwuid(), getspwaid(), getspwnam(), setspwent(), endspwent(), fgetspwent(), getspwent_r(), getspwuid_r(), getspwaid_r(), getspwnam_r(), setspwent_r(), endspwent_r(), fgetspwent_r() - get secure password file entry on trusted systems SYNOPSIS #include
getspwent(3X) getspwent(3X) (TO BE OBSOLETED) Since the s_passwd structure is declared in the header file, it is unnecessary to redeclare it. To access other fields in the protected password database that are not included in the s_passwd structure, use getprpwent() . See getprpwent(3) for more information. g getspwent() When first called, getspwent() returns a pointer to each s_passwd structure obtained from the protected password database for each user in sequence.
getspwent(3X) getspwent(3X) (TO BE OBSOLETED) Obsolescent Interfaces The following interfaces are to be obsoleted: getspwent_r(), getspwuid_r(), getspwaid_r(), getspwnam_r(), setspwent_r(), endspwent_r(), and fgetspwent_r(). HP-UX 11i Version 3 is the last release to support trusted systems functionality.
getstr(3X) getstr(3X) (CURSES) NAME getstr, mvgetstr, mvwgetstr, wgetstr — get a multi-byte character string from the terminal SYNOPSIS #include int getstr(char *str); int mvgetstr(int y, int x, char *str); int mvwgetstr(WINDOW *win, int y, int x, char *str); int wgetstr(WINDOW *win, char *str); DESCRIPTION The effect of getstr() is as though a series of calls to getch() were made, until a newline or carriage return is received. The resulting value is placed in the area pointed to by str.
getsubopt(3C) getsubopt(3C) NAME getsubopt( ) - parse suboptions from a string. SYNOPSIS #include int getsubopt(char **optionp, char * const *tokens, char **valuep); DESCRIPTION getsubopt() parses suboptions in a flag argument that were initially parsed by getopt() (see getopt(3C)). These suboptions are separated by commas, and may consist of either a single token, or a token-value pair separated by an equal sign.
getsubopt(3C) getsubopt(3C) char *options, *value; extern char *optarg; extern int optind; . . .
getsubopt(3C) getsubopt(3C) SEE ALSO getopt(3C), thread_safety(5).
gettimer(3C) gettimer(3C) NAME gettimer - get value of a per-process timer SYNOPSIS #include int gettimer(timer_t timerid, struct itimerspec *value); DESCRIPTION The gettimer() function returns an itimerspec structure value to the value argument. The it_value member of the structure represents the amount of time in the current interval before the timer expires for the timer specified in timerid , or zero if the timer is disabled.
gettxt(3C) gettxt(3C) (TO BE OBSOLETED) NAME gettxt() - read text string from message file SYNOPSIS #include char *gettxt(char *msg_id, char *def_str); DESCRIPTION The gettxt() routine retrieves a text string from a message file for the current locale. msg_id has the following syntax: msgfilename :msgnumber where msgfilename is the name of the message file generated by mkmsgs(1). If msgfilename is NULL, gettxt() uses the message file specified in the last call to setcat(3C).
getusershell(3C) getusershell(3C) NAME getusershell( ), setusershell( ), endusershell( ) - get legal user shells SYNOPSIS #include char *getusershell(void); void setusershell(void); void endusershell(void); Obsolescent Interfaces char *getusershell_r(char **shell_datap); void setusershell_r(char **shell_datap); void endusershell_r(char **shell_datap); g DESCRIPTION getusershell() Returns a pointer to the first legal user shell as defined in the file /etc/shells (see shells(4)).
getut(3C) getut(3C) (TO BE OBSOLETED) NAME getut: getutent(), getutid(), getutline(), pututline(), _pututline(), setutent(), endutent(), utmpname() - access utmp file entry SYNOPSIS #include
getut(3C) getut(3C) (TO BE OBSOLETED) LOGIN_PROCESS , USER_PROCESS , or DEAD_PROCESS , getutid() returns a pointer to the first entry whose type is one of these four, and whose ut_id field matches id -ut_id. If end-of-file is reached without a match, getutid() fails. g getutline() Searches forward from the current point in the utmp file until it finds an entry of type LOGIN_PROCESS or USER_PROCESS that also has a ut_line string matching the line -ut_line string.
getut(3C) getut(3C) (TO BE OBSOLETED) Reentrant Interfaces getutent_r() , getutid_r() , Upon successful completion, pututline_r() return 0. Otherwise, they all return -1 and set errno . getutline_r() and ERRORS Reentrant Interfaces [EINVAL] The utmp or ud parameter is equal to NULL. WARNINGS getutent_r() , getutid_r() , getutline_r(), pututline_r(), setutent_r() , endutent_r() , and utmpname_r() are obsolescent interfaces supported only for compatibility with existing DCE applications.
getuts(3C) getuts(3C) NAME getuts: endutsent(), getutsent(), getutsid(), getutsline(), pututsline(), setutsent(), ENDUTSENT(), GETUTSENT(), GETUTSID(), GETUTSLINE(), PUTUTSLINE(), SETUTSENT(), - access and update routines for user-accounting database maintained by utmpd SYNOPSIS g #include
getuts(3C) getuts(3C) irrespective of the current position in the internal ordering and does not alter the current position in the internal ordering for the getutsent() API. If ut_type specified is RUN_LVL , BOOT_TIME , OLD_TIME , or NEW_TIME , getutsid() fetches an entry with a ut_type matching id->ut_type. If no matching entry is found getutsid() fails and returns NULL. The macro GETUTSID() is a wrapper around getutsid() and implicitly passes the utmps_size parameter to getutsid() .
getuts(3C) getuts(3C) RETURN VALUE getutsent() , getutsid() , getutsline() , pututsline() , and getutspid() return a pointer to static utmps structure on success. On failure they return NULL. ERRORS [EINVAL] The size parameter passed to the getuts functions does not match any of the structure sizes supported by the server.
getutx(3C) getutx(3C) NAME getutx: endutxent(), getutxent(), getutxid(), getutxline(), pututxline(), setutxent() - access utmpx file entry SYNOPSIS #include
getutx(3C) getutx(3C) pututxline() . If the search has already been made, pututxline() does not repeat it. If pututxline() does not find a matching slot for the new entry, it adds a new entry to the end of the file. g setutxent() Resets the input stream to the beginning of the file. This should be done before each search for a new entry if it is desired that the entire file be examined. endutxent() Closes the currently open file. The most current entry is saved in a static structure.
getwc(3C) getwc(3C) NAME getwc(), getwchar(), fgetwc() - get a wide character from a stream file SYNOPSIS #include wint_t getwc(FILE *stream); wint_t getwchar(void); wint_t fgetwc(FILE *stream); Obsolescent Interfaces wint_t getwc_unlocked(FILE *stream); wint_t getwchar_unlocked(void); wint_t fgetwc_unlocked(FILE *stream); Remarks These functions are compliant with the XPG4 Worldwide Portability Interface wide-character I/O functions.
getwc(3C) getwc(3C) [EINTR] The read operation was terminated due to the receipt of a signal, and either no data was transferred or the implementation does not report partial transfer for this file. [EIO] A physical I/O error has occurred, or the process is a member of a background process and is attempting to read from its controlling terminal, and either the process is ignoring or blocking the SIGTTIN signal or the process group of the process is orphaned.
getwd(3C) getwd(3C) NAME getwd( ) - get pathname of current working directory SYNOPSIS #include char *getwd(char *buf); DESCRIPTION getwd() places the absolute pathname of the current working directory in the array pointed to by buf, and returns buf. If the length of the pathname of the current working directory is greater than PATH_MAX+1 bytes, getwd() fails and returns a null pointer. RETURN VALUE Upon successful completion, getwd() returns a pointer to the current directory pathname.
getwin(3X) getwin(3X) (ENHANCED CURSES) NAME getwin, putwin — dump window to, and reload window from, a file SYNOPSIS #include WINDOW *getwin(FILE *filep); int putwin(WINDOW *win, FILE *filep); DESCRIPTION The getwin() function reads window-related data stored in the file by putwin() . The function then creates and initialises a new window using that data. The putwin() function writes all data associated with win into the stdio stream to which filep points, using an unspecified format.
getyx(3X) getyx(3X) (CURSES) NAME getyx — get cursor and window coordinates SYNOPSIS #include void getyx(WINDOW *win, int y, int x); DESCRIPTION The getyx() macro stores the cursor position of the specified window in y and x. RETURN VALUE No return values are defined. ERRORS No errors are defined. APPLICATION USAGE These interfaces are macros and ‘&’ cannot be used before the y and x arguments. g SEE ALSO getbegyx(3X), . CHANGE HISTORY First released in X/Open Curses, Issue 2.
glob(3C) glob(3C) NAME glob(), globfree() - file name generation function SYNOPSIS #include int glob( const char *__restrict pattern, int flags, int (*errfunc)(const char *, int), glob_t *__restrict pglob ); void globfree(glob_t *pglob); g DESCRIPTION glob() is a path name generator. pattern is a pointer to a path name pattern to be expanded. If pattern contains any of the special characters *, ?, or [, pattern is matched against all accessible path names.
glob(3C) glob(3C) • The count returned in pglob −> gl_pathc will be the total number of path names from the two calls. • The application can change any of the fields after a call to glob() . If it does, it must reset them to the original value before a subsequent call, using the same pglob value, to globfree() or glob() with the GLOB_APPEND flag.
glob(3C) glob(3C) STANDARDS CONFORMANCE glob() : XPG4, POSIX.2 globfree() : XPG4, POSIX.
grantpt(3C) grantpt(3C) NAME grantpt - grant access to the STREAMS slave pty SYNOPSIS int grantpt (int fildes); DESCRIPTION The passed parameter, fildes, is a file descriptor that is returned from a successful open of a STREAMS master pty (pseudo-terminal) device. The grantpt() function modifies the ownership and mode of the slave pty device special file associated with its master pty counterpart.
gss_accept_sec_context(3) gss_accept_sec_context(3) NAME gss_accept_sec_context( ) - establish a security context between the application and a context acceptor SYNOPSIS #include
gss_accept_sec_context(3) gss_accept_sec_context(3) actual_mech_type Actual mechanism used. Specify NULL if not required. output_token Returns a token to pass to the context acceptor. If no token is to be passed to the context acceptor, the routine sets the length field of the returned token buffer to 0 (zero). ret_flags Returns a bitmask containing six independent flags, each of which requests that the context support a service option.
gss_accept_sec_context(3) False time_rec gss_accept_sec_context(3) The security context is not transferable. Returns the number of seconds for which the context remains valid. This is optional information. If the time is not required, specify NULL. delegated_cred_handle Returns the credential handle for credentials received from the context initiator. The credential handle is valid only if delegated credentials are available.
gss_acquire_cred(3) gss_acquire_cred(3) NAME gss_acquire_cred( ) - allow an application to acquire a handle for an existing, named credential SYNOPSIS #include
gss_acquire_cred(3) GSS_S_NO_CRED GSS_S_FAILURE gss_acquire_cred(3) No credentials were found for the specified name. The routine failed. See the minor_status parameter return value for more information. AUTHOR gss_acquire_cred() was developed by Sun Microsystems, Inc. SEE ALSO gss_init_sec_context(3). The manpages for DCE-GSSAPI are included with the DCE-CoreTools product. To see those manpages add /opt/dce/share/man to MANPATH .
gss_add_cred(3) gss_add_cred(3) NAME gss_add_cred( ) - adds a credential-element to a credential SYNOPSIS #include
gss_add_cred(3) gss_add_cred(3) parameter, the newly acquired credential-element will be added to the credential identified by input_cred_handle. g actual_mechs Returns a set of mechanisms for which the credential is valid. This information is optional. If you do not want a set of mechanisms returned, specify NULL. initiator_time_rec Specifies the actual number of seconds that credentials remain valid for initiating security contexts using the specified mechanism.
gss_add_oid_set_member(3) gss_add_oid_set_member(3) NAME gss_add_oid_set_member( ) - add an Object Identifier (OID) to an OID set SYNOPSIS #include OM_uint32 gss_add_oid_set_member ( OM_uint32* minor_status, gss_OID* member_OID, gss_OID_set* OID_set) DESCRIPTION The gss_add_oid_set_member() routine adds a new Object Identifier to an Object Identifier set. If an OID set does not exist, you can create a new, empty OID set with the gss_create_empty_oid_set() routine.
gss_canonicalize_name(3) gss_canonicalize_name(3) NAME gss_canonicalize_name( ) - convert an internal name to an internal mechanism name (MN) representation of an opaque internal name SYNOPSIS #include OM_uint32 gss_canonicalize_name ( OM_uint32 *minor_status, const gss_name_t input_name, const gss_OID *mech_type, gss_name_t *output_name) g DESCRIPTION The gss_canonicalize_name() routine generate a canonical mechanism name (MN) from an arbitrary internal name.
gss_compare_name(3) gss_compare_name(3) NAME gss_compare_name( ) - allow an application to compare two internal names to determine whether they are equivalent SYNOPSIS #include OM_uint32 gss_compare_name ( OM_uint32 *minor_status, const gss_name_t name1, const gss_name_t name2, int *name_equal) DESCRIPTION The gss_compare_name() routine lets an application compare two internal names to determine whether they are the same.
gss_context_time(3) gss_context_time(3) NAME gss_context_time( ) - check the number of seconds the context will remain valid SYNOPSIS #include OM_uint32 gss_context_time ( OM_uint32 *minor_status, const gss_ctx_id_t context_handle, OM_int32 *time_rec) DESCRIPTION The gss_context_time() routine checks the number of seconds for which the context will remain valid. Input Parameters context_handle g Output Parameters time_rec minor_status Specifies the context to be checked.
gss_create_empty_oid_set(3) gss_create_empty_oid_set(3) NAME gss_create_empty_oid_set( ) - create a new, empty OID set, to which members can be added SYNOPSIS #include OM_uint32 gss_create_empty_oid_set ( OM_uint32 *minor_status, gss_OID_set *OID_set); DESCRIPTION The gss_create_empty_oid_set( ) routine creates a new, empty OID set to which the context initiator can add members. Use the gss_add_oid_set_member( ) routine to add members to the OID set.
gss_delete_sec_context(3) gss_delete_sec_context(3) NAME gss_delete_sec_context( ) - delete a security context SYNOPSIS #include OM_uint32 gss_delete_sec_context ( OM_uint32 *minor_status, gss_ctx_id_t *context_handle, gss_buffer_t output_token_buffer) DESCRIPTION The gss_delete_sec_context( ) routine deletes a security context. It also deletes the local data structures associated with the security context. When it deletes the context, the routine can generate a token.
gss_display_name(3) gss_display_name(3) NAME gss_display_name( ) - provide textual representation of an opaque internal name to an application SYNOPSIS #include OM_uint32 gss_display_name ( OM_uint32 *minor_status, const gss_name_t input_name, gss_buffer_t output_name_buffer, gss_OID *output_name_type) DESCRIPTION The gss_display_name( ) routine provides an application with the text form of an opaque internal name. The application can use the text to display the name but not to print it.
gss_display_status(3) gss_display_status(3) NAME gss_display_status( ) - provide an application with the textual representation of a GSSAPI status code that can be displayed to a user or used for logging SYNOPSIS #include
gss_display_status(3) gss_display_status(3) SEE ALSO The manpages for DCE-GSSAPI are included with the DCE-CoreTools product. To see those manpages add /opt/dce/share/man to MANPATH .
gss_duplicate_name(3) gss_duplicate_name(3) NAME gss_duplicate_name( ) - allow an application to create an exact duplicate of the existing internal name SYNOPSIS #include OM_uint32 gss_duplicate_name ( OM_uint32 *minor_status, const gss_name_t src_name, gss_name_t *dest_name) DESCRIPTION The gss_duplicate_name( ) routine create an exact duplicate of the existing internal name src_name. The new dest_name will be independent of src_name.
gss_export_name(3) gss_export_name(3) NAME gss_export_name() - convert a mechanism name (MN) to a form suitable for direct comparison SYNOPSIS #include OM_uint32 gss_export_name ( OM_uint32 *minor_status, const gss_name_t input_name, gss_buffer_t exported_name) DESCRIPTION The gss_export_name() converts a mechanism name (MN) to export form. Input Parameters input_name Specifies the mechanism name (MN) to be exported.
gss_export_sec_context(3) gss_export_sec_context(3) NAME gss_export_sec_context() - transfer a security context to another process on a single machine SYNOPSIS #include
gss_get_mic(3) gss_get_mic(3) NAME gss_get_mic( ) - calculate a cryptographic message integrity code (MIC) for a message and return in a token SYNOPSIS #include
gss_import_name(3) gss_import_name(3) NAME gss_import_name( ) - convert a printable name to an internal form SYNOPSIS #include OM_uint32 gss_import_name ( OM_uint32 *minor_status, const gss_buffer_t input_buffer_name, const gss_OID input_name_type, gss_name_t *output_name) DESCRIPTION The gss_import_name( ) routine converts a printable name to an internal form.
gss_import_sec_context(3) gss_import_sec_context(3) NAME gss_import_sec_context( ) - transfer a security context to another process on a single machine SYNOPSIS #include OM_uint32 gss_import_sec_context ( OM_uint32 *minor_status, const gss_buffer_t interprocess_token) gss_ctx_id_t *context_handle) DESCRIPTION The gss_import_sec_context( ) routine lets a process to import a security context established by another process. A given interprocess token may be imported only once.
gss_indicate_mechs(3) gss_indicate_mechs(3) NAME gss_indicate_mechs() - allow an application to determine which underlying security mechanisms are available SYNOPSIS #include OM_uint32 gss_indicate_mechs ( OM_uint32 *minor_status, gss_OID_set *mech_set) DESCRIPTION The gss_indicate_mechs( ) routine enables an application to determine which underlying security mechanisms are available. Output Parameters mech_set g minor_status Returns the set of supported security mechanisms.
gss_init_sec_context(3) gss_init_sec_context(3) NAME gss_init_sec_context() - establish a security context between the context initiator and a context acceptor SYNOPSIS #include
gss_init_sec_context(3) gss_init_sec_context(3) GSS_C_MUTUAL_FLAG. The True/False values are: True The context acceptor has been asked to authenticate itself. False The context initiator has not been asked to authenticates itself. GSS_C_REPLAY_FLAG. The True/False values are: True Replayed signed or sealed messages will be detected. False Replayed messages will not be detected. GSS_C_SEQUENCE_FLAG. The True/False values are: True Out-of-sequence signed or sealed messages will be detected.
gss_init_sec_context(3) gss_init_sec_context(3) True Replayed signed or sealed messages will be detected. False Replayed messages will not be detected. GSS_C_SEQUENCE_FLAG. The True/False values are: True Out-of-sequence signed or sealed messages will be detected. False Out-of-sequence signed or sealed messages will not be detected. GSS_C_CONF_FLAG. The True/False values are: True Confidentiality service can be invoked by calling the gss_seal() routine.
gss_init_sec_context(3) gss_init_sec_context(3) GSS_S_CREDENTIALS_EXPIRED The referenced credentials have expired. GSS_S_DEFECTIVE_CREDENTIAL Consistency checks performed on the credential failed. GSS_S_DEFECTIVE_TOKEN Consistency checks performed on the input_token parameter failed. GSS_S_DUPLICATE_TOKEN The input_token parameter was already processed. This is a fatal error that occurs during context establishment. g GSS_S_FAILURE The routine failed.
gss_inquire_context(3) gss_inquire_context(3) NAME gss_inquire_context() - obtain information about a security context SYNOPSIS #include
gss_inquire_context(3) gss_inquire_context(3) True Out-of-sequence signed or sealed messages will be detected. False Out-of-sequence signed or sealed messages will not be detected. GSS_C_CONF_FLAG. The True/False values are: True Request that confidentiality service be made available False No per-message confidentiality service is required. GSS_C_INTEG_FLAG. The True/False values are: True Request that integrity service be be made available False No per-message integrity service is required.
gss_inquire_cred(3) gss_inquire_cred(3) NAME gss_inquire_cred() - provide the calling application information about a credential SYNOPSIS #include OM_uint32 gss_inquire_cred ( OM_uint32 *minor_status, const gss_cred_id_t cred_handle, gss_name_t *name, OM_uint32 *lifetime, int *cred_usage, gss_OID_set *mechs) DESCRIPTION The gss_inquire_cred() routine provides information about a credential to the calling application.
gss_inquire_cred(3) gss_inquire_cred(3) The manpages for DCE-GSSAPI are included with the DCE-CoreTools product. To see those manpages add /opt/dce/share/man to MANPATH .
gss_inquire_cred_by_mech(3) gss_inquire_cred_by_mech(3) NAME gss_inquire_cred_by_mech() - provide the calling application per-mechanism information about a credential SYNOPSIS #include .
gss_inquire_cred_by_mech(3) GSS_S_NO_CRED gss_inquire_cred_by_mech(3) The routine could not access the credentials. AUTHOR gss_inquire_cred_by_mech() was developed by Sun Microsystems, Inc. SEE ALSO gss_acquire_cred(3). The manpages for DCE-GSSAPI are included with the DCE-CoreTools product. To see those manpages add /opt/dce/share/man to MANPATH .
gss_inquire_mechs_for_name(3) gss_inquire_mechs_for_name(3) NAME gss_inquire_mechs_for_name() - list the mechanisms that support the specified name-type SYNOPSIS #include OM_uint32 gss_inquire_mechs_for_name ( OM_uint32 *minor_status, const gss_name_t input_name, gss_OID_set *mech_types) DESCRIPTION The gss_inquire_mechs_for_name() routine returns the set of mechanisms supported by the GSS-API implementation that may be able to process the specified name.
gss_inquire_names_for_mech(3) gss_inquire_names_for_mech(3) NAME gss_inquire_names_for_mech() - list the name-types supported by the specified mechanism SYNOPSIS #include OM_uint32 gss_inquire_names_for_mech ( OM_uint32 *minor_status, const gss_OID *mechanism, gss_OID_set *name_types) DESCRIPTION The gss_inquire_names_for_mech() routine returns the set of nametypes supported by the specified mechanism. g Input Parameters mechanism The mechanism to be interrogated.
gss_process_context_token(3) gss_process_context_token(3) NAME gss_process_context_token() - process a context to the security service SYNOPSIS #include OM_uint32 gss_process_context_token ( OM_uint32 *minor_status, const gss_ctx_id_t *context_handle, const gss_buffer_t input_token_buffer) DESCRIPTION The gss_process_context_token() routine passes tokens gss_delete_security_context() routine to the security service.
gss_release_buffer(3) gss_release_buffer(3) NAME gss_release_buffer() - free storage associated with a buffer SYNOPSIS #include OM_uint32 gss_release_buffer ( OM_uint32 *minor_status, gss_buffer_t buffer) DESCRIPTION The gss_release_buffer() routine deletes the buffer by freeing the storage associated with it. g Input Parameters buffer The buffer to delete. Output Parameters minor_status Returns a status code from the security mechanism.
gss_release_cred(3) gss_release_cred(3) NAME gss_release_cred() - mark a credential for deletion SYNOPSIS #include OM_uint32 gss_release_cred ( OM_uint32 *minor_status, gss_cred_id_t *cred_handle) DESCRIPTION The gss_release_cred() routine informs the GSSAPI that a credential is no longer required and marks it for deletion. Input Parameters cred_handle Output Parameters minor_status Specifies the buffer containing the opaque credential handle to be released.
gss_release_name(3) gss_release_name(3) NAME gss_release_name() - free storage associated with an internal name allocated by a GSSAPI routine SYNOPSIS #include OM_uint32 gss_release_name ( OM_uint32 *minor_status, gss_name_t *name) DESCRIPTION The gss_release_name() routine deletes the internal name by freeing the storage associated with that internal name. g Input Parameters name The name to delete. Output Parameters minor_status Returns a status code from the security mechanism.
gss_release_oid_set(3) gss_release_oid_set(3) NAME gss_release_oid_set() - free storage associated with a gss_OID_set object SYNOPSIS #include OM_uint32 gss_release_oid_set ( OM_uint32 *minor_status, gss_OID_set *set) DESCRIPTION The gss_release_oid_set() routine frees storage that is associated with the gss_OID_set parameter and was allocated by a GSSAPI routine. Input Parameters set The storage associated with the gss_OID_set will be deleted.
gss_test_oid_set_member(3) gss_test_oid_set_member(3) NAME gss_test_oid_set_member() - check an OID set for a specified OID SYNOPSIS #include OM_uint32 gss_test_oid_set_member ( OM_uint32 *minor_status, const gss_OID member_OID, const gss_OID_set set, int* is_present /* 1 = present, 0 = absent */ ); DESCRIPTION The gss_test_oid_set_member() routine checks an OID set to see if the specified OID is a member of the set. To add a member to an OID set, use the gss_add_oid_set_member() routine.
gss_unwrap(3) gss_unwrap(3) NAME gss_unwrap - verify a message with attached message integrity code (MIC) and decrypt message content if necessary SYNOPSIS #include OM_uint32 gss_unwrap ( OM_uint32 *minor_status, gss_ctx_id_t context_handle, gss_buffer_t input_message_buffer, gss_buffer_t output_message_buffer, int *conf_state, gss_qop_t *qop_state) DESCRIPTION The gss_unwrap() routine converts a protected message to a usable form and verifies the embedded message integrity code (MIC).
gss_unwrap(3) GSS_S_GAP_TOKEN gss_unwrap(3) The token was valid, and contained a correct MIC for the message, but has been verified out of sequence; an earlier expected token has not yet been received. AUTHOR gss_unwrap() was developed by Sun Microsystems, Inc. SEE ALSO gss_get_mic(3), gss_wrap(3).
gss_verify_mic(3) gss_verify_mic(3) NAME gss_verify_mic() - check a cryptographic message integrity code (MIC) against a message to verify its integrity SYNOPSIS #include OM_uint32 gss_verify_mic( OM_uint32 *minor_status, const gss_ctx_id_t context_handle, const gss_buffer_t message_buffer, const gss_buffer_t token_buffer) gss_qop_t *qop_state) DESCRIPTION The gss_verify_mic() routine verifies that a cryptographic MIC, contained in the token_buffer parameter, fits the supplied message.
gss_wrap(3) gss_wrap(3) NAME gss_wrap() - attach a message integrity code (MIC) to a message, and optionally encrypt the message content SYNOPSIS #include
gss_wrap(3) gss_wrap(3) SEE ALSO gss_unwrap(3), gss_wrap_size_limit(3). The manpages for DCE-GSSAPI are included with the DCE-CoreTools product. To see those manpages add /opt/dce/share/man to MANPATH .
gss_wrap_size_limit(3) gss_wrap_size_limit(3) NAME gss_wrap_size_limit() - determine a token-size limit for gss_wrap on a context SYNOPSIS #include
halfdelay(3X) halfdelay(3X) (ENHANCED CURSES) NAME halfdelay — control input character delay mode SYNOPSIS #include int halfdelay(int tenths); DESCRIPTION The halfdelay() function sets the input mode for the current window to Half-Delay Mode and specifies tenths tenths of seconds as the half-delay interval. The tenths argument must be in a range from 1 up to and including 255. RETURN VALUE Upon successful completion, halfdelay() returns OK. Otherwise, it returns ERR.
has_ic(3X) has_ic(3X) (CURSES) NAME has_ic, has_il — query functions for terminal insert and delete capability SYNOPSIS #include bool has_ic(void); bool has_il(void); DESCRIPTION The has_ic() function indicates whether the terminal has insert- and delete-character capabilities. The has_il() function indicates whether the terminal has insert- and delete-line capabilities, or can simulate them using scrolling regions.
hg(3) hg(3) (Mercury Library) NAME hg: hg_busywait(), hg_context_switch_involuntary(), hg_context_switch_tries(), hg_context_switch_voluntary(), hg_gethrcycles(), hg_gethrtime(), hg_getspu(), hg_nano_to_cycle_ratio(), hg_public_init(), hg_public_is_onRunQ(), hg_public_is_reporting(), hg_public_is_running(), hg_public_nMailboxes(), hg_public_nMailboxesInUse(), hg_public_remove(), hg_setcrit() - Mercury Library Interfaces to transfer data between user and kernel space in a lightweight manner SYNOPSIS #incl
hg(3) hg(3) (Mercury Library) The run state information of any thread is stored in a publicly available user-mapped mailbox. The kernel continually posts and updates the run state of the calling kernel thread in the mailbox, when possible. Keep in mind that all information is to be regarded as hints about the state and that no guarantees are implied, from any of the APIs providing the run state information on threads, although a good faith effort is made to keep it accurate.
hg(3) hg(3) (Mercury Library) hg_gethrtime (void); hg_gethrtime() is identical to hg_gethrcycles() but returns the time since boot in nanoseconds instead of machine cycles. This call can generally be expected to return times in a monotonically-increasing sequence too, but there is an exception. The exact clock rate each processor runs at can drift back and forth by a small amount around the central, rated value.
hg(3) hg(3) (Mercury Library) hg_public_is_reporting() will return zero if not reporting and non-zero if reporting hg_public_is_running() will return zero if not running and non-zero if running. hg_public_is_onRunQ() will return 0 if not on run queue and non-zero if on run queue. hg_public_nMailboxes() returns the total number of mailboxes available for attachment. hg_public_nMailboxesInUse() returns the number of mailboxes available for attachment at the time of calling.
hg(3) hg(3) (Mercury Library) release lock hg_setcrit(CRIT_OFF, WILLING_TO_BLOCK); Or ... hg_setcrit( lock_address , WILLING_TO_BLOCK); acquire lock critical region release lock hg_setcrit(CRIT_OFF, WILLING_TO_BLOCK); It is never absolutely necessary to set WILLING_TO_BLOCK, but it reduces your chances of being switched out during the critical region. Remember that WILLING_TO_BLOCK means that you are willing to block during the hg_setcrit() call, not during the critical region.
hline(3X) hline(3X) (ENHANCED CURSES) NAME hline, mvhline, mvvline, mvwhline, mvwvline, vline, whline, wvline — draw lines from single-byte characters and renditions SYNOPSIS #include
hline_set(3X) hline_set(3X) (ENHANCED CURSES) NAME hline_set, mvhline_set, mvvline_set, mvwhline_set, mvwvline_set, vline_set, whline_set, wvline_set — draw lines from complex characters and renditions SYNOPSIS #include
hosts_access(3) hosts_access(3) NAME hosts_access(), hosts_ctl(), request_init(), request_set() - access control library SYNOPSIS #include extern int allow_severity; extern int deny_severity; extern int rfc931_timeout; struct request_info *request_init(request, key, value, ..., 0) struct request_info *request; struct request_info *request_set(request, key, value, ...
hosts_access(3) hosts_access(3) The allow_severity and deny_severity variables determine how accepted and rejected requests may be logged. They must be provided by the caller and may be modified by rules in the access control tables. The rfc931_timeout variable determines the timeout value for the client’s username lookup. It must be set with a positive value and a value of 0 disables the username lookup.
hppac(3X) hppac(3X) (PA-RISC Systems Only) NAME hppac: HPPACADDD(), HPPACCMPD(), HPPACCVAD(), HPPACCVBD(), HPPACCVDA(), HPPACCVDB(), HPPACDIVD(), HPPACLONGDIVD(), HPPACMPYD(), HPPACNSLD(), HPPACSLD(), HPPACSRD(), HPPACSUBD() - HP 3000-mode packed-decimal library SYNOPSIS #include
hppac(3X) hppac(3X) (PA-RISC Systems Only) enum HPPAC_CC *compcode, int *pacstatus ); void HPPACLONGDIVD( unsigned char *operand2, int op2digs, unsigned char *operand1, int op1digs, enum HPPAC_CC *compcode, int *pacstatus ); void HPPACMPYD( unsigned char *operand2, int op2digs, unsigned char *operand1, int op1digs, enum HPPAC_CC *compcode, int *pacstatus ); void HPPACNSLD( unsigned char *operand2, int op2digs, unsigned char *operand1, int op1digs, int *shift_amt, enum HPPAC_CC *compcode, int *pacstatus, i
hppac(3X) hppac(3X) (PA-RISC Systems Only) DESCRIPTION This set of calls invokes the library functions for emulating 3000-mode (MPE V/E) packed-decimal operations. These functions are in library libcl which is searched when the option -lcl is used with cc or ld(1). HPPACADDD() HPPACCMPD() HPPACCVAD() HPPACCVBD() HPPACCVDA() HPPACCVDB() HPPACDIVD() HPPACLONGDIVD() HPPACMPYD() HPPACNSLD() HPPACSLD() HPPACSRD() HPPACSUBD() h Performs packed-decimal addition. Compares two packed-decimal numbers.
hsearch(3C) hsearch(3C) NAME hsearch( ), hcreate( ), hdestroy( ) - manage hash search tables SYNOPSIS #include ENTRY *hsearch(ENTRY item, ACTION action); int hcreate(size_t nel); void hdestroy(void); DESCRIPTION hsearch() is a hash-table search routine generalized from Knuth (6.4) Algorithm D. It returns a pointer into a hash table indicating the location at which an entry can be found.
hsearch(3C) hsearch(3C) /* put info in structure, and structure in item */ item.key = str_ptr; item.data = (char *)info_ptr; str_ptr += strlen(str_ptr) + 1; info_ptr++; /* put item into table */ (void) hsearch(item, ENTER); } /* access table */ item.key = name_to_find; while (scanf("%s", item.
hypot(3M) hypot(3M) NAME hypotf( ), hypotl( ), hypotw( ), hypotq( ) - Euclidean distance functions SYNOPSIS #include double hypot(double x, double y); HP Integrity Server Only float hypotf(float x, float y); long double hypotl(long double x, long double y); extended hypotw(extended x, extended y); quad hypotq(quad x, quad y); DESCRIPTION hypot() computes the square root of the sum of the squares of x and y, without undue overflow or underflow.
iconv(3C) iconv(3C) NAME iconv(), iconv_open(), iconv_close() - codeset conversion routines SYNOPSIS #include iconv_t iconv_open(const char *tocode , const char *fromcode ); size_t iconv( iconv_t cd , const char **inbuf, size_t *inbytesleft , char **outbuf , size_t *outbytesleft ); int iconv_close(iconv_t cd ); Remarks These interfaces conform to the XPG4 standard, and should be used instead of the 9.
iconv(3C) iconv(3C) If a sequence of input bytes does not form a valid character in the specified codeset, conversion stops after the previous successfully converted character. If the input buffer ends with an incomplete character or shift sequence (see Special Usage section), conversion stops after the previous successfully converted character.
iconv(3C) iconv(3C) iconv() fails if any of the following conditions are encountered: [EILSEQ] Input conversion stopped due to an input character that does not belong to the input codeset, or if the conversion table does not contain an entry corresponding to this input character and a galley character was not defined for that particular table. [E2BIG] Input conversion stopped due to lack of space in the output buffer.
iconv(3C) iconv(3C) (size_t)BUFSIZ-inbytesleft)) < 0) { perror("prog"); return BAD; } if (!(inbytesleft += bytesread)) { break; /* end of conversions */ } ret_val = iconv(cd, &inchar, &inbytesleft, &outchar, &outbytesleft); if (write(1, outbuf, (size_t)BUFSIZ-outbytesleft) < 0) { perror("prog"); return BAD; } /* iconv() returns the number of non-identical conversions * performed. If the entire string in the input buffer is * converted, the value pointed to by inbytesleft will be * zero.
iconv(3C) iconv(3C) Or compile with CCOPTS and LDOPTS : export CCOPTS="-Wl,-a,archive options -Wl,-E -l:libdld.sl" export LDOPTS=" options -E +n -l:libdld.sl" cc -o outfile source The option -Wl,-a,archive is positionally dependent and should occur at the beginning of the compile line. For optimum compatibility in future releases, you should avoid using archive libc with other shared libraries except for libdld.sl as needed above.
idcok(3X) idcok(3X) (ENHANCED CURSES) NAME idcok — enable or disable use of hardware insert- and delete-character features SYNOPSIS #include void idcok(WINDOW *win, bool bf); DESCRIPTION The idcok() function specifies whether the implementation may use hardware insert- and deletecharacter features in win if the terminal is so equipped. If bf is TRUE, use of these features in win is enabled. If bf is FALSE, use of these features in win is disabled. The initial state is TRUE.
if_nameindex(3N) if_nameindex(3N) NAME if_nameindex(), if_nametoindex(), if_indextoname(), if_freenameindex() - functions that map between an interface name and index value SYNOPSIS #include unsigned int if_nametoindex(const char *ifname); char *if_indextoname(unsigned int ifindex, char *ifname); struct if_nameindex *if_nameindex(void); void if_freenameindex(struct if_nameindex *ptr); DESCRIPTION Interfaces are normally known by names such as "lan0" and "vlan200.
if_nameindex(3N) if_nameindex(3N) ERRORS When if_nametoindex() or if_indextoname() fails, the following error message is set in errno . [ENXIO] The specified interface or index does not exist. SEE ALSO ndp(1M), inet6_opt_init(3N), inet6_rth_space(3N), IPv6(7P), ndp(7P).
ilogb(3M) ilogb(3M) NAME ilogb(), ilogbf(), ilogbl(), ilogbw(), ilogbq() - radix-independent exponent functions SYNOPSIS #include int ilogb(double x); Integrity Server Only int int int int ilogbf(float x); ilogbl(long double x); ilogbw(extended x); ilogbq(quad x); DESCRIPTION The ilogb() function computes the exponent of the floating point value x.
immedok(3X) immedok(3X) (ENHANCED CURSES) NAME immedok — enable or disable immediate terminal refresh SYNOPSIS #include void immedok(WINDOW *win, bool bf); DESCRIPTION The immedok() function specifies whether the screen is refreshed whenever the window pointed to by win is changed. If bf is TRUE, the window is implicitly refreshed on each such change. If bf is FALSE, the window is not implicitly refreshed. The initial state is FALSE. RETURN VALUE The immedok() function does not return a value.
in_wch(3X) in_wch(3X) (ENHANCED CURSES) NAME in_wch, mvin_wch, mvwin_wch, win_wch — input a complex character and rendition from a window SYNOPSIS #include
in_wchnstr(3X) in_wchnstr(3X) (ENHANCED CURSES) NAME in_wchnstr, in_wchstr, mvin_wchnstr, mvin_wchstr, mvwin_wchnstr, mvwin_wchstr, win_wchnstr, win_wchstr — input an array of complex characters and renditions from a window SYNOPSIS #include
inch(3X) inch(3X) (CURSES) NAME inch, mvinch, mvwinch, winch — input a single-byte character and rendition from a window SYNOPSIS #include chtype inch(void); chtype mvinch(int y, int x); chtype mvwinch(WINDOW *win, int y, int x); chtype winch(WINDOW *win); DESCRIPTION These functions return the character and rendition, of type chtype, at the current or specified position in the current or specified window.
inchnstr(3X) inchnstr(3X) (ENHANCED CURSES) NAME inchnstr, inchstr, mvinchnstr, mvinchstr, mvwinchnstr, mvwinchstr, winchnstr, winchstr — input an array of single-byte characters and renditions from a window SYNOPSIS #include
inet(3N) inet(3N) NAME inet: inet_addr(), inet_lnaof(), inet_makeaddr(), inet_netof(), inet_network(), inet_ntoa(), inet_ntoa_r() Internet address manipulation routines SYNOPSIS #include #include #include
inet(3N) inet(3N) When a two-part address is supplied, the last part is interpreted as a 24-bit quantity and placed in the right-most three bytes of the network address. This makes the two-part address format convenient for specifying Class A network addresses as in net.host . When only one part is given, the value is stored directly in the network address without any byte rearrangement. All numbers supplied as parts in dot notation can be decimal, octal, or hexadecimal, as specified in the C language (i.
inet6(3N) inet6(3N) NAME inet_pton(), inet_ntop() - Internet address manipulation routines for IP Version 4 and later SYNOPSIS #include #include int inet_pton(int af, const char *src, void *dst); const char *inet_ntop(int af, const void *src, char *dst, size_t size); DESCRIPTION The functions inet_pton() and inet_ntop() are new with IP Version 6 (IPv6) and work with both IP Version 4 (IPv4) and IPv6 addresses. The letters "p" and "n" stand for presentation and numeric .
inet6(3N) inet6(3N) 16-octets. In order to allow applications to easily declare buffers of the proper size to store IPv4 and IPv6 addresses in string form, the following two constants are defined in : #define INET_ADDRSTRLEN 16 #define INET6_ADDRSTRLEN 46 The inet_ntop() function returns a pointer to the buffer containing the text string if the conversion succeeds, and NULL otherwise.
inet6(3N) inet6(3N) ::FFFF:1.2.3.5 or ::FFFF:102:305 AUTHOR These inet routines were developed by the University of California, Berkeley. SEE ALSO gethostent(3N), getnetent(3N), inet(3N), hosts(4), networks(4).
inet6_opt_init(3N) inet6_opt_init(3N) NAME inet6_opt_init(), inet6_opt_append(), inet6_opt_find(), inet6_opt_finish(), inet6_opt_get_val(), inet6_opt_next(), inet6_opt_set_val() - IPv6 Hop-by-Hop and Destination options manipulation functions SYNOPSIS #include
inet6_opt_init(3N) inet6_opt_init(3N) any needed pad option, initializes the option (sets the type and length fields), and returns a pointer to the location for the option content in databufp. If the option specified by the type does not fit in the extension header buffer then the function returns -1. The third parameter prevlen should be the length returned by inet6_opt_init() or by a previous inet6_opt_append(). The parameter type is the 8-bit option type and it must be a value from 2 to 255, inclusive.
inet6_opt_init(3N) inet6_opt_init(3N) option content with multiple fields. The first parameter databuf should be a pointer returned by inet6_opt_next() or inet6_opt_find() containing the data portion of the option. offset parameter specifies from where in the data portion of the option the value should be extracted. The first byte after the option type and length is accessed by specifying an offset of zero. val points to the destination for the extracted data.
inet6_rth_space(3N) inet6_rth_space(3N) NAME inet6_rth_add(), inet6_rth_getaddr(), inet6_rth_init(), inet6_rth_reverse(), inet6_rth_space() - IPv6 Routing header options manipulation functions. inet6_rth_segments(), SYNOPSIS #include
inet6_rth_space(3N) inet6_rth_space(3N) If successful, the segleft member of the Routing header is updated to account for the new address in the Routing header and the return value of the function is 0. Upon an error the return value of the function is -1. inet6_rth_reverse() This function takes a Routing header extension header pointed to by the first argument in and writes a new Routing header. The new Routing header sends datagrams along the reverse of that route.
initgroups(3C) initgroups(3C) NAME initgroups( ) - initialize group access list SYNOPSIS #include int initgroups(const char *name, gid_t basegid); DESCRIPTION initgroups() reads the login group file, /etc/logingroup, and sets up the group access list for the user specified by name, using the setgroups(2) system call. If the value of basegid is zero or positive, it is automatically included in the groups list. Typically this value is given as the group number from the password file.
initscr(3X) initscr(3X) (CURSES) NAME initscr, newterm — screen initialisation functions SYNOPSIS #include WINDOW *initscr(void); SCREEN *newterm(char *type, FILE *outfile, FILE *infile); DESCRIPTION The initscr() function determines the terminal type and initialises all implementation data structures. The TERM environment variable specifies the terminal type. The initscr() function also causes the first refresh operation to clear the screen.
innstr(3X) innstr(3X) (ENHANCED CURSES) NAME innstr, instr, mvinnstr, mvinstr, mvwinnstr, mvwinstr, winnstr, winstr — input a multi-byte character string from a window SYNOPSIS #include
innwstr(3X) innwstr(3X) (ENHANCED CURSES) NAME innwstr, inwstr, mvinnwstr, mvinwstr, mvwinnwstr, mvwinwstr, winnwstr, winwstr — input a string of wide characters from a window SYNOPSIS #include
ins_nwstr(3X) ins_nwstr(3X) (ENHANCED CURSES) NAME ins_nwstr, ins_wstr, mvins_nwstr, mvins_wstr, mvwins_nwstr, mvwins_wstr, wins_nwstr, wins_wstr — insert a wide-character string into a window SYNOPSIS #include
ins_wch(3X) ins_wch(3X) (ENHANCED CURSES) NAME ins_wch, mvins_wch, mvwins_wch, wins_wch — insert a complex character and rendition into a window SYNOPSIS #include
insch(3X) insch(3X) (CURSES) NAME insch, mvinsch, mvwinsch, winsch — insert a single-byte character and rendition into a window SYNOPSIS #include int insch(chtype ch); int mvinsch(int y, int x, chtype ch); int mvwinsch(WINDOW *win, int y, int x, chtype ch); int winsch(WINDOW *win, chtype ch); DESCRIPTION These functions insert the character and rendition from ch into the current or specified window at the current or specified position. These functions do not perform wrapping.
insdelln(3X) insdelln(3X) (ENHANCED CURSES) NAME insdelln, winsdelln — delete or insert lines into a window SYNOPSIS #include int insdelln(int n); int winsdelln(WINDOW *win, int n); DESCRIPTION The insdelln() and winsdelln() functions perform the following actions: • If n is positive, these functions insert n lines into the current or specified window before the current line. The n last lines are no longer displayed.
insertln(3X) insertln(3X) (CURSES) NAME insertln, winsertln — insert lines into a window SYNOPSIS #include int insertln(void); int winsertln(WINDOW *win); DESCRIPTION The insertln() and winsertln() functions insert a blank line before the current line in the current or specified window. The bottom line is no longer displayed. The cursor position does not change. RETURN VALUE Upon successful completion, these functions return OK. Otherwise, they return ERR. ERRORS No errors are defined.
insnstr(3X) insnstr(3X) (ENHANCED CURSES) NAME insnstr, insstr, mvinsnstr, mvinsstr, mvwinsnstr, mvwinsstr, winsnstr, winsstr — insert a multi-byte character string into a window SYNOPSIS #include
insque(3C) insque(3C) NAME insque(), remque() - insert or remove an element in a queue SYNOPSIS #include void insque(void *element, void *pred); void remque(void *element); DESCRIPTION The insque() and remque() functions manipulate queues built from doubly-linked lists. An application using these functions must define a structure in which the first two members of the structure are pointers to the same type of structure. Any additional members of the structure are application specific.
intrflush(3X) intrflush(3X) (CURSES) NAME intrflush — enable or disable flush on interrupt SYNOPSIS #include int intrflush(WINDOW *win, bool bf); DESCRIPTION The intrflush() function specifies whether pressing an interrupt key (interrupt, suspend or quit) will flush the input buffer associated with the current screen. If bf is TRUE, pressing an interrupt key will flush this input buffer. If bf is FALSE, pressing an interrupt key will not flush this input buffer.
is_linetouched(3X) is_linetouched(3X) (ENHANCED CURSES) NAME is_linetouched, is_wintouched, touchline, untouchwin, wtouchln — window refresh control functions SYNOPSIS #include bool is_linetouched(WINDOW *win, int line); bool is_wintouched(WINDOW *win); int touchline(WINDOW *win, int start, int count); int untouchwin(WINDOW *win); int wtouchln(WINDOW *win, int y, int n, int changed); DESCRIPTION The touchline() function only touches count lines, beginning with line start.
isastream(3C) isastream(3C) NAME isastream( ) - determine if a file descriptor refers to a STREAMS device or STREAMS-based pipe SYNOPSIS #include int isastream(int fd); DESCRIPTION The isastream() function tests whether an open file descriptor (fd) corresponds to a STREAMS device or STREAMS-based pipe.
isendwin(3X) isendwin(3X) (ENHANCED CURSES) NAME isendwin — determine whether a screen has been refreshed SYNOPSIS #include bool isendwin(void); DESCRIPTION The isendwin() function indicates whether the screen has been refreshed since the last call to endwin() . RETURN VALUE The isendwin() function returns TRUE if endwin() has been called without any subsequent refresh. Otherwise, it returns FALSE. ERRORS No errors are defined. SEE ALSO endwin(3X), .
isfinite(3M) isfinite(3M) NAME isfinite( ) - floating-point finiteness macro SYNOPSIS #include int isfinite( floating-type x); DESCRIPTION The isfinite() macro determines whether its argument has a finite value (zero, denormalized, or normalized, and not infinite or NaN). The argument must be of floating type, and classification is based on the type of the argument. For HP Integrity servers, the argument can be any floating type. For PA-RISC, the argument must be either double or float .
isgreater(3M) isgreater(3M) NAME isgreater( ) - floating-point quiet comparison macro (>) SYNOPSIS #include int isgreater( floating-expr x, floating-expr y); DESCRIPTION The isgreater() macro determines whether its first argument is greater than its second argument. The value of isgreater( x ,y ) is always equal to (x ) > (y ); however, unlike (x ) > (y ), isgreater( x ,y ) does not raise the invalid exception when x and y are unordered. The arguments must be of floating type.
isgreaterequal(3M) isgreaterequal(3M) NAME isgreaterequal( ) - floating-point quiet comparison macro (>=) SYNOPSIS #include int isgreaterequal(floating-expr x, floating-expr y); DESCRIPTION The isgreaterequal() macro determines whether its first argument is greater than or equal to its second argument. The value of isgreaterequal(x ,y ) is always equal to (x ) >= (y ); however, unlike (x ) >= (y ), isgreaterequal(x ,y ) does not raise the invalid exception when x and y are unordered.
isinf(3M) isinf(3M) NAME isinf( ) - floating-point test for infinity SYNOPSIS #include int isinf(floating-type x); DESCRIPTION The isinf() macro determines whether its argument is an infinity. The argument must be of floating type, and classification is based on the type of the argument. For HP Integrity servers, the argument can be any floating type. For PA-RISC, the argument must be either double or float .
isless(3M) isless(3M) NAME isless( ) - floating-point quiet comparison macro (<) SYNOPSIS #include int isless( floating-expr x, floating-expr y); DESCRIPTION The isless() macro determines whether its first argument is less than its second argument. The value of isless( x ,y ) is always equal to (x ) < (y ); however, unlike (x ) isless( x ,y ) does not raise the invalid exception when x and y are unordered. < (y ), The arguments must be of floating type.
islessequal(3M) islessequal(3M) NAME islessequal( ) - floating-point quiet comparison macro (<=) SYNOPSIS #include int islessequal( floating-expr x, floating-expr y); DESCRIPTION The islessequal() macro determines whether its first argument is less than or equal to its second argument. The value of islessequal( x ,y ) is always equal to (x ) <= (y ); however, unlike (x ) <= (y ), islessequal( x ,y ) does not raise the invalid exception when x and y are unordered.
islessgreater(3M) islessgreater(3M) NAME islessgreater( ) - floating-point quiet comparison macro (<>) SYNOPSIS #include int islessgreater(floating-expr x, floating-expr y); DESCRIPTION The islessgreater() macro determines whether its first argument is less than or greater than its second argument, without raising the invalid exception when x and y are unordered. The arguments must be of floating type. For HP Integrity servers, the arguments can be any floating type.
isnan(3M) isnan(3M) NAME isnan( ) - floating-point test for NaN SYNOPSIS #include int isnan( floating-type x); DESCRIPTION The isnan() macro determines whether its argument is a NaN. The argument must be of floating type. For HP Integrity servers, the argument can be any floating type. For PA-RISC, the argument must be either double or float . The isnan() macro implements the isnan() functionality recommended by the IEEE-754 standard for floating-point arithmetic.
isnormal(3M) isnormal(3M) NAME isnormal( ) - floating-point test for normalized value SYNOPSIS #include int isnormal( floating-type x); DESCRIPTION The isnormal() macro determines whether its argument is a normalized value (neither zero, denormalized, infinite, nor NaN). The argument must be of floating type, and classification is based on the type of the argument. For HP Integrity servers, the argument can be any floating type. For PA-RISC, the argument must be either double or float .
isunordered(3M) isunordered(3M) NAME isunordered( ) - floating-point comparison macro (unordered) SYNOPSIS #include int isunordered( floating-expr x, floating-expr y); DESCRIPTION The isunordered() macro determines whether its arguments are unordered. The arguments are unordered if at least one argument is a NaN. The arguments must be of floating type. For HP Integrity servers, the arguments can be any floating type. For PA-RISC, each argument must be either double or float .
j0(3M) j0(3M) NAME j0( ), j0f( ), j1( ), j1f( ), jn( ), jnf( ) - Bessel functions of the first kind SYNOPSIS #include double j0(double x); double j1(double x); double jn(int n, double x); HP Integrity Server Only float j0f(float x); float j1f(float x); float jnf(int n, float x); DESCRIPTION j0() and j1() return Bessel functions of x of the first kind of orders 0 and 1 respectively. jn() returns the Bessel function of x of the first kind of order n.
keyname(3X) keyname(3X) (ENHANCED CURSES) NAME keyname(), key_name() - get name of key SYNOPSIS #include char *keyname(int c ); char *key_name(wchar_t c ); DESCRIPTION The keyname() and key_name() functions generate a character string whose value describes the key c. The c argument of keyname() can be an 8-bit character or a key code. The c argument of key_name() must be a wide character.
keypad(3X) keypad(3X) (CURSES) NAME keypad — enable/disable abbreviation of function keys SYNOPSIS #include int keypad(WINDOW *win, bool bf); DESCRIPTION The keypad() function controls keypad translation. If bf is TRUE, keypad translation is turned on. If bf is FALSE, keypad translation is turned off. The initial state is FALSE. This function affects the behaviour of any function that provides keyboard input.
lckpwdf(3C) lckpwdf(3C) NAME lckpwdf(), ulckpwdf() - control access to the /etc/passwd and /etc/shadow files SYNOPSIS #include int lckpwdf (void) int ulckpwdf (void) DESCRIPTION The lckpwdf() and ulckpwdf() routines are used to coordinate modification access to the password file /etc/passwd and to the shadow password file /etc/shadow . The lock file used by these two routines is /etc/.pwd.lock. A process first calls lckpwdf() to gain exclusive access rights for modification.
ldcvt(3C) ldcvt(3C) NAME _ldecvt( ), _ldfcvt( ), _ldgcvt( ) - convert long-double floating-point number to string SYNOPSIS #include
ldcvt(3C) ldcvt(3C) International Code Set Support Single-byte character code sets are supported. AUTHOR _ldecvt() , _ldfcvt() , and _ldgcvt() were developed by HP. SEE ALSO setlocale(3C), printf(3S), lang(5), thread_safety(5).
ldexp(3M) ldexp(3M) NAME ldexp( ), ldexpf( ), ldexpl( ), ldexpw( ), ldexpq( ) - scale exponent of a floating-point number SYNOPSIS #include double ldexp(double x, int exp); HP Integrity Server Only float ldexpf(float x, int exp); long double ldexpl(long double y, int exp); extended ldexpw(extended x, int exp); quad ldexpq(quad x, int exp); DESCRIPTION The ldexp() function computes the quantity x * 2exp . ldexp() computes the same value as scalbn() .
ldexp(3M) ldexp(3M) STANDARDS CONFORMANCE ldexp() : SVID3, XPG4.
lgamma(3M) lgamma(3M) NAME lgamma( ), lgammaf( ), lgammal( ), lgammaw( ), lgammaq( ), lgamma_r( ), lgammaf_r( ), lgammal_r( ), lgammaw_r( ), lgammaq_r( ), gamma( ), gammaf( ), gammal( ), gammaw( ), gammaq( ), signgam - log gamma functions SYNOPSIS #include
lgamma(3M) lgamma(3M) lgammaq() , gammaq() , and lgammaq_r are equivalent to lgammal() , gammal() , and lgammal_r() respectively on HP-UX systems. USAGE To use these functions, compile either with the default -Ae option or with the -Aa and -D_HPUX_SOURCE options. To use (for Integrity servers) lgammaw() , lgammaw_r() , gammaw() , lgammaq() , lgammaq_r() , or gammaq() , compile also with the -fpwidetypes option. Make sure your program includes
libIO(3X) libIO(3X) NAME libIO: io_block_to_char_dsf(), io_block_to_raw(), io_char_to_block_dsf(), io_dev_to_node(), io_dev_to_options(), io_end(), io_error, io_get_devs(), io_get_legacy_mode(), io_get_mapping(), io_get_node_relation(), io_hw_compare(), io_hw_compare_ext(), io_hw_path_to_node(), io_hw_path_to_str(), io_init(), io_init_hw_path(), io_is_hwpath_legacy(), io_is_legacy_dev(), io_is_legacy_token(), io_is_option_set(), io_legacy_to_new_dev(), io_legacy_to_new_dsf(), io_legacy_to_new_hwpath(), io
libIO(3X) l libIO(3X) io_hw_compare_ext() Compares two hardware path structures used on HP-UX 11i V3 or later io_hw_path_to_node() io_hw_path_to_str() io_init() io_init_hw_path() io_is_hwpath_legacy() io_is_legacy_dev() io_is_legacy_token() io_is_option_set() io_legacy_to_new_dev() io_legacy_to_new_dsf() io_legacy_to_new_hwpath() Converts a hardware path to token io_mkdev() io_mkdev_ext() io_new_to_legacy_devs() io_new_to_legacy_dsfs() Builds a dev_t , given a node and option string io_new_to_legac
libIO(3X) libIO(3X) libIO FUNCTION Name io_init() , io_end() - establishes/terminates a connection with the dev_config driver Synopsis int io_init(int flag); void io_end(); Description The libIO library uses the dev_config driver to access information in the kernel I/O data structures. Opens the /dev/config dev_config driver. io_init() device special file, which causes an open(2) of the io_init() must be called before calling any other routine in the libIO library.
libIO(3X) libIO(3X) See the LIBIO_ERRORS section below for an explanation of each error value. The printed message has the form: str :libIO error message If str is NULL, the message has the form: libIO error message io_strerror() returns a pointer to the string containing the libIO error message which maps to the passed argument errnum.
libIO(3X) libIO(3X) Description io_hw_compare() compares contents of two leg_hw_path_t structures. If found equivalent, returns success; otherwise, returns an error. leg_hw_path_t is a pre-HP-UX 11i V3 structure used for storing hardware paths. Arguments path1, path2 Pointers to leg_hw_path_t structures. Return Value IO_SUCCESS - If found equivalent. IO_ERROR - Not equivalent. Errors None.
libIO(3X) libIO(3X) [IO_E_NODE_NOEXIST] [IO_E_PARM] [IO_E_SYSCALL] libIO FUNCTION Name io_hw_path_to_str() - converts a hardware path to a string Synopsis int io_hw_path_to_str(char *str,hw_path_t *hw_path); Description io_hw_path_to_str() converts the hardware path specified by hw_path to the string pointed to by str. str must have enough space (maximum hardware path length - MAX_HW_PATH_STR) to hold the converted string.
libIO(3X) libIO(3X) if (io_init(O_RDWR) == -1) exit(1); io_str_to_hw_path(str_path, &hw_path); io_end(); exit(0); Return Value IO_SUCCESS - Upon success. IO_ERROR - Otherwise. io_errno is set to indicate the error.
libIO(3X) libIO(3X) Return Value IO_SUCCESS - Upon success. IO_ERROR - Otherwise. io_errno is set to indicate the error. Errors [IO_E_DCONF_ACCESS] [IO_E_DCONF_OPEN] [IO_E_NODE_NOEXIST] [IO_E_PARM] [IO_E_SYSCALL] libIO FUNCTION Name io_node_to_hw_path() - converts token to a hardware path Synopsis int io_node_to_hw_path(io_token_t node,hw_path_t *hw_path); Description io_node_to_hw_path() fills hw_path with the hardware path of the given node. Arguments node hw_path Token corresponding to I/O node.
libIO(3X) libIO(3X) key String corresponding to query field. ptr Pointer to copy of queried data. Return Value Number of bytes copied - Upon success. IO_ERROR - Otherwise. io_errno is set to indicate the error. Errors [IO_E_DCONF_ACCESS] [IO_E_DCONF_OPEN] [IO_E_KEY_TOKEN_DEF] [IO_E_PARM] [IO_E_SYSCALL] libIO FUNCTION Name io_query_batch() - creates multiple keys to call io_query_array() Synopsis int io_query_batch(io_token_t token, int type, char *key1, void *dat1,char *key2, void *dat2, ...
libIO(3X) libIO(3X) Return Value IO_SUCCESS - Upon success. IO_ERROR - Otherwise. io_errno is set to indicate the error. Errors [IO_E_DCONF_OPEN] [IO_E_DCONF_ACCESS] [IO_E_PARM] [IO_E_SYSCALL] libIO FUNCTION Name io_search() , io_search_array() - searches I/O subsystem and system data structures Synopsis io_token_t io_search(io_token_t token, int type, int qual, char *key1, void *dat1, char *key2, void *dat2,...
libIO(3X) libIO(3X) Return Value token - Upon success. NULL - Otherwise. io_errno is set to indicate the error.
libIO(3X) libIO(3X) D_CHR Character dev_t . D_BLK Block dev_t . options Device specific options. dev The created dev_t is stored in memory pointed to by dev. Return Value IO_SUCCESS - Upon success. IO_ERROR - Otherwise. io_errno is set to indicate the error.
libIO(3X) libIO(3X) Arguments dev dev_t of the I/O node. dev_type Possible values are: D_CHR Character dev_t . D_BLK Block dev_t . Return Value IO_TOKEN_NEW - If dev_t is of an agile I/O node. IO_TOKEN_LEGACY - If dev_t is of a legacy I/O node. IO_ERROR - Failure. io_errno is set to indicate the error.
libIO(3X) libIO(3X) Errors [IO_E_DCONF_ACCESS] [IO_E_DCONF_OPEN] [IO_E_FUNC_NOT_SUPPORTED] libIO FUNCTION Name io_get_mapping() - returns a mapping between a given node and other I/O nodes Synopsis int io_get_mapping(io_token_t node, io_map_type_t map_type, int *count, io_token_t *token_arry); Description This API is called to retrieve the node or nodes mapped to a given node token. Given a legacy token with a map_type of IO_LEGACY_2_NEW, the routine will return an agile token mapped to it.
libIO(3X) libIO(3X) 2) Count will be set to the real count of io_token_t to be returned, 3) The API will return IO_ERROR , 4) io_errno will be set to IO_E_BUF_TOO_SMALL. In this case, the caller needs to allocate a bigger buffer after recalculating it using: (sizeof(io_token_t)*count) with the returned count value. and needs to call the API again with the new buffer and count values. Return Value IO_SUCCESS - Upon success. IO_ERROR - Otherwise. io_errno is set to indicate the error.
libIO(3X) • • • libIO(3X) IO_REL_CHILD IO_REL_PARENT IO_REL_SIBLING The node token of the relative is returned in the parameter relative. If either IO_REL_CHILD or IO_REL_SIBLING is specified, then the parameters addr and relative can be used to specify which child or sibling. If the parameter relative is NULL, then addr is used to identify a particular child or sibling.
libIO(3X) libIO(3X) Synopsis int io_new_to_legacy_hwpath (hw_path_t *from, leg_hw_path_t *to); Description io_new_to_legacy_hwpath() converts a hardware path used on HP-UX 11i V3 or later (hw_path_t ) data structure to the pre-HP-UX 11i V3 hardware path (leg_hw_path_t). If hw_path_t has more than 14 elements or any of them is more than 8 bit long, the API will set io_errno to IO_E_PARM . Arguments from to Pointer to hw_path_t data structure. A pointer to the legacy leg_hw_path_t data structure.
libIO(3X) libIO(3X) In this case, the caller needs to allocate a bigger buffer after recalculating it using: (sizeof(io_dev_info_t)*count) with the returned count value. and needs to call the API again with the new buffer and count values. Return Value IO_SUCCESS - Upon success. IO_ERROR - Otherwise. io_errno is set to indicate the error.
libIO(3X) libIO(3X) IO_ERROR - Otherwise. io_errno is set to indicate the error. Errors [IO_E_DCONF_OPEN] [IO_E_PARM] [IO_E_DCONF_ACCESS] [IO_E_SYSCALL] [IO_E_BUF_TOO_SMALL] libIO FUNCTION Name io_char_to_block_dsf() - map a char device special file to block device special file Synopsis int io_char_to_block_dsf(char *char_dsf, char *block_dsf); Description This API maps a given character device special file to its corresponding block device special file.
libIO(3X) libIO(3X) libIO FUNCTION Name io_legacy_to_new_dev() - maps a legacy dev_t to an agile dev_t Synopsis int io_legacy_to_new_dev(dev_t legacy_dev, int dev_type, dev_t *new_dev); Description Given a legacy dev_t and dev_type , this API retrieves its agile dev_t . Arguments legacy_dev Legacy dev_t to retrieve the agile dev_t . dev_type Possible values are: new_dev D_CHR Character dev_t . D_BLK Block dev_t . The agile dev_t is stored here. Return Value IO_SUCCESS - Upon success.
libIO(3X) libIO(3X) [IO_E_BUF_TOO_SMALL] libIO FUNCTION Name io_new_to_legacy_devs() - maps an agile dev_t to one or more legacy dev_t (s) Synopsis int io_new_to_legacy_devs(dev_t new_dev, int dev_type, dev_t *dev_arry, int *count); Description This API maps an agile dev_t to its legacy dev_t (s). There can be one to many mappings. Arguments new_dev dev_type A pointer to the agile dev_t to obtain its corresponding legacy dev_t s. Possible values are: D_CHR Character dev_t . D_BLK Block dev_t .
libIO(3X) libIO(3X) libIO FUNCTION Name io_new_to_legacy_dsfs() - maps a agile device special file to one or more legacy device special file Synopsis int io_new_to_legacy_dsfs(char *new_dsf, char *legacy_dsf,int *count); Description This API retrieves legacy device special file(s) corresponding to a persistent device special file. There can be one to many mappings. Arguments new_dsf legacy_arry A pointer to a persistent device special file to retrieve its legacy device special files.
libIO(3X) libIO(3X) Description This API initializes the hardware path structure hw_path_t according to the specified flags argument. IO_TREE_LEGACY should be passed as flags value when initializing a legacy hardware path. See intro(7). Zero can be passed as flags value for all other cases. Arguments hw_path flags Pointer to hardware path structure. The flags field of the hardware path. The valid flags are 0 and IO_TREE_LEGACY. Return Value IO_SUCCESS - Upon success. IO_ERROR - Otherwise. Errors None.
libIO(3X) libIO(3X) FILES /usr/include/sys/libIO.h /usr/lib/libIO.sl /usr/lib/pa20_64/libIO.sl /usr/lib/hpux32/libIO.so /usr/lib/hpux64/libIO.so libIO data structures and identifiers. libIO 32 bit for PA-RISC systems. libIO 64 bit for PA-RISC systems. libIO 32 bit for Itanium-based systems. libIO 64 bit for Itanium-based systems. SEE ALSO insf(1M), ioscan(1M), rmsf(1M), ioconfig(4), intro(7).
libkrb5(3) libkrb5(3) NAME libkrb5: libkrb5.sl, libkrb5.so, libcom_err, libcom_err.sl, libcom_err.so, libk5crypto, libk5crypto.sl, libk5crypto.so - Kerberos client libraries SYNOPSIS 32-Bit Libraries on Itanium -based Systems /usr/lib/hpux32/libkrb5.so /usr/lib/hpux32/libcom_err.so /usr/lib/hpux32/libk5crypto.so 64-Bit Libraries on Itanium-based Systems /usr/lib/hpux64/libkrb5.so /usr/lib/hpux64/libcom_err.so /usr/lib/hpux64/libk5crypto.so 32-Bit Libraries on PA-RISC Systems /usr/lib/libkrb5.
libkrb5(3) libkrb5(3) krb5_set_default_in_tkt_etypes(). The encryption types which are retrieved from the context and stored in the etypes should be freed by the caller. krb5_auth_context Management APIs The auth_context is a per-connection context and is used by the various APIs involved directly in client/server authentication. Some of the data stored in this context include keyblocks, addresses, sequence numbers, authenticator, checksum type and replay cache pointer.
libkrb5(3) libkrb5(3) Operating System-Specific APIs These APIs provide an interface between the other parts of the libkrb5 libraries and the operating system. These include APIs to allow access to configuration specific information, disk based I/O operations, network based operations and operating system specific access APIs.
libslp(3N) libslp(3N) NAME libslp: SLPOpen(), SLPClose(), SLPReg(), SLPDereg(), SLPDelAttrs(), SLPFindSrvs(), SLPFindSrvTypes(), SLPFindAttrs(), SLPParseSrvURL(), SLPEscape(), SLPUnescape(), SLPFree(), SLPGetRefreshInterval(), SLPFindScopes(), SLPGetProperty(), SLPSetProperty() - SLP (Service Location Protocol) library routines SYNOPSIS #include cc [ flag... ] file... -lslp [ library...
libslp(3N) libslp(3N) const char* attrids, SLPSrvURLCallback callback, void* cookie ); DESCRIPTION The SLP (Service Location Protocol) library routines provide a standard interface for writing application programs that are SLP enabled. The SLP API is an interface that allows programmers to write client and server applications to provide dynamic service discovery and selection. The C language binding presents a minimal overhead implementation that maps directly into the protocol.
libslp(3N) libslp(3N) operation is being evaluated by the callback function. The callback function is called whenever the API library has results to report. The callback code is required to check the error code parameter before looking at the other parameters. If the error code is not SLP_OK , the other parameters may be NULL or otherwise invalid. The API library can terminate any outstanding operation on which an error occurs.
libslp(3N) libslp(3N) The srvtype parameter is always ignored because the Service URL syntax required for the srvurl parameter encapsulates the service-type. Attributes list consists of comma separated attribute assignment expressions for the registered service. If no attributes are to be provided, use an empty string "" when registering services.
libslp(3N) libslp(3N) The SLPSrvURLCallback type is the type of the callback function parameter to SLPFindSrvs() function. If the hslp handle parameter was opened asynchronously, the results returned through the callback MAY be uncollated. The callback should return SLP_TRUE if more data is desired. The callback may continue to return SLP_TRUE until it is called with an errcode of SLP_LAST_CALL. If no more data is requested the callback should return SLP_FALSE .
libslp(3N) libslp(3N) This call is not implemented and always returns SLP_NOT_IMPLEMENTED. SLPError SLPFindScopes(SLPHandle hslp, char** scopelist) Sets the scopelist parameter to a pointer to a comma separated list of all available scope values. The most desirable values are always placed first in the list. There is always one value, "DEFAULT", in the list. The memory for the scopelist is dynamically allocated. The memory should be freed by a call to SLPFree() when no longer needed.
LINES(3X) LINES(3X) (ENHANCED CURSES) NAME LINES — number of lines on terminal screen SYNOPSIS #include extern int LINES; DESCRIPTION The external variable LINES indicates the number of lines on the terminal screen. SEE ALSO initscr(3X), . CHANGE HISTORY First released in X/Open Curses, Issue 4.
llrint(3M) llrint(3M) NAME llrint( ), llrintf( ), llrintl( ), llrintw( ), llrintq( ) - round to nearest long long functions SYNOPSIS #include long long llrint(double x); HP Integrity Server Only long long long long long long long long llrintf(float x); llrintl(long double x); llrintw(extended x); llrintq(quad x); DESCRIPTION llrint() rounds its argument to the nearest integral value, rounding according to the current rounding direction.
llround(3M) llround(3M) NAME llround( ), llroundf( ), llroundl( ), llroundw( ), llroundq( ) - round to long long functions SYNOPSIS #include long long llround(double x); HP Integrity Server Only long long long long long long long long llroundf(float x); llroundl(long double x); llroundw(extended x); llroundq(quad x); DESCRIPTION llround() rounds its argument to the nearest integral value.
localeconv(3C) localeconv(3C) NAME localeconv() - query the numeric formatting conventions of the current locale SYNOPSIS #include struct lconv *localeconv(void); DESCRIPTION The localeconv() function sets the components of an object of type struct lconv (defined in ) with values appropriate for the formatting of numeric quantities (monetary and otherwise) according to the rules of the program’s current locale (see setlocale(3C)).
localeconv(3C) localeconv(3C) char p_cs_precedes Set to 1 or 0 if the currency_symbol precedes or succeeds the value for a non-negative formatted monetary quantity. char p_sep_by_space Set to a value indicating the separation of the currency_symbol, the sign string, and the value of a non-negative formatted monetary quantity. char n_cs_precedes Set to 1 or 0 if the currency_symbol precedes or succeeds the value for a negative formatted monetary quantity.
localeconv(3C) localeconv(3C) For int_p_sep_by_space and int_n_sep_by_space, the fourth character of int_curr_symbol is used instead of a space for UNIX 2003 conforming applications. The values of p_sign_posn and n_sign_posn are interpreted according to the following: 0 Parentheses surround the quantity and currency_symbol or int_curr_symbol. 1 The sign string precedes the quantity and currency_symbol or int_curr_symbol. 2 The sign string succeeds the quantity and currency_symbol or int_curr_symbol.
localeconv(3C) localeconv(3C) AUTHOR localeconv() was developed by OSF and HP. SEE ALSO nl_langinfo(3C), setlocale(3C), localedef(4), langinfo(5), thread_safety(5).
log(3M) log(3M) NAME log( ), logf( ), logl( ), logw( ), logq( ) - natural logarithm functions SYNOPSIS #include double log(double x); float logf(float x); HP Integrity Server Only long double logl(long double x); extended logw(extended x); quad logq(quad x); DESCRIPTION log() returns the natural logarithm of x. logf() is a float version of log() ; it takes a float argument and returns a float result.
log(3M) log(3M) SEE ALSO clog(3M), exp(3M), log10(3M), log2(3M), log1p(3M), pow(3M), math(5). STANDARDS CONFORMANCE log() : SVID3, XPG4.
log10(3M) log10(3M) NAME log10( ), log10f( ), log10l( ), log10w( ), log10q( ) - common logarithm functions SYNOPSIS #include double log10(double x); float log10f(float x); HP Integrity Server Only long double log10l(long double x); extended log10w(extended x); quad log10q(quad x); DESCRIPTION log10() returns the logarithm base ten of x. log10f() is a float version of log10() ; it takes a float argument and returns a float result.
log10(3M) log10(3M) SEE ALSO exp(3M), exp10(3M), log(3M), log1p(3M), log2(3M), pow(3M), math(5). STANDARDS CONFORMANCE log10() : SVID3, XPG4.
log1p(3M) log1p(3M) NAME log1p( ), log1pf( ), log1pl( ), log1pw( ), log1pq( ) - natural logarithm of one-plus-argument functions SYNOPSIS #include double log1p(double x); HP Integrity Server Only float log1pf(float x); long double log1pl(long double x); extended log1pw(extended x); quad log1pq(quad x); DESCRIPTION The log1p() function computes the logarithmic function log(1 + x ), but may be more accurate for very small values of x.
log1p(3M) log1p(3M) SEE ALSO annuity(3M), compound(3M), expm1(3M), log(3M), math(5). STANDARDS CONFORMANCE log1p() : XPG4.
log2(3M) log2(3M) NAME log2( ), log2f( ), log2l( ), log2w( ), log2q( ) - logarithm base two functions SYNOPSIS #include double log2(double x); float log2f(float x); HP Integrity Server Only long double log2l(long double x); extended log2w(extended x); quad log2q(quad x); DESCRIPTION log2() returns the logarithm base two of x. log2f() is a float version of log2() ; it takes a float argument and returns a float result.
logb(3M) logb(3M) NAME logb( ), logbf( ), logbl( ), logbw( ), logbq( ) - radix-independent exponent functions SYNOPSIS #include double logb(double x); HP Integrity Server Only float logbf(float x); long double logbl(long double x); extended logbw(extended x); quad logbq(quad x); DESCRIPTION The logb() function computes the exponent of the floating point value x.
logb(3M) logb(3M) logbf() , logbl() : ISO/IEC C99 (including Annex F, ‘‘IEC 60559 floating-point arithmetic’’) l HP-UX 11i Version 3: February 2007 −2− Hewlett-Packard Company 767
logname(3C) logname(3C) NAME logname( ) - return login name of user SYNOPSIS #include char *logname(void); DESCRIPTION logname() returns a pointer to the null-terminated login name; it extracts the $LOGNAME variable from the user’s environment. WARNINGS logname() returns a pointer to static data that is overwritten by each subsequent call. This method of determining a login name is subject to forgery. FILES /etc/profile SEE ALSO env(1), login(1), profile(4), environ(5), thread_safety(5).
longname(3X) longname(3X) (CURSES) NAME longname — get verbose description of current terminal SYNOPSIS #include char *longname(void); DESCRIPTION The longname() function generates a verbose description of the current terminal. The maximum length of a verbose description is 128 bytes. It is defined only after the call to initscr() or newterm() . RETURN VALUE Upon successful completion, longname() returns a pointer to the description specified above.
lrint(3M) lrint(3M) NAME lrint( ), lrintf( ), lrintl( ), lrintw( ), lrintq( ) - round to nearest long int functions SYNOPSIS #include long int lrint(double x); HP Integrity Server Only long long long long int int int int lrintf(float x); lrintl(long double x); lrintw(extended x); lrintq(quad x); DESCRIPTION lrint() rounds its argument to the nearest integral value, rounding according to the current rounding direction.
lround(3M) lround(3M) NAME lround( ), lroundf( ), lroundl( ), lroundw( ), lroundq( ) - round to long int functions SYNOPSIS #include long int lround(double x); HP Integrity Server Only long long long long int int int int lroundf(float x); lroundl(long double x); lroundw(extended x); lroundq(quad x); DESCRIPTION lround() rounds its argument to the nearest integral value. An argument exactly halfway between two integers is rounded away from zero, regardless of the current rounding direction.
lsearch(3C) lsearch(3C) NAME lsearch( ), lfind( ) - linear search and update SYNOPSIS #include void *lsearch( const void *key, void *base, size_t *nelp, size_t width, int (*compar)(const void *, const void *) ); void *lfind( const void *key, const void *base, size_t *nelp, size_t width, int (*compar)(const void *, const void *) ); DESCRIPTION lsearch() l lfind() is a linear search routine generalized from Knuth (6.1) Algorithm S.
lsearch(3C) lsearch(3C) #include #define TABSIZE 50 #define ELSIZE 120 char line[ELSIZE], tab[TABSIZE][ELSIZE], *lsearch( ); size_t nel = 0; int strcmp( ); ... while (fgets(line, ELSIZE, stdin) != NULL && nel < TABSIZE) (void) lsearch(line, (char *)tab, &nel, ELSIZE, strcmp); ... RETURN VALUE If the searched-for datum is found, both lsearch() and lfind() return a pointer to it. Otherwise, lfind() returns NULL and lsearch() returns a pointer to the newly added element.
ltostr(3C) ltostr(3C) NAME ltostr(), ultostr(), ltoa(), ultoa() - convert long integers to strings SYNOPSIS #include
malloc(3C) malloc(3C) NAME malloc(), alloca(), calloc(), free(), mallinfo(), mallopt(), memorymap(), realloc(), valloc() - main memory allocator SYNOPSIS #include void *malloc(size_t size); void *calloc(size_t nelem, size_t elsize); void free(void *ptr); void *realloc(void *ptr, size_t size); void *valloc(size_t size); void memorymap(int show_stats); (Obsoleted) alloca() #include void *alloca(size_t size); System V Synopsis #include
malloc(3C) malloc(3C) free() Deallocates the space pointed to by ptr (a pointer to a block previously allocated by malloc() , realloc() , calloc() , or valloc() ) and makes the space available for further allocation. If ptr is a NULL pointer, no action occurs. mallopt() Provides for control over the allocation algorithm and other options in the malloc() package. The available values for cmd are: M_MXFAST Set maxfast to value.
malloc(3C) malloc(3C) only. A list of addresses and block descriptions is written (using printf() ) to standard output. If the value of the show_stats parameter is 1, statistics concerning number of blocks and sizes used will also be written. If the value is zero, only the memory map will be written. The addresses and sizes displayed by memorymap() may not correspond to those requested by an application.
malloc(3C) malloc(3C) $ export _M_ARENA_OPTS = 16:8 This means that the number of arenas is 16, and the expansion size is 8*4096 bytes. In general, the more arenas you use, the smaller the expansion factor should be, and vice versa. _M_SBA_OPTS is used to turn on the small block allocator, and to set up parameters for the small block allocator, namely, maxfast, grain, and numlblks. Applications with small block allocator turned on usually run faster than with it turned off.
malloc(3C) malloc(3C) the thread to borrow blocks from a global pool if available. This may be more efficient than going back to the arena. max_cache_misses is a hint to the caching algorithm indicating a particular number of cache misses after which it will search the global pool for appropriate sized blocks. The algorithm also releases unused cache blocks to the global pool. If max_cache_misses is 0 or not set, cache exchange is turned off.
malloc(3C) malloc(3C) STANDARDS CONFORMANCE malloc() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C calloc() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C free() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C mallinfo() : SVID2, XPG2 mallopt() : SVID2, SVID3, XPG2 realloc() : AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.
mbrlen(3C) mbrlen(3C) NAME mbrlen( ) - get number of bytes in a character (restartable) SYNOPSIS #include size_t mbrlen(const char *__restrict s, size_t n, mbstate_t *__restrict ps); DESCRIPTION If s is not a null pointer, mbrlen() determines the number of bytes constituting the character pointed to by s.
mbrtowc(3C) mbrtowc(3C) NAME mbrtowc( ) - convert a character to a wide-character code (restartable) SYNOPSIS #include size_t mbrtowc(wchar_t *__restrict pwc, const char *__restrict s, size_t n, mbstate_t *__restrict ps); DESCRIPTION If s is a null pointer, the mbrtowc() function is equivalent to the call: mbrtowc(NULL, "", 1, ps) In this case, the values of the arguments pwc and n are ignored.
mbrtowc(3C) mbrtowc(3C) the future. It is recommended that wide character constants and wide string literals (see the C Reference Manual) not be used, and that wide character code values not be stored in files or devices because future standards may dictate changes in the code value assignments of the wide characters.
mbsinit(3C) mbsinit(3C) NAME mbsinit() - determine conversion object status SYNOPSIS #include int mbsinit(const mbstate_t *ps); DESCRIPTION If ps is not a null pointer, the mbsinit() function determines whether the object pointed to by ps describes an initial conversion state.
mbsrtowcs(3C) mbsrtowcs(3C) NAME mbsrtowcs( ) - convert a character string to a wide-character string (restartable) SYNOPSIS #include size_t mbsrtowcs(wchar_t *__restrict dst, const char **__restrict src, size_t len, mbstate_t *__restrict ps); DESCRIPTION The mbsrtowcs() function converts a sequence of characters, beginning in the conversion state described by the object pointed to by ps, from the array indirectly pointed to by src into a sequence of corresponding wide-characters.
mbsrtowcs(3C) mbsrtowcs(3C) AUTHOR mbsrtowcs() was developed by HP and Mitsubishi Electric Corporation. SEE ALSO mbrtowc(3C), mbsinit(3C), glossary(9).
memalign(3C) memalign(3C) NAME memalign() - allocate aligned memory SYNOPSIS #include void *memalign(size_t boundary, size_t size); DESCRIPTION memalign() allocates space for a block of size bytes, whose address is a multiple of boundary. The space is not initialized. The boundary must be a power of 2. EXTERNAL INFLUENCES memalign() employs the malloc() allocator. For tuning information, see the malloc(3C) man page.
memory(3C) memory(3C) NAME memory: memccpy(), memchr(), memcmp(), memcpy(), memmove(), memset(), bcmp(), bcopy(), bzero(), ffs() - memory operations SYNOPSIS #include
memory(3C) memory(3C) memset() Copy the value of c (converted to an unsigned char ) into each of the first n bytes of the object pointed to by s. memset() returns the value of s. bcopy() bcmp() copies n bytes from the area pointed to by s1 to the area pointed to by s2. bzero() ffs() Clear n bytes in the area pointed to by s by setting them to zero. Compare the first n bytes of the area pointed to by s1 with the area pointed to by s2. bcmp() returns zero if they are identical; non-zero otherwise.
meta(3X) meta(3X) (ENHANCED CURSES) NAME meta — enable/disable meta-keys SYNOPSIS #include int meta(WINDOW *win, bool bf); DESCRIPTION Initially, whether the terminal returns 7 or 8 significant bits on input depends on the control mode of the display driver (see the X/Open System Interface Definitions, Issue 4, Version 2 specification, General Terminal Interface). To force 8 bits to be returned, invoke meta(win, TRUE). To force 7 bits to be returned, invoke meta(win, FALSE).
mkdirp(3G) mkdirp(3G) NAME mkdirp(), rmdirp() - create, remove directories in a path SYNOPSIS #include int mkdirp (const char *path , mode_t mode ); int rmdirp (char *d , char *d1); DESCRIPTION mkdirp creates all the missing directories in the given path with the given mode (see chmod(2) for the values of mode.) The protection part of the mode argument is modified by the process’s file creation mask (see umask(2)). rmdirp removes directories in path d.
mkfifo(3C) mkfifo(3C) NAME mkfifo() - make a FIFO file SYNOPSIS #include int mkfifo(char *path, mode_t mode); DESCRIPTION mkfifo() creates a new FIFO (first-in-first-out) file, at the path name to which path points. The file permission bits of the new file are initialized from the mode argument, as modified by the process’s file creation mask: for each bit set in the process’s file mode creation mask, the corresponding bit in the new file’s mode is cleared (see umask(2)).
mkfifo(3C) mkfifo(3C) STANDARDS CONFORMANCE mkfifo() : AES, SVID3, XPG3, XPG4, FIPS 151-2, POSIX.
mktemp(3C) mktemp(3C) NAME mktemp(), mkstemp() - make a unique file name SYNOPSIS #include char *mktemp(char *template); int mkstemp(char *template); Remarks These functions are provided solely for backward compatibility and importability of applications, and are not recommended for new applications where portability is important. For portable applications, use tmpfile() instead (see tmpfile(3S)).
mktimer(3C) mktimer(3C) NAME mktimer - allocate a per-process timer SYNOPSIS #include timer_t mktimer(int clock_type, int notify_type, void *itimercbp); DESCRIPTION The mktimer() function is used to allocate a per-process timer using the specified system-wide clock as the timing base. mktimer() returns an unique timer ID of type timer_t used to identify the timer in timer requests (see gettimer (3C)).
modf(3M) modf(3M) NAME modf( ), modff( ), modfl( ), modfw( ), modfq( ) - decompose floating-point number SYNOPSIS #include double modf(double x, double *iptr); HP Integrity Server Only float modff(float x, float *iptr); long double modfl(long double x, long double *iptr); extended modfw(extended x, extended *iptr); quad modfq(quad x, quad *iptr); DESCRIPTION The modf() function breaks the argument x into integral and fractional parts, each of which has the same sign as the argument.
monitor(3C) monitor(3C) NAME monitor( ) - prepare execution profile SYNOPSIS #include void monitor( void (*lowpc)(), void (*highpc)(), WORD *buffer, int bufsize, int nfunc ); DESCRIPTION An executable program created by cc -p automatically includes calls for monitor() with default parameters; monitor() need not be called explicitly except to gain fine control over profiling. monitor() is an interface to profil(2).
mount(3N) mount(3N) NAME mount - keep track of remotely mounted file systems SYNOPSIS #include
mount(3N) mount(3N) char *ml_path; struct mountlist *ml_nxt; }; struct fhstatus { int fhs_status; fhandle_t fhs_fh; }; /* * List of exported directories * An export entry with ex_groups * NULL indicates an entry which is exported to the world.
move(3X) move(3X) (CURSES) NAME move, wmove — window cursor location functions SYNOPSIS #include int move(int y, int x); int wmove(WINDOW *win, int y, int x); DESCRIPTION The move() and wmove() functions move the cursor associated with the current or specified window to (y, x) relative to the window’s origin. This function does not move the terminal’s cursor until the next refresh operation. RETURN VALUE Upon successful completion, these functions return OK. Otherwise, they return ERR.
multibyte(3C) multibyte(3C) NAME mblen( ), mbtowc( ), mbstowcs( ), wctomb( ), wcstombs( ) - multibyte characters and strings conversions SYNOPSIS #include
multibyte(3C) multibyte(3C) corresponding codes and store these codes into the array pointed to by pwcs, stopping after either n codes or a code with value zero (a converted null character) is stored. Each multibyte character is converted as if by a call to mbtowc() . No more than n elements are modified in the array pointed to by pwcs. If an invalid multibyte character is encountered, mbstowcs() returns (size_t) − 1.
mvcur(3X) mvcur(3X) (ENHANCED CURSES) NAME mvcur — output cursor movement commands to the terminal SYNOPSIS #include int mvcur(int oldrow, int oldcol, int newrow, int newcol); DESCRIPTION The mvcur() function outputs one or more commands to the terminal that move the terminal’s cursor to (newrow, newcol), an absolute position on the terminal screen. The (oldrow, oldcol) arguments specify the former cursor position.
mvderwin(3X) mvderwin(3X) (ENHANCED CURSES) NAME mvderwin — define window coordinate transformation SYNOPSIS #include int mvderwin(WINDOW *win, int par_y, int par_x); DESCRIPTION The mvderwin() function specifies a mapping of characters. The function identifies a mapped area of the parent of the specified window, whose size is the same as the size of the specified window and whose origin is at (par_y, par_x) of the parent window.
mvprintw(3X) mvprintw(3X) (CURSES) NAME mvprintw, mvwprintw, printw, wprintw — print formatted output in window SYNOPSIS #include int mvprintw(int y, int x, char *fmt, ...); int mvwprintw(WINDOW *win, int y, int x, char *fmt, ...); int printw(char *fmt, ...); int wprintw(WINDOW *win, char *fmt, ...); DESCRIPTION The mvprintw() , mvwprintw() , printw() and wprintw() functions are analogous to printf() .
mvscanw(3X) mvscanw(3X) (CURSES) NAME mvscanw, mvwscanw, scanw, wscanw — convert formatted input from a window SYNOPSIS #include int mvscanw(int y, int x, char *fmt, ...); int mvwscanw(WINDOW *win, int y, int x, char *fmt, ...); int scanw(char *fmt, ...); int wscanw(WINDOW *win, char *fmt, ...); DESCRIPTION These functions are similar to scanf() .
mvwin(3X) mvwin(3X) (CURSES) NAME mvwin — move window SYNOPSIS #include int mvwin(WINDOW *win, int y, int x); DESCRIPTION The mvwin() function moves the specified window so that its origin is at position (y, x). If the move would cause any portion of the window to extend past any edge of the screen, the function fails and the window is not moved. RETURN VALUE Upon successful completion, mvwin() returns OK. Otherwise, it returns ERR. ERRORS No errors are defined.
(Notes) (Notes) m 808 Hewlett-Packard Company −1− HP-UX 11i Version 3: February 2007
