Open System Services System Calls Reference Manual Abstract This manual documents part of the HP NonStop Open System Services (OSS) application program interface. It is written for system and application programmers. Product Version N.A. Supported Release Version Updates (RVUs) This manual supports G06.28 and all subsequent G-series RVUs and H06.04 and all subsequent H-series RVUs until otherwise indicated by its replacement publication.
Document History Part Number Product Version Published 527186-003 527186-004 527186-005 527186-006 527186-007 N/A N/A N/A N/A N/A July 2005 September 2005 February 2006 February 2006 July 2006
Contents _____________________________ What Is New in This Manual . . . . . . . . . . . . . . . . . . . . ix . . . . . . . . . . . . . . . . . . . ix Changed Functions . . . . . . . . . . . . . . . . . . . x . . . . . . . . . . . . . . . . xii Changed Miscellaneous Topics . . . . . . . . . . . . . . . xii New Functions . New Miscellaneous Topics About This Manual . . . . . . . . . . . . . . . .
OSS System Calls Reference Manual execvp _exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-43 2-51 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents kill . . lchmod . lchown . lgamma_r link . . listen . . localtime_r lseek . . lseek64 . lstat . . lstat64 . mkdir . . mknod . msgctl . msgget . msgrcv . msgsnd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Section 5. System Functions (n - p) . nice . . . . . . . open . . . . . . . open64 . . . . . . pipe . . . . . . . pthread_atfork . . . . pthread_attr_destroy . .
OSS System Calls Reference Manual pthread_exit . . . . . . pthread_get_expiration_np . pthread_getattr_np . . . . pthread_getconcurrency . . pthread_getschedparam . . pthread_getspecific . . . . pthread_join . . . . . . pthread_key_create . . . . pthread_key_delete . . . . pthread_kill . . . . . . pthread_lock_global_np . . pthread_mutex_destroy . . pthread_mutex_init . . . . pthread_mutex_lock . . . pthread_mutex_trylock . . pthread_mutex_unlock . . . pthread_mutexattr_destroy .
Contents setgid . . . . . . . setpgid . . . . . . setpgrp . . . . . . setregid . . . . . . setreuid . . . . . . setsid . . . . . . . setsockopt . . . . . setuid . . . . . . . shmat . . . . . . . shmctl . . . . . . shmdt . . . . . . . shmget . . . . . . shutdown . . . . . . sigaction . . . . . . sigpending . . . . . sigprocmask . . . . . sigsuspend . . . . . sockatmark . . . . . socket . . . . . . . socketpair . . . . . socket_transport_name_get socket_transport_name_set spt_accept . . . . . spt_acceptx . .
OSS System Calls Reference Manual spt_fputs . . . . . . . . spt_fputsx . . . . . . . spt_fputwc . . . . . . . spt_fputwcx . . . . . . . spt_fread . . . . . . . . spt_freadx . . . . . . . spt_fwrite . . . . . . . spt_fwritex . . . . . . . spt_generateTag . . . . . . spt_getc . . . . . . . . spt_getchar . . . . . . . spt_getcharx . . . . . . . spt_getcx . . . . . . . . spt_gets . . . . . . . . spt_getsx . . . . . . . . spt_getTMFConcurrentTransactions spt_getw . . . . . . . . spt_getwc . . . . . . .
Contents spt_recvmsg . . . . . . . spt_recvmsgx . . . . . . spt_recvx . . . . . . . . spt_regFile . . . . . . . spt_regFileIOHandler . . . . spt_regOSSFileIOHandler . . spt_regPathsendFile . . . . spt_regPathsendTagHandler . . spt_regTimerHandler . . . . spt_REPLYX . . . . . . spt_select . . . . . . . spt_select_single_np . . . . spt_send . . . . . . . . spt_sendmsg . . . . . . . spt_sendmsgx . . . . . . spt_sendto . . . . . . . spt_sendtox . . . . . . . spt_sendx . . . . . . . SPT_SETMODE . . . . .
OSS System Calls Reference Manual statvfs64 . . . . . . . . . . . strtok_r . . . . . . . . . . . symlink . . . . . . . . . . . SPT_ABORTTRANSACTION . . . . SPT_BEGINTRANSACTION . . . . SPT_ENDTRANSACTION . . . . . SPT_RESUMETRANSACTION . . . . SPT_SERVERCLASS_DIALOG_ABORT_ SPT_SERVERCLASS_DIALOG_BEGIN_ SPT_SERVERCLASS_DIALOG_END_ . SPT_SERVERCLASS_DIALOG_SEND_ . SPT_SERVERCLASS_SEND_ . . . . SPT_SERVERCLASS_SEND_INFO_ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents environ . . . . . errno . . . . . . filename . . . . . hier . . . . . . pathname . . . . . process_extension_results resolv.conf . . . . Permuted Index Index . 527186-007 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-15 12-32 12-40 12-47 12-49 12-50 12-59 . . . . . . . . .
OSS System Calls Reference Manual LIST OF TABLES Table 3−1. Ignored File Status Flags . . . . . . . . . . . . . . . . 3-11 Table 7−1. Ignored File Status Flags (spt_fcntlx Function) . . . . . . . . . . . 7-116 Table 7−2. Levels of Guardian File Security . . . . . . . . . . . . . . . 7-146 Table 7−3. Allowed Guardian File Accesses . . . . . . . . . . . . . . . 7-146 Table 11−1. cpio Archive File Header Format . . . . . . . . . . . .
What Is New in This Manual This section describes changes made to the Open System Services System Calls Reference Manual since February 2006 (527186-006). This manual contains information about some of the following G-series development tools. For servers running H-series RVUs, these tools are supported only in H06.
OSS System Calls Reference Manual acl(5) These reference pages describe features added in G06.29 and later G-series RVUs and H06.06 and later H-series RVUs to support OSS files larger than approximately 2 gigabytes: creat64(2) fstat64(2) fstatvfs64(2) ftruncate64(2) lseek64(2) lstat64(2) open64(2) stat64(2) statvfs64(2) These reference pages describe features added in G06.29 and later G-series RVUs and H06.
What Is New in This Manual lstat64(2) mkdir(2) mknod(2) open(2) open64(2) stat(2) stat64(2) These reference pages are revised to support features related to OSS files larger than approximately 2 gigabytes: creat(2) fcntl(2) fstat(2) fstatvfs(2) ftruncate(2) lseek(2) lstat(2) open(2) read(2) readv(2) stat(2) statvfs(2) write(2) writev(2) These reference pages are revised to support features related to support for signal handling for POSIX threads: pthread_kill(2) sigaction(2) sigpending(2) sigsuspend(2) Thes
OSS System Calls Reference Manual stat64(2) unlink(2) utime(2) New Miscellaneous Topics The acl(5) reference page provides an introduction to OSS ACLs and provides examples of ACL usage. Changed Miscellaneous Topics The errno(5) reference page now includes the error [EOVERFLOW].
About This Manual The HP NonStop Open System Services (OSS) application program interface (API) provides an open interface for programs to be run with the underlying HP NonStop operating system. The Open System Services System Calls Reference Manual contains reference pages for OSS system functions, files, and miscellaneous topics.
OSS System Calls Reference Manual Audience This manual is for system and application programmers who want to use the OSS API provided with the NonStop operating system. The manual assumes that the reader is a programmer and is familiar with the C programming language. Purpose This manual provides a complete reference to all OSS system functions and their related files and miscellaneous topics. Document Usage This manual contains a portion of the online reference (man) pages.
About This Manual SYNOPSIS Appropriate syntax, including header files to be included and all parameter types. Some header files are required for POSIX.1-compliant applications but are optional for applications conforming to other standards. These header files are noted as "optional except for POSIX.1." PARAMETERS Descriptions of the parameters listed under the SYNOPSIS heading.
OSS System Calls Reference Manual • eld Manual (TNS/E systems only) • enoft Manual (TNS/E systems only) • H-Series Application Migration Guide • Inspect Manual • ld Manual • Native Inspect Manual (TNS/E systems only) • rld Manual • nld Manual • noft Manual • Open System Services Library Calls Reference Manual • Open System Services Porting Guide • Open System Services Programmer’s Guide • Open System Services Shell and Utilities Reference Manual • Open System Services User’s Guide
About This Manual Section Content Manual ___________________________________________________________________ (1) User commands OSS Shell and Utilities Reference Manual (2) System functions OSS System Calls Reference Manual (3) Library functions OSS Library Calls Reference Manual OSS System Calls Reference Manual (SPT_*( ) functions) (4) File formats and data structures OSS System Calls Reference Manual OSS Library Calls Reference Manual OSS Shell and Utilities Reference Manual (5) Miscellaneous
Section 1. System Functions (a - d) This section contains reference pages for Open System Services (OSS) system function calls with names that begin with a through d. These reference pages reside in the cat2 directory and are sorted alphabetically by U.S. English conventions in this section.
accept(2) OSS System Calls Reference Manual NAME accept - Accepts a new connection on a socket LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include
System Functions (a - d) accept(2) NOTES When a connection is available, a call to the select( ) function indicates that the file descriptor for the original socket is ready for reading. The accepted socket cannot itself accept more connections. The original socket remains open and can accept more connections. RETURN VALUES Upon successful completion, the accept( ) function returns the file descriptor of the accepted socket.
accept(2) OSS System Calls Reference Manual RELATED INFORMATION Functions: bind(2), connect(2), listen(2), socket(2). STANDARDS CONFORMANCE The XPG4 specification allows certain behaviors to be implementer-defined. The following are choices of the HP implementation: • The HP implementation does not return the errno values [EAGAIN], [ENOSR], or [EPROTO].
System Functions (a - d) access(2) NAME access - Determines the accessibility of a file LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int access( const char *path, int access_mode); PARAMETERS path Points to the file pathname. When the path parameter refers to a symbolic link, the access( ) function returns information about the file pointed to by the symbolic link.
access(2) OSS System Calls Reference Manual Files in the Guardian File System If the specified pathname resolves to the /G directory itself, the calling process has read and execute access but not write access. The permissions are "r-xr-xr-x". If the specified pathname resolves to a Guardian process name, the calling process has execute access but not read or write access. The permissions are "--x--x--x".
System Functions (a - d) access(2) [ENAMETOOLONG] One of the following is too long: • The pathname pointed to by the path parameter • A component of the pathname pointed to by the path parameter • The intermediate result of pathname resolution when a symbolic link is part of the path parameter The pathconf( ) function can be called to obtain the applicable limits. [ENOENT] [ENOROOT] One of the following conditions exists: • The specified pathname does not exist.
access(2) OSS System Calls Reference Manual STANDARDS CONFORMANCE The POSIX standards leave some features to the implementing vendor to define. The following features are affected in the HP implementation: • To override the file access control mechanism, a process must have a user ID of the super ID. • The error [EINVAL] can be detected.
System Functions (a - d) acl(2) NAME acl - Sets access control list (ACL) information for a file LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library SYNOPSIS #include #include int acl( char *pathp, int cmd, int nentries, struct acl *aclbufp); PARAMETERS pathp Points to the pathname of the file. nentries Specifies the number of ACL entries pointed to by the aclbup parameter.
acl(2) OSS System Calls Reference Manual cmd Specifies the action to be taken by the acl( ) function. The cmd parameter can be one of these values: ACL_SET The acl( ) function stores the entries specified by the nentries and aclbufp parameters in the ACL for the file. The new ACL replaces any existing ACL for the file.
System Functions (a - d) acl(2) ERRORS If any of these conditions occurs, the acl( ) function sets errno to the corresponding value: [EACCES] The caller does not have access to a component of the pathname. [EINVAL] One of these conditions occurred: • The value of the cmd parameter is not ACL_GET, ACL_SET, or ACL_CNT. • The value of the cmd parameter is ACL_SET, and the value of the nentries parameter is less than the number of mandatory ACL entries.
acl(2) OSS System Calls Reference Manual RELATED INFORMATION Commands: getacl(1), setacl(1). Functions: aclsort(3), creat(2), creat64(2), open(2), open64(2). Miscellaneous: acl(5). STANDARDS CONFORMANCE This function is an HP extension to the XPG4 Version 2 specification.
System Functions (a - d) asctime_r(2) NAME asctime_r - Converts broken-down time into a date and time string (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptdll H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include char *asctime_r ( const struct tm *timeptr, char *buf ); PARAMETERS timeptr Points to a type tm structure that contains the broken-down time. buf Points to the buffer where the converted time is stored.
bind(2) OSS System Calls Reference Manual NAME bind - Binds a name to a socket LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int bind( int socket, const struct sockaddr *address, size_t address_len ); PARAMETERS socket Specifies the file descriptor of the socket to be bound. address Points to a sockaddr structure that contains the address to be bound to the socket.
System Functions (a - d) bind(2) • The socket is an AF_UNIX socket and either a component of the path prefix denies search permission, or the requested name requires writing in a directory with a mode that denies write permission. [EADDRINUSE] The specified address is already in use. [EADDRNOTAVAIL] The specified address is not available on this HP NonStop node. [EAFNOSUPPORT] The specified address is not a valid address for the address family of the specified socket.
bind(2) OSS System Calls Reference Manual [ENOENT] The socket is in the AF_UNIX domain and one of the following conditions exists: • A component of the pathname specified in the sockaddr structure does not name an existing file. • The sockaddr structure specifies an empty string as a pathname. [ENOBUFS] There was not enough buffer space available to complete the call. A retry at a later time might succeed. [ENOMEM] Required memory resources were not available.
System Functions (a - d) chdir(2) NAME chdir - Changes the current working directory LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include int chdir( const char *path); PARAMETERS path Points to the pathname of the directory.
chdir(2) OSS System Calls Reference Manual NOTES A process running with an effective user ID or group affiliation that qualifies for membership in the Safeguard SECURITY-OSS-ADMINISTRATOR group has read and search permissions for any OSS directory. RETURN VALUES Upon successful completion, the chdir( ) function returns the value 0 (zero). Otherwise, the value -1 is returned, and errno is set to indicate the error.
System Functions (a - d) chdir(2) [ENOTDIR] A component of the pathname is not a directory. [ENXIO] The fileset containing the client’s current working directory or root directory is not mounted. [EOSSNOTRUNNING] The program attempted an operation on an object in the OSS environment while a required system process was not running. [EPERM] The program attempted an operation on a Guardian process or attempted to access a Guardian ZYQ subvolume.
chmod(2) OSS System Calls Reference Manual NAME chmod - Changes file-access permissions LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ int chmod( const char *path, mode_t mode); PARAMETERS path Specifies the full pathname of the file.
System Functions (a - d) chmod(2) S_IRWXU Permits the file’s owner to read, write, and execute the file (or to search the directory). S_IRUSR Permits the file’s owner to read the file. S_IWUSR Permits the file’s owner to write to the file. S_IXUSR Permits the file’s owner to execute the file (or to search the directory). S_IRWXG Permits the file’s group to read, write, and execute the file (or to search the directory). S_IRGRP Permits the file’s group to read the file.
chmod(2) OSS System Calls Reference Manual optional (nondefault) ACL entries with nonzero permissions also have the comment # effective:---. | | To set the permission bits of ACL entries, use the acl( ) function instead of the chmod( ) function. | ACLs are not supported for symbolic links. Use on Guardian Objects Attempting to set the access permissions on a Guardian file (that is, a file in the /G file system) fails with errno set to [EINVAL].
System Functions (a - d) chmod(2) • The intermediate result of pathname resolution when a symbolic link is part of the path parameter The pathconf( ) function can be called to obtain the applicable limits. [ENOENT] [ENOROOT] One of these conditions exists: • The named file does not exist, or the specified name is an empty string. • The path parameter specifies a file on a remote HP NonStop node, but communication with the remote node has been lost.
chmod(2) OSS System Calls Reference Manual HP extensions to the XPG4 Version 2 specification are: 1−24 • To change the file access permissions of a file or directory, the effective user ID of the process must match the super ID or the owner of the file, or the effective user ID or one of the group affiliations for the process must qualify the process for membership in the Safeguard SECURITY-OSS-ADMINISTRATOR group.
System Functions (a - d) chown(2) NAME chown - Changes the owner and group IDs of a file LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.
chown(2) OSS System Calls Reference Manual Access Control Lists (ACLs) A user can allow or deny specific individuals and groups access to a file by using an ACL on the file. When using the chown( ) function with ACLs, if the new owner and/or group of a file have optional ACL entries corresponding to user:uid:perm or group:gid:perm in the ACL for a file, those entries remain in the ACL but no longer have any effect because they are superseded by the user::perm or group::perm entries in the ACL.
System Functions (a - d) [EINVAL] chown(2) The owner or group parameter is out of range. An attempt was made to change ownership of a Guardian file that is not a disk file. [EIO] An input or output error occurred. The device holding the file might be in the down state, or both processors that provide access to the device might have failed. [ELOOP] Too many links were encountered in translating the path parameter.
chown(2) OSS System Calls Reference Manual [EPERM] The calling process does not have appropriate privileges. [EROFS] The named file resides on a read-only fileset. For all other error conditions, errno is set to the appropriate Guardian file-system error number. See the Guardian Procedure Errors and Messages Manual for more information about a specific Guardian file-system error. RELATED INFORMATION Commands: chgrp(1), chown(1), getacl(1), setacl(1).
System Functions (a - d) chroot(2) NAME chroot - Changes the effective root directory LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include int chroot( const char *path); PARAMETERS path Specifies the new effective root directory.
chroot(2) OSS System Calls Reference Manual Use From the Guardian Environment The chroot( ) function is one of a set of functions that have the following effects when the first of them is called from the Guardian environment: • Two Guardian file-system file numbers (not necessarily the next two available) are allocated for the root directory and the current working directory. These file numbers cannot be closed by calling the Guardian FILE_CLOSE_ procedure.
System Functions (a - d) [ENOENT] chroot(2) One of the following conditions exists: • The named directory does not exist. • The specified pathname is an empty string. • The specified pathname cannot be mapped to a valid Guardian filename. [ENOROOT] The root fileset (fileset 0) is not in the STARTED state. [ENOTDIR] A component of the specified pathname is not a directory. [ENXIO] The fileset containing the client’s working directory or effective root directory is not mounted.
close(2) OSS System Calls Reference Manual NAME close - Closes a file descriptor LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int close( int filedes); PARAMETERS filedes Specifies an open file descriptor obtained from a successful call to the accept( ), creat( ), dup( ), dup2( ), fcntl( ), open( ), pipe( ), socket( ), or socketpair( ) function.
System Functions (a - d) close(2) RELATED INFORMATION Functions: exec(2), fcntl(2), getsockopt(2), open(2), pipe(2), setsockopt(2), socket(2), tdm_execve(2), tdm_execvep(2). Files: signal(4). STANDARDS CONFORMANCE This function does not return the errno value [EINTR]. For an AF_INET or AF_INET6 socket, even if all these are true: • The socket is connection-oriented. • The SO_LINGER option is enabled for the socket. • The socket has untransmitted data. the close( ) function does not block.
connect(2) OSS System Calls Reference Manual NAME connect - Connects a socket LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int connect( int socket, const struct sockaddr *address, size_t address_len ); PARAMETERS socket Specifies the file descriptor for the socket. address Points to a sockaddr structure that contains the address of the peer socket.
System Functions (a - d) connect(2) If timeout occurs, the connect( ) call fails and errno is set to [ETIMEDOUT]; the connection is aborted. If a connect( ) call is interrupted by a signal that is caught while the call is blocked waiting to establish a connection, the connect( ) call fails and sets errno to [EINTR]; the connection is not aborted and is later established asynchronously.
connect(2) [EFAULT] OSS System Calls Reference Manual A user-supplied memory buffer cannot be accessed. [EHOSTUNREACH] The destination host cannot be reached. [EINPROGRESS] The socket is marked nonblocking (O_NONBLOCK is set) and the requested connection is not yet completed. The connection will be completed asynchronously. [EINTR] The attempt to connect was interrupted by delivery of a signal. The connection will be completed asynchronously.
System Functions (a - d) connect(2) • The sockaddr structure specifies an empty string as a pathname. [ENOMEM] Required memory resources were not available. A retry at a later time might succeed. [ENOTDIR] The socket is in the AF_UNIX domain and a component of the pathname specified in the sockaddr structure is not a directory. [ENOTSOCK] The socket parameter does not refer to a socket.
creat(2) OSS System Calls Reference Manual NAME creat - Creates a regular file in the OSS environment or rewrites an existing file LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include #include #include /* optional except for POSIX.1 */ /* optional except for POSIX.
System Functions (a - d) creat(2) The returned file descriptor is the lowest-numbered file descriptor not currently open for that process. A corresponding Guardian environment file number is also assigned. The file offset, marking the current position within the file, is set to the beginning of the file. The new file descriptor is set to remain open across the processing of any of the exec or tdm_exec set of functions. (See the fcntl(2) reference page.
creat(2) OSS System Calls Reference Manual File Type Flags The file type flags that can be logically ORed into the value specified in the mode parameter are: S_IFREG Regular file in the OSS file system or in /G, the Guardian file system. S_ISVTX Sticky bit; used only for directories (cannot be used for files in /G, the Guardian file system). Access Control Lists (ACLs) The creat( ) function does not change the ACL for an existing file.
System Functions (a - d) creat(2) • If the file is an EDIT file and write access is specified, the call fails, and errno is set to the value [EINVAL]. • The maximum number of opens is reported by the sysconf( ) function as the upper limit of opens per process. The actual limit depends on other factors, such as the size of the process file segment (PFS) and the number of existing opens on directories or on files in the Guardian environment.
creat(2) OSS System Calls Reference Manual [EFAULT] The path parameter is an invalid address. [EFILEBAD] One of these conditions exists: [EFSBAD] • The function attempted to open a Guardian EDIT file, but the structure of the file is bad. • The function attempted to open a Guardian EDIT file, but the corrupted flag is set in the file label. The fileset catalog for one of the filesets involved in the operation is corrupt.
System Functions (a - d) creat(2) [ENAMETOOLONG] One of these is too long: • The pathname pointed to by the path parameter • A component of the pathname pointed to by the path parameter • The intermediate result of pathname resolution when a symbolic link is part of the path parameter The pathconf( ) function can be called to obtain the applicable limits. [ENOENT] One of these conditions exists: • The pathname prefix does not exist. • The path parameter points to an empty string.
creat(2) OSS System Calls Reference Manual • The call attempted to create a file in the /E directory. [EROFS] The named file resides on a read-only fileset, and write access is required. [ETXTBSY] The file is being executed. For all other error conditions, errno is set to the appropriate Guardian file-system error number. For more information about a specific Guardian file-system error, see the Guardian Procedure Errors and Messages Manual. RELATED INFORMATION Commands: getacl(1), setacl(1).
System Functions (a - d) creat64(2) NAME creat64 - Creates a regular file in the OSS environment or rewrites an existing file LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include #include #include
creat64(2) OSS System Calls Reference Manual An application call to creat( ) is automatically mapped to this function when you use the #define _FILE_OFFSET_BITS 64 feature test macro or an equivalent compiler command option to compile the application. The creat64( ) function establishes a connection between the file indicated by the path parameter and the returned file descriptor. Subsequent I/O function calls, such as read( ) and write( ), use the opened file descriptor to access that file.
System Functions (a - d) • creat64(2) The file does not allow write access. File Type Flags The file type flags that can be logically ORed into the value specified in the mode parameter are: S_IFREG Regular file in the OSS file system or in /G, the Guardian file system. S_ISVTX Sticky bit; used only for directories (cannot be used for files in /G, the Guardian file system). Access Control Lists (ACLs) The creat64( ) function does not change the ACL for an existing file.
creat64(2) OSS System Calls Reference Manual • If the file is an EDIT file and write access is specified, the call fails, and errno is set to the value [EINVAL]. • The maximum number of opens is reported by the sysconf( ) function as the upper limit of opens per process. The actual limit depends on other factors, such as the size of the process file segment (PFS) and the number of existing opens on directories or on files in the Guardian environment.
System Functions (a - d) creat64(2) [EFAULT] The path parameter points to a location outide of the allocated address space of the process. [EFILEBAD] One of these conditions exists: [EFSBAD] • The function attempted to open a Guardian EDIT file, but the structure of the file is bad. • The function attempted to open a Guardian EDIT file, but the corrupted flag is set in the file label. The fileset catalog for one of the filesets involved in the operation is corrupt.
creat64(2) OSS System Calls Reference Manual [ENAMETOOLONG] One of these is too long: • The pathname pointed to by the path parameter • A component of the pathname pointed to by the path parameter • The intermediate result of pathname resolution when a symbolic link is part of the path parameter The pathconf( ) function can be called to obtain the applicable limits. [ENFILE] The maximum allowable number of files are currently open in this node.
System Functions (a - d) creat64(2) [EROFS] The named file resides on a read-only fileset, and write access is required. [ETXTBSY] The file is being executed. For all other error conditions, errno is set to the appropriate Guardian file-system error number. For more information about a specific Guardian file-system error, see the Guardian Procedure Errors and Messages Manual. RELATED INFORMATION Commands: getacl(1), setacl(1).
ctermid_r(2) OSS System Calls Reference Manual NAME ctermid_r - Generates the pathname for the controlling terminal (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include char *ctermid_r ( char *s ); PARAMETERS s Indicates where to store the returned pathname. If the s parameter is a null pointer, the function returns a null character string.
System Functions (a - d) ctermid_r(2) STANDARDS CONFORMANCE This function is an extension to the UNIX98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
ctime_r(2) OSS System Calls Reference Manual NAME ctime_r - Converts time since the Epoch into a date and time string (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include char *ctime_r ( const time_t *clock, char *buf ); PARAMETERS clock Points to a variable that specifies a time value in seconds. buf Points to the buffer where the converted time is stored.
System Functions (a - d) dup(2) NAME dup - Duplicates an open file descriptor LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int dup( int filedes); PARAMETERS filedes Specifies an open file descriptor obtained from a successful call to the accept( ), creat( ), dup( ), dup2( ), fcntl( ), open( ), pipe( ), socket( ), or socketpair( ) function.
dup(2) OSS System Calls Reference Manual [EISGUARDIAN] The value used for the filedes parameter is appropriate only in the Guardian environment. [EMFILE] The number of file descriptors exceeds the maximum number of opens permitted. [EWRONGID] One of these conditions occurred: • The process attempted an operation on an input/output process (such as a terminal server process) that has failed or is in the down state.
System Functions (a - d) dup2(2) NAME dup2 - Duplicates and controls an open file descriptor LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int dup2( int filedes, int new); PARAMETERS filedes Specifies an open file descriptor obtained from a successful call to the accept( ), creat( ), dup( ), dup2( ), fcntl( ), open( ), pipe( ), socket( ), or socketpair( ) function.
dup2(2) OSS System Calls Reference Manual NOTES The dup2( ) function provides an alternative interface to the service provided by the fcntl( ) function by using the F_DUPFD value of the request parameter. The call: fid = dup2( file1, file2 ); is equivalent to: close( file2 ); fid = fcntl( file1, F_DUPFD, file2 ); RETURN VALUES Upon successful completion, the dup2( ) function returns a new file descriptor. Otherwise, the value -1 is returned, and errno is set to indicate the error.
Section 2. System Functions (e) This section contains reference pages for Open System Services (OSS) system function calls with names that begin with e. These reference pages reside in the cat2 directory and are sorted alphabetically by U.S. English conventions in this section.
exec(2) OSS System Calls Reference Manual NAME exec - Specifies a set of functions that execute a file DESCRIPTION The exec set of functions (execl( ), execle( ), execlp( ), execv( ), execve( ), and execvp( )) replace the current process image with a new process image. The new image is constructed from a regular executable file, called a new process image file. The new process image file is formatted as an executable text or binary file in one of the formats recognized by the exec set of functions.
System Functions (e) execl(2) NAME execl - Executes a file using a pathname, a set of argument strings, and **environ LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include extern char ∗ ∗ environ; int execl( const char ∗ path, const char ∗ arg, . . .); PARAMETERS **environ Points to an array of character pointers to environment strings. The environment strings define the OSS environment for the new process.
execl(2) OSS System Calls Reference Manual counted in argc. The arguments specified by a program with one of the exec set of functions are passed on to the new process image in the corresponding arguments to the main( ) function. The envp[ ] parameter for the main function is an HP extension and is not the preferred method of obtaining the environment variables for the new process. Use of the **environ array is the preferred method.
System Functions (e) execl(2) For those file descriptors that remain open, all attributes of the open file descriptor, including file locks, remain unchanged. All directory streams are closed. Shared Memory Any attached shared memory segments are detached by a successful call to a function in the exec set of functions. Refer to the shmat(2) reference page for additional information about shared memory segment use.
execl(2) OSS System Calls Reference Manual • Session membership • Real user ID • Real group ID • Supplementary group IDs • The time left until an alarm clock signal is posted (see the alarm(3) reference page) • Current working directory • Root directory • File mode creation mask (see the umask(2) reference page) • Process signal mask (see the sigprocmask(2) reference page) • Pending signals (see the sigpending(2) reference page) • The tms_utime, tms_stime, tms_cutime, and tms_cstime f
System Functions (e) execl(2) • Login, remote, and saveabend flags • File creation mask The Guardian attributes of the new process differ from those of the calling process in the following ways: • Segments created or shared using Guardian procedure calls such as SEGMENT_ALLOCATE_ are not inherited. • The program file is the file specified in the function call. • The library file is specified in the program file. • The new process does not inherit the caller’s extended swap file (if any).
execl(2) OSS System Calls Reference Manual Use From the Guardian Environment If called from a Guardian process, the function call fails and errno is set to [ENOTOSS]. RETURN VALUES If the execl( ) function returns to the calling process image, an error has occurred; the return value is -1, and errno is set to indicate the error. ERRORS If any of the following conditions occurs, the function sets errno to the corresponding value.
System Functions (e) execl(2) • The intermediate result of pathname resolution when a symbolic link is part of the pathname pointed to by the path parameter The pathconf( ) function can be called to obtain the applicable limits. [ENODEV] The system cannot find the device containing the fileset containing the process image file. [ENOENT] One of the following conditions exists: • One or more components of the new process image file’s pathname do not exist.
execl(2) OSS System Calls Reference Manual The following are HP extensions to the XPG4 Version 2 specification: 2−10 • Text files containing the #! interpreter_name [optional_string] header line can execute. • The [EINVAL], [ENODEV], [ENOTOSS], and [EUNKNOWN] error values are an HP extension.
System Functions (e) execle(2) NAME execle - Executes a file using a pathname, a set of argument strings, and an undeclared envp array LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include extern char ∗ ∗ environ; int execle( const char ∗ path, const char ∗ arg, . . . /* , (char *)0, char *const envp[ ] */ ); PARAMETERS **environ Points to an array of character pointers to environment strings.
execle(2) OSS System Calls Reference Manual Entering the New Process When a program is executed as a result of a call to a function in the exec set of functions, it is entered as a function call as follows: int main( int argc, char ∗ argv[ ], char ∗ env[ ]); Here, the argc parameter is the argument count, the argv[ ] parameter is an array of character pointers to the arguments themselves, and env[ ] is a pointer to a character array listing the environment variables.
System Functions (e) • execle(2) The first value of arg is discarded. The S_ISUID and S_ISGID mode bits of an executable text file are honored. Those bits of the interpreter_name command interpreter are ignored. When the File Is Invalid If the process image file is not a valid executable object, or if the text file does not contain the header line, the execle( ) function call fails and sets errno to the value of [ENOEXEC].
execle(2) OSS System Calls Reference Manual User ID and Group ID If the set-user-ID mode bit of the new process image file is set (see the chmod(2) reference page), the effective user ID of the new process image is set to the owner ID of the new process image file. Similarly, if the set-group-ID mode bit of the new process image file is set, the effective group ID of the new process image is set to the group ID of the new process image file.
System Functions (e) execle(2) • Home terminal • Job ID • DEFINE mode switch • Process access ID (PAID), unless the S_ISUID mode bit of the new image file is set • Security group list • Job ancestor or GMOM • Unread system message index (PCBMCNT) This attribute assignment is different from the assignment made when creating a new process with Guardian procedures.
execle(2) OSS System Calls Reference Manual • The creator access ID (CAID) is set to the process access ID (PAID) of the calling process. • The PAID depends on whether the S_ISUID mode bit of the image file is set. If so, the PAID is based on the file owner ID. If not, the PAID is the same as for the caller. (The S_ISUID mode bit of the image file has no effect on the security group list.) • The MOM field for the new process depends on whether the calling process is named.
System Functions (e) execle(2) [EFAULT] An input address parameter is outside valid bounds limits. [EINVAL] The new process image file is a binary executable file with invalid attributes. [ELOOP] Too many symbolic links were encountered in pathname resolution. [EMFILE] The maximum number of files is open. The process attempted to open more than the maximum number of file descriptors allowed for the process.
execle(2) OSS System Calls Reference Manual Miscellaneous: environ(5). STANDARDS CONFORMANCE The POSIX standards leave some features to the implementing vendor to define. The following features are affected in the HP implementation: • Guardian attributes are associated with the new OSS process. See Guardian Attributes under DESCRIPTION. • The contents of the st_atime field following a failed function call in which the file was found should not be depended upon for further processing.
System Functions (e) execlp(2) NAME execlp - Executes a file using a filename, a set of argument strings, and **environ LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include extern char ∗ ∗ environ; int execlp( const char ∗ file, const char ∗ arg, . . .); PARAMETERS **environ Points to an array of character pointers to environment strings. The environment strings define the OSS environment for the new process.
execlp(2) OSS System Calls Reference Manual Entering the New Process When a program is executed as a result of a call to a function in the exec set of functions, it is entered as a function call as follows: int main( int argc, char ∗ argv[ ], char ∗ env[ ]); Here, the argc parameter is the argument count, the argv[ ] parameter is an array of character pointers to the arguments themselves, and env[ ] is a pointer to a character array listing the environment variables.
System Functions (e) execlp(2) • argv[0] is set to the string "sh". • argv[1] is set to the original value of the file parameter. • The remaining elements of argv[ ] are set to the second and subsequent values of the arg parameter. • The first instance of arg is discarded.
execlp(2) OSS System Calls Reference Manual User ID and Group ID If the set-user-ID mode bit of the new process image file is set (see the chmod(2) reference page), the effective user ID of the new process image is set to the owner ID of the new process image file. Similarly, if the set-group-ID mode bit of the new process image file is set, the effective group ID of the new process image is set to the group ID of the new process image file.
System Functions (e) execlp(2) • Home terminal • Job ID • DEFINE mode switch • Process access ID (PAID), unless the S_ISUID mode bit of the new image file is set • Security group list • Job ancestor or GMOM • Unread system message index (PCBMCNT) This attribute assignment is different from the assignment made when creating a new process with Guardian procedures.
execlp(2) OSS System Calls Reference Manual • The creator access ID (CAID) is set to the process access ID (PAID) of the calling process. • The PAID depends on whether the S_ISUID mode bit of the image file is set. If so, the PAID is based on the file owner ID. If not, the PAID is the same as for the caller. (The S_ISUID mode bit of the image file has no effect on the security group list.) • The MOM field for the new process depends on whether the calling process is named.
System Functions (e) execlp(2) [EFAULT] An input address parameter is outside valid bounds limits. [EINVAL] The new process image file is a binary executable file with invalid attributes. [ELOOP] Too many symbolic links were encountered in pathname resolution. [EMFILE] The maximum number of files is open. The process attempted to open more than the maximum number of file descriptors allowed for the process.
execlp(2) OSS System Calls Reference Manual STANDARDS CONFORMANCE The POSIX standards leave some features to the implementing vendor to define. The following features are affected in the HP implementation: • Guardian attributes are associated with the new OSS process. See Guardian Attributes under DESCRIPTION. • [ENOENT] is returned in errno if the environment variable PATH is not defined when the execlp( ) function is called.
System Functions (e) execv(2) NAME execv - Executes a file using a pathname, an argv array, and **environ LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include extern char ∗ ∗ environ; int execv( const char ∗ path, char ∗ const argv[ ]); PARAMETERS **environ Points to an array of character pointers to environment strings. The environment strings define the OSS environment for the new process.
execv(2) OSS System Calls Reference Manual counted in argc. The arguments specified by a program with one of the exec set of functions are passed on to the new process image in the corresponding arguments to the main( ) function. The env[ ] parameter for the main function is an HP extension and is not the preferred method of obtaining the environment variables for the new process. Use of the **environ array is the preferred method.
System Functions (e) execv(2) For those file descriptors that remain open, all attributes of the open file descriptor, including file locks, remain unchanged. All directory streams are closed. Shared Memory Any attached shared memory segments are detached by a successful call to a function in the exec set of functions. Refer to the shmat(2) reference page for additional information about shared memory segment use.
execv(2) OSS System Calls Reference Manual • Session membership • Real user ID • Real group ID • Supplementary group IDs • The time left until an alarm clock signal is posted (see the alarm(3) reference page) • Current working directory • Root directory • File mode creation mask (see the umask(2) reference page) • Process signal mask (see the sigprocmask(2) reference page) • Pending signals (see the sigpending(2) reference page) • The tms_utime, tms_stime, tms_cutime, and tms_cstime f
System Functions (e) execv(2) • Login, remote, and saveabend flags • File creation mask The Guardian attributes of the new process differ from those of the calling process in the following ways: • Segments created or shared using Guardian procedure calls such as SEGMENT_ALLOCATE_ are not inherited. • The program file is the file specified in the function call. • The library file is specified in the program file. • The new process does not inherit the caller’s extended swap file (if any).
execv(2) OSS System Calls Reference Manual Use From the Guardian Environment If called from a Guardian process, the function call fails and errno is set to [ENOTOSS]. RETURN VALUES If the execv( ) function returns to the calling process image, an error has occurred; the return value is -1, and errno is set to indicate the error. ERRORS If any of the following conditions occurs, the function sets errno to the corresponding value.
System Functions (e) execv(2) • A component of the pathname pointed to by the path parameter • The intermediate result of pathname resolution when a symbolic link is part of the pathname pointed to by the path parameter The pathconf( ) function can be called to obtain the applicable limits. [ENODEV] The system cannot find the device containing the fileset containing the process image file.
execv(2) OSS System Calls Reference Manual The following are HP extensions to the XPG4 Version 2 specification: 2−34 • Text files containing the #! interpreter_name [optional_string] header line can execute. • The [EINVAL], [ENODEV], [ENOTOSS], and [EUNKNOWN] error values are an HP extension.
System Functions (e) execve(2) NAME execve - Executes a file using a pathname, an argv array, and an envp array LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include extern char ∗ ∗ environ; int execve( const char ∗ path, char ∗ const argv[ ], char ∗ const envp[ ]); PARAMETERS **environ Points to an array of character pointers to environment strings.
execve(2) OSS System Calls Reference Manual A successful execve( ) function call does not return, because the calling process image is overlaid by the new process image.
System Functions (e) execve(2) When the File Is Invalid If the process image file is not a valid executable object, or if the text file does not contain the header line, the execve( ) function call fails and errno is set to the value of [ENOEXEC].
execve(2) OSS System Calls Reference Manual the new process image are saved (as the saved-set-user ID and the saved-set-group ID) for use by the setuid( ) function. The _POSIX_SAVED_IDS flag is defined TRUE.
System Functions (e) execve(2) • Security group list • Job ancestor or GMOM • Unread system message index (PCBMCNT) This attribute assignment is different from the assignment made when creating a new process with Guardian procedures. • Outstanding incoming and outgoing message limits This attribute assignment is different from the assignment made when creating a new process with Guardian procedures.
execve(2) OSS System Calls Reference Manual • The PAID depends on whether the S_ISUID mode bit of the image file is set. If so, the PAID is based on the file owner ID. If not, the PAID is the same as for the caller. (The S_ISUID mode bit of the image file has no effect on the security group list.) • The MOM field for the new process depends on whether the calling process is named. If so, the MOM field for the new process is set to the caller’s ANCESTOR field.
System Functions (e) execve(2) [EINVAL] The new process image file is a binary executable file with invalid attributes. [ELOOP] Too many symbolic links were encountered in pathname resolution. [EMFILE] The maximum number of files is open. The process attempted to open more than the maximum number of file descriptors allowed for the process. The process file segment (PFS) of the new process might be smaller than that of the calling process.
execve(2) OSS System Calls Reference Manual STANDARDS CONFORMANCE The POSIX standards leave some features to the implementing vendor to define. The following features are affected in the HP implementation: • Guardian attributes are associated with the new OSS process. See Guardian Attributes under DESCRIPTION. • The contents of the st_atime field following a failed function call in which the file was found should not be depended upon for further processing.
System Functions (e) execvp(2) NAME execvp - Executes a file using a filename, an argv array, and **environ LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include extern char ∗ ∗ environ; int execvp( const char ∗ file, char ∗ const argv[ ]); PARAMETERS **environ Points to an array of character pointers to environment strings. The environment strings define the OSS environment for the new process.
execvp(2) OSS System Calls Reference Manual Entering the New Process When a program is executed as a result of a call to a function in the exec set of functions, it is entered as a function call as follows: int main( int argc, char ∗ argv[ ], char ∗ env[ ]); Here, the argc parameter is the argument count, the argv[ ] parameter is an array of character pointers to the arguments themselves, and env[ ] is a pointer to a character array listing the environment variables.
System Functions (e) execvp(2) • argv[0] is set to the string "sh". • argv[1] is set to the original value of the file parameter. • The remaining elements of argv[ ] are set to the original elements of argv[ ], starting with argv[1]. • The original value of argv[0] is discarded.
execvp(2) OSS System Calls Reference Manual User ID and Group ID If the set-user-ID mode bit of the new process image file is set (see the chmod(2) reference page), the effective user ID of the new process image is set to the owner ID of the new process image file. Similarly, if the set-group-ID mode bit of the new process image file is set, the effective group ID of the new process image is set to the group ID of the new process image file.
System Functions (e) execvp(2) • Processor on which the process executes • Home terminal • Job ID • DEFINE mode switch • Process access ID (PAID), unless the S_ISUID mode bit of the new image file is set • Security group list • Job ancestor or GMOM • Unread system message index (PCBMCNT) This attribute assignment is different from the assignment made when creating a new process with Guardian procedures.
execvp(2) OSS System Calls Reference Manual — The PIN of the calling process was unrestricted. If the PIN of the new process is restricted, then the PIN is in the range 0 through 254. • The creator access ID (CAID) is set to the process access ID (PAID) of the calling process. • The PAID depends on whether the S_ISUID mode bit of the image file is set. If so, the PAID is based on the file owner ID. If not, the PAID is the same as for the caller.
System Functions (e) execvp(2) • The new process image file, any library file, or script file denies execution permission. • The new process image file is not a regular file. [EAGAIN] System resources such as disk space, process control block (PCB) space, MAPPOOL space, stack space, or PFS space are temporarily inadequate. [EFAULT] An input address parameter is outside valid bounds limits. [EINVAL] The new process image file is a binary executable file with invalid attributes.
execvp(2) OSS System Calls Reference Manual Miscellaneous: environ(5). STANDARDS CONFORMANCE The POSIX standards leave some features to the implementing vendor to define. The following features are affected in the HP implementation: • Guardian attributes are associated with the new OSS process. See Guardian Attributes under DESCRIPTION. • [ENOENT] is returned in errno if the environment variable PATH is not defined when the execvp( ) function is called.
System Functions (e) _exit(2) NAME _exit - Terminates a process LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include void _exit( int status); PARAMETERS status Indicates the status of the process.
_exit(2) OSS System Calls Reference Manual new controlling process. • If the exit of a process causes a process group to become orphaned, and if any member of the newly orphaned process group is stopped, then a SIGHUP signal followed by a SIGCONT signal is sent to each member of the orphaned process group. • Locks set by the fcntl( ) function are removed. Use From the Guardian Environment The _exit( ) function can be called from any Guardian process as well as from OSS processes.
Section 3. System Functions (f - i) This section contains reference pages for Open System Services (OSS) system function calls with names that begin with f through i. These reference pages reside in the cat2 directory and are sorted alphabetically by U.S. English conventions in this section.
fchmod(2) OSS System Calls Reference Manual NAME fchmod - Changes file-access permissions LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ int fchmod( int filedes, mode_t mode); PARAMETERS filedes Specifies the file descriptor of an open file.
System Functions (f - i) fchmod(2) S_IRWXU Permits the file’s owner to read, write, and execute the file (or to search the directory). S_IRUSR Permits the file’s owner to read the file. S_IWUSR Permits the file’s owner to write to the file. S_IXUSR Permits the file’s owner to execute the file (or to search the directory). S_IRWXG Permits the file’s group to read, write, and execute the file (or to search the directory). S_IRGRP Permits the file’s group to read the file.
fchmod(2) OSS System Calls Reference Manual optional (nondefault) ACL entries with nonzero permissions also have the comment # effective:---. | | To set the permission bits of ACL entries, use the acl( ) function instead of the fchmod( ) function. | | ACLs are not supported for symbolic links. Use on Guardian Objects Attempting to set the access permissions on a Guardian file (that is, a file in the /G file system) fails with errno set to [EINVAL].
System Functions (f - i) fchmod(2) • The specified file is on a remote node, and communication with the remote name server has been lost. [EOSSNOTRUNNING] The program attempted an operation on an object in the OSS environment while a required system process was not running. [EPERM] The effective user ID does not match the ID of the owner of the file, and the calling process does not have super ID privilege. [EROFS] The file referred to by filedes resides on a read-only fileset.
fchown(2) OSS System Calls Reference Manual NAME fchown - Changes the owner and group IDs of a file LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ int fchown( int filedes, uid_t owner, gid_t group); PARAMETERS filedes Specifies a valid file descriptor.
System Functions (f - i) fchown(2) Access Control Lists (ACLs) A user can allow or deny specific individuals and groups access to a file by using an ACL on the file. When using the fchown( ) function with ACLs, if the new owner and/or group of a file have optional ACL entries corresponding to user:uid:perm or group:gid:perm in the ACL for a file, those entries remain in the ACL but no longer have any effect because they are superseded by the user::perm or group::perm entries in the ACL.
fchown(2) OSS System Calls Reference Manual [EINVAL] The owner or group parameter is out of range. An attempt was made to change ownership of a Guardian file that is not a disk file. [EIO] An input or output error occurred. The device holding the file might be in the down state, or both processors that provide access to the device might have failed. [ENOENT] The program attempted an operation on a file that is open but that has been unlinked (and the attributes of the file are no longer alterable).
System Functions (f - i) fchown(2) HP extensions to the XPG4 Version 2 specification are: • 527186-007 The errno values [EFSBAD], [EIO], [ENOROOT], and [EOSSNOTRUNNING] can be returned.
fcntl(2) OSS System Calls Reference Manual NAME fcntl - Controls open file descriptors LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include #include /* optional except for POSIX.1 */ /* optional except for POSIX.
System Functions (f - i) F_GETFD fcntl(2) Gets the value of the file descriptor flags, defined in the fcntl.h header file, that are associated with the value of the filedes parameter. File descriptor flags are associated with a single file descriptor and do not affect other file descriptors that refer to the same file. The argument1 parameter or argument2 parameter is ignored. The value F_GETFD is invalid for an OSSTTY or Telserv terminal device.
fcntl(2) OSS System Calls Reference Manual The file access mode is not changed when F_SETFL is used. F_GETOWN Gets the process ID or process group ID currently receiving the SIGURG signal for a socket. A process group ID is returned as a negative value. A positive value indicates the process ID. The value F_GETOWN is invalid for these calls: F_SETOWN • Guardian use of OSS sockets is not supported.
System Functions (f - i) fcntl(2) F_SETLKW64 Similar to F_SETLKW, except that it takes a pointer to a flock64 structure instead of a pointer to a flock structure. | The O_NONBLOCK file status flag affects only operations against file descriptors derived from the same open( ) function. When a shared lock is set on a segment of a file, other processes can set shared locks on that segment or a portion of it.
fcntl(2) OSS System Calls Reference Manual F_SETFD Returns the value 0 (zero). F_SETFL Returns the value 0 (zero). F_SETLK Returns the value 0 (zero). F_SETLK64 Returns the value 0 (zero). F_SETLKW Returns the value 0 (zero). F_SETLKW64 Returns the value 0 (zero). F_SETOWN Returns the value 0 (zero). If the fcntl( ) function fails, the value -1 is returned, and errno is set to indicate the error.
System Functions (f - i) [EIO] fcntl(2) • The request parameter is F_GETLK, F_GETLK64, F_SETLK, F_SETLK64, F_SETLKW,or F_SETLKW64, and the data pointed to by argument2 is invalid, or filedes refers to a file that does not support locking. • The request parameter is F_GETOWN, and the filedes parameter does not specify a socket. • The request parameter is F_SETFD, and a flag in addition to FD_CLOEXEC in the argument1 parameter is set.
fcntl(2) OSS System Calls Reference Manual [EWRONGID] One of these conditions occurred: • The process attempted an operation through an operating system input/output process (such as a terminal server process) that failed or is in the down state. • The processor for the disk process of the specified file failed during an input or output operation, and the backup process took over.
System Functions (f - i) fork(2) NAME fork - Creates a new process LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ pid_t fork(void); DESCRIPTION The fork( ) function creates a new OSS process. The created process is referred to as the child and the caller as the parent.
fork(2) OSS System Calls Reference Manual • The child process has its own copy of the parent process’s file descriptors. However, each of the child’s file descriptors shares a common file pointer with the corresponding file descriptor of the parent process. • The child process does not inherit any file open created by a Guardian function or procedure call. • The child process does not inherit file locks.
System Functions (f - i) fork(2) • Process access ID (PAID) • Security group list • Job ancestor or GMOM • Unread system message index count (PCBMCNT) This attribute assignment is different from the assignment made when creating a new process with Guardian procedures. • Outstanding incoming and outgoing message limits This attribute assignment is different from the assignment made when creating a new process with Guardian procedures.
fork(2) OSS System Calls Reference Manual Floating-Point Data If the parent process uses IEEE floating-point data, the child process inherits all of the floatingpoint register contents of the parent process and any computation started before the fork( ) function call completes in the child process. The contents of the status and control register are also inherited.
System Functions (f - i) fork(2) The following are HP extensions to the XPG4 Version 2 specification: • 527186-007 The [EFAULT], [ENOTOSS], and [EUNKNOWN] error values are HP extensions.
fstat(2) OSS System Calls Reference Manual NAME fstat - Provides information about an open file LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.
System Functions (f - i) st_dev fstat(2) OSS device identifier for a fileset. Values for local OSS objects are listed next. Values for local Guardian objects are described in Use on Guardian Objects, and values for remote Guardian or OSS objects are described in Use on Remote Objects, later in this reference page.
fstat(2) OSS System Calls Reference Manual S_IFSOCK Socket. For an AF_INET or AF_INET6 socket, the user default permissions are returned for the permission bits. The access flags are set to read and write. For an AF_UNIX socket, the user permissions from the inode for the socket are returned for the permission bits. The access flags are also returned from the inode. S_IRWXG Permissions for the owning group, or if the st_acl flag is set, permissions for the the class ACL entry.
System Functions (f - i) st_uid fstat(2) For Contains Regular file Directory FIFO Pipe AF_INET or AF_INET6 socket AF_UNIX socket /dev/null /dev/tty Number of links to the file Number of links to the directory Number of links to the file -1 0 (zero) Number of links to the socket file Number of links to the file Number of links to the file User ID. Values for OSS objects are listed next. Values for Guardian objects are described in Use on Guardian Objects, later in this reference page.
fstat(2) OSS System Calls Reference Manual st_size For Contains Regular file Directory Pipe or FIFO AF_INET or AF_INET6 socket AF_UNIX socket /dev/null /dev/tty Undefined Undefined Undefined 0 (zero) 0 (zero) Undefined ID of the device File size. Values for OSS objects are listed next. Values for Guardian objects are described in Use on Guardian Objects, later in this reference page.
System Functions (f - i) fstat(2) For Contains Regular file Directory Pipe or FIFO AF_INET or AF_INET6 socket Time of the last data modification Time of the last modification Time of the last data modification Value maintained in the socket data structure Value retrieved from the inode Current time Composite value of the times of all openers of the file AF_UNIX socket /dev/null /dev/tty For the /E entry of the local node, the value is the time of the most recent mounting of the root fileset.
fstat(2) OSS System Calls Reference Manual calls. The st_ctime and st_atime fields for Guardian regular disk files (except for EDIT files) are updated by OSS function calls, not by Guardian procedure calls. The time fields for /G, /G/vol, and /G/vol/subvol always contain the current time.
System Functions (f - i) fstat(2) NOTES The OSS Network File System (NFS) cannot access files that have optional ACL entries. | RETURN VALUES Upon successful completion, the value 0 (zero) is returned. Otherwise, the value -1 is returned, and errno is set to indicate the error. ERRORS If any of these conditions occurs, the fstat( ) function sets errno to the corresponding value: [EBADF] The filedes parameter is not a valid file descriptor.
fstat(2) OSS System Calls Reference Manual For all other error conditions, errno is set to the appropriate Guardian file-system error number. See the Guardian Procedure Errors and Messages Manual for more information about a specific Guardian file-system error. RELATED INFORMATION Commands: getacl(1), setacl(1). | Functions: acl(2), chmod(2), chown(2), fstat64(2), link(2), mknod(2), open(2), open64(2), pipe(2), utime(2). | Miscellaneous Topics: acl(5).
System Functions (f - i) fstat64(2) NAME fstat64 - Provides information about an open file LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.
fstat64(2) OSS System Calls Reference Manual The fstat64( ) function updates any time-related fields associated with the file before writing into the stat64 structure, unless it is a read-only fileset. Time-related fields are not updated for readonly OSS filesets. The fields in the stat64 structure have these meanings and content: st_dev OSS device identifier for a fileset. Values for local OSS objects are listed next.
System Functions (f - i) fstat64(2) S_IFDIR Directory. S_IFIFO Pipe or FIFO. S_IFREG Regular file. S_IFSOCK Socket. For an AF_INET or AF_INET6 socket, the user default permissions are returned for the permission bits. The access flags are set to read and write. For an AF_UNIX socket, the user permissions from the inode for the socket are returned for the permission bits. The access flags are also returned from the inode.
fstat64(2) OSS System Calls Reference Manual For Contains Regular file Directory FIFO Pipe AF_INET or AF_INET6 socket AF_UNIX socket /dev/null /dev/tty Number of links to the file Number of links to the directory Number of links to the file -1 0 (zero) Number of links to the socket file Number of links to the file Number of links to the file st_acl If set to 1, indicates that the file has optional access control list (ACL) entries.
System Functions (f - i) st_size fstat64(2) For Contains Regular file Directory Pipe or FIFO AF_INET or AF_INET6 socket AF_UNIX socket /dev/null /dev/tty Undefined Undefined Undefined 0 (zero) 0 (zero) Undefined ID of the device File size. Values for OSS objects are listed next. Values for Guardian objects are described in Use on Guardian Objects, later in this reference page.
fstat64(2) OSS System Calls Reference Manual For Contains Regular file Directory Pipe or FIFO AF_INET or AF_INET6 socket Time of the last data modification Time of the last modification Time of the last data modification Value maintained in the socket data structure Value retrieved from the inode Current time Composite value of the times of all openers of the file AF_UNIX socket /dev/null /dev/tty For the /E entry of the local node, the value is the time of the most recent mounting of the root filese
System Functions (f - i) fstat64(2) calls. The st_ctime and st_atime fields for Guardian regular disk files (except for EDIT files) are updated by OSS function calls, not by Guardian procedure calls. The time fields for /G, /G/vol, and /G/vol/subvol always contain the current time.
fstat64(2) OSS System Calls Reference Manual NOTES The OSS Network File System (NFS) cannot access files that have optional ACL entries. RETURN VALUES Upon successful completion, the value 0 (zero) is returned. Otherwise, the value -1 is returned, and errno is set to indicate the error. ERRORS If any of these conditions occurs, the fstat64( ) function sets errno to the corresponding value: [EBADF] The filedes parameter is not a valid file descriptor.
System Functions (f - i) fstat64(2) RELATED INFORMATION Commands: getacl(1), setacl(1). | Functions: acl(2), chmod(2), chown(2), fstat(2), link(2), mknod(2), open(2), open64(2), pipe(2), utime(2). | Miscellaneous Topics: acl(5). | STANDARDS CONFORMANCE This function is an HP extension to the XPG4 Version 2 specification.
fstatvfs(2) OSS System Calls Reference Manual NAME fstatvfs - Gets fileset information for an open file LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int fstatvfs( int filedes, struct statvfs *buffer); PARAMETERS filedes Specifies an open file descriptor obtained from a successful call to the creat( ), creat64( ), dup( ), dup2( ), fcntl( ),open( ), or open64( ) function.
System Functions (f - i) f_frsize f_blocks fstatvfs(2) For Contains Regular file Directory FIFO /dev/null Object in /G /G Terminal device file /E 4096 4096 4096 4096 4096 4096 4096 4096 Fundamental file system block size: For Contains Regular file Directory FIFO /dev/null Object in /G /G Terminal device file /E 4096 4096 4096 4096 4096 4096 4096 4096 Total number of blocks in fileset, in units of f_frsize: For Contains Regular file Number of blocks on all volumes ever used in the fileset.
fstatvfs(2) OSS System Calls Reference Manual For Contains Regular file Number of free blocks on all volumes currently in the storage-pool file for the fileset. Number of free blocks on all volumes currently in the storage-pool file for the fileset. Number of free blocks on all volumes currently in the storage-pool file for the fileset. Number of free blocks on all volumes currently in the storage-pool file for the fileset. Number of free blocks in the volume containing the object.
System Functions (f - i) f_ffree fstatvfs(2) For Contains Regular file Directory FIFO /dev/null Object in /G /G Terminal device file /E Number of inode numbers in the fileset. Number of inode numbers in the fileset. Number of inode numbers in the fileset. Number of inode numbers in the fileset. The value of ULONG_MAX. 0 0 0 Total number of free file serial numbers (inode numbers) in the fileset: For Contains Regular file Number of free inode numbers in the fileset.
fstatvfs(2) f_fsid OSS System Calls Reference Manual Fileset identifier: For Contains Regular file Lower 32 bits of the st_dev field in the stat structure. Lower 32 bits of the st_dev field in the stat structure. Lower 32 bits of the st_dev field in the stat structure. Lower 32 bits of the st_dev field in the stat structure. Lower 32 bits of the st_dev field in the stat structure. Lower 32 bits of the st_dev field in the stat structure. Lower 32 bits of the st_dev field in the stat structure.
System Functions (f - i) fstatvfs(2) Terminal device file /E 2 3 The content of the f_flag field can be tested with these symbolic values: ST_NOSUID This bit flag is set if the fileset does not allow the setuid bit to be set for its member files. ST_NOTRUNC This bit flag is set if the fileset does not truncate filenames. ST_RDONLY This bit flag is set if the fileset is mounted for read-only access.
fstatvfs(2) f_bminavail f_bmaxavail OSS System Calls Reference Manual Number of blocks free on the disk volume with the least space remaining: For Contains Regular file Directory FIFO /dev/null Object in /G /G Terminal device file /E Number of blocks. Number of blocks. Number of blocks. Number of blocks. Number of blocks.
System Functions (f - i) fstatvfs(2) [EISGUARDIAN] The value used for the filedes parameter is appropriate only in the Guardian environment. [ENETDOWN] The filedes parameter specifies a file on a remote HP NonStop node, but communication with the remote node has been lost. [EOVERFLOW] One of the values returned cannot be represented correctly in the structure pointed to by the buffer parameter.
fstatvfs64(2) OSS System Calls Reference Manual NAME fstatvfs64 - Gets fileset information for an open file LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int fstatvfs64( int filedes, struct statvfs64 *buffer); PARAMETERS filedes Specifies an open file descriptor obtained from a successful call to the creat( ), creat64( ), dup( ), dup2( ), fcntl( ), open( ), or open64( ) function.
System Functions (f - i) fstatvfs64(2) The fields in this structure have these meanings and content: f_bsize f_frsize f_blocks Fileset block size: For Contains Regular file Directory FIFO /dev/null Object in /G /G Terminal device file /E 4096 4096 4096 4096 4096 4096 4096 4096 Fundamental file system block size: For Contains Regular file Directory FIFO /dev/null Object in /G /G Terminal device file /E 4096 4096 4096 4096 4096 4096 4096 4096 Total number of blocks in fileset, in units of f_frsiz
fstatvfs64(2) f_bfree OSS System Calls Reference Manual Total number of free blocks in fileset: For Contains Regular file Number of free blocks on all volumes currently in the storage-pool file for the fileset. Number of free blocks on all volumes currently in the storage-pool file for the fileset. Number of free blocks on all volumes currently in the storage-pool file for the fileset. Number of free blocks on all volumes currently in the storage-pool file for the fileset.
System Functions (f - i) f_files f_ffree fstatvfs64(2) Total number of file serial numbers (inode numbers) in the fileset: For Contains Regular file Directory FIFO /dev/null Object in /G /G Terminal device file /E Number of inode numbers in the fileset. Number of inode numbers in the fileset. Number of inode numbers in the fileset. Number of inode numbers in the fileset. The value of ULONG_MAX.
fstatvfs64(2) f_fsid OSS System Calls Reference Manual Fileset identifier: For Contains Regular file Lower 32 bits of the st_dev field in the stat structure. Lower 32 bits of the st_dev field in the stat structure. Lower 32 bits of the st_dev field in the stat structure. Lower 32 bits of the st_dev field in the stat structure. Lower 32 bits of the st_dev field in the stat structure. Lower 32 bits of the st_dev field in the stat structure. Lower 32 bits of the st_dev field in the stat structure.
System Functions (f - i) fstatvfs64(2) Terminal device file /E 2 3 The content of the f_flag field can be tested with these symbolic values: ST_NOSUID This bit flag is set if the fileset does not allow the setuid bit to be set for its member files. ST_NOTRUNC This bit flag is set if the fileset does not truncate filenames. ST_RDONLY This bit flag is set if the fileset is mounted for read-only access.
fstatvfs64(2) f_bminavail f_bmaxavail OSS System Calls Reference Manual Number of blocks free on the disk volume with the least space remaining: For Contains Regular file Directory FIFO /dev/null Object in /G /G Terminal device file /E Number of blocks. Number of blocks. Number of blocks. Number of blocks. Number of blocks.
System Functions (f - i) fstatvfs64(2) [EISGUARDIAN] The value used for the filedes parameter is appropriate only in the Guardian environment. [ENETDOWN] The filedes parameter specifies a file on a remote HP NonStop node, but communication with the remote node has been lost. [EWRONGID] One of these conditions occurred: • The process attempted an input or output operation through an operating system input/output process (such as a terminal server process) that has failed or is in the down state.
fsync(2) OSS System Calls Reference Manual NAME fsync - Writes modified data and file attributes to permanent storage LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int fsync( int filedes); PARAMETERS filedes Specifies an open file descriptor obtained from a successful call to the accept( ), creat( ), dup( ), dup2( ), fcntl( ), open( ), pipe( ), socket( ), or socketpair( ) function.
System Functions (f - i) [ENXIO] fsync(2) No such device or address. An invalid device or address was specified during an input or output operation on a special file. One of these events occurred: • A device was specified that does not exist, or a request was made beyond the limits of the device. • The fileset containing the requestor’s current working directory or root directory is not mounted.
ftruncate(2) OSS System Calls Reference Manual NAME ftruncate - Changes file length LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int ftruncate( int filedes, off_t length); PARAMETERS filedes Specifies the descriptor of a file that must be open for writing. length Specifies the new length of the file in bytes.
System Functions (f - i) [EIO] ftruncate(2) One of these conditions occurred: • The process is a member of a background process group attempting to read from its controlling terminal, the process is ignoring or blocking the SIGTTIN signal, or the process group is orphaned. • A physical I/O error occurred. The device holding the file might be in the down state, or both processors that provide access to the device might have failed. Data might have been lost during a transfer.
ftruncate64(2) OSS System Calls Reference Manual NAME ftruncate64 - Changes file length LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int ftruncate64( int filedes, off64_t length); PARAMETERS filedes Specifies the descriptor of a file that must be open for writing. length Specifies the new length of the file in bytes.
System Functions (f - i) ftruncate64(2) ERRORS If any of these conditions occurs, the ftruncate64( ) function sets errno to the corresponding value: [EBADF] The filedes parameter does not specify a valid file descriptor open for writing. [EFBIG] The length parameter is greater than the minimum of 2 gigabytes minus 1 byte and the maximum file size established during file open. [EINTR] The function was interrupted by a signal before any data arrived.
gamma_r(2) OSS System Calls Reference Manual NAME gamma_r - Computes the logarithm of the gamma function (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include double gamma_r ( double x, int *signgamp ); extern int signgam; PARAMETERS x Specifies a positive double value. signgamp Points to the sign of the gamma function.
System Functions (f - i) gamma_r(2) If the correct value would cause overflow, HUGE_VAL is returned. If the correct value would cause underflow, 0.0 (zero) is returned. ERRORS If this condition occurs, the gamma_r( ) function sets errno to the corresponding value: [EDOM] The value of x is 0.0, (zero), a nonpositive integer, or negative infinity. RELATED INFORMATION Functions: exp(3), fp_class(3), gamma(3), isnan(3), lgamma(3), lgamma_r(2).
getegid(2) OSS System Calls Reference Manual NAME getegid - Gets the effective group ID LIBRARY G-series native OSS processes: /G/system/sysnn/zsecsrl H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include #include /* optional except for POSIX.1 */ gid_t getegid(void); DESCRIPTION The getegid( ) function returns the effective group ID of the calling process.
System Functions (f - i) geteuid(2) NAME geteuid - Gets the effective user ID of the current process LIBRARY G-series native OSS processes: /G/system/sysnn/zsecsrl H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include #include /* optional except for POSIX.1 */ uid_t geteuid(void); DESCRIPTION The geteuid( ) function returns the effective user ID of the current process. RETURN VALUES The geteuid( ) function returns the requested user ID.
getgid(2) OSS System Calls Reference Manual NAME getgid - Gets the real group ID LIBRARY G-series native OSS processes: /G/system/sysnn/zsecsrl H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include #include /* optional except for POSIX.1 */ gid_t getgid(void); DESCRIPTION The getgid( ) function returns the real group ID of the calling process.
System Functions (f - i) getgrent_r(2) NAME getgrent_r - Gets group information from the group database (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include struct group *getgrent_r ( struct group *grp, char *buffer, size_t buflen ); PARAMETERS grp Points to a struct group structure allocated by the caller.
getgrent_r(2) OSS System Calls Reference Manual The gr_passwd field is provided for compatibility with some versions of UNIX, but it always contains a null string. NOTES Use the functions getgrnam_r( ) and getgrgid_r( ) instead of this function to ensure portability to future systems. RETURN VALUES The getgrent_r( ) function returns a pointer to a struct group if it successfully enumerates an entry; otherwise, it returns a null pointer and sets errno to indicate the specific error.
System Functions (f - i) getgrgid_r(2) NAME getgrgid_r - Gets group information from the group database (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] [#include ] #include int getgrgid_r ( gid_t gid , struct group *grp, char *buffer, size_t buflen, struct group **result ); PARAMETERS gid Specifies the group ID of the group for which information is to be retrieved.
getgrgid_r(2) OSS System Calls Reference Manual gr_passwd The system does not use this field, so its value is meaningless. gr_gid The group ID of the group. gr_mem The members of the group. OSS supports the following POSIX.1-compliant group declaration: struct group { char *gr_name; char *gr_passwd; gid_t gr_gid; char **gr_mem; }; The gr_passwd field is provided for compatibility with some versions of UNIX, but it always contains a null string.
System Functions (f - i) getgrnam_r(2) NAME getgrnam_r - Gets group information from the group database (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] [#include ] #include
getgrnam_r(2) OSS System Calls Reference Manual gr_gid The group ID of the group. gr_mem The members of the group. OSS supports the following POSIX.1-compliant group declaration: struct group { char *gr_name; char *gr_passwd; gid_t gr_gid; char **gr_mem; }; The gr_passwd field is provided for compatibility with some versions of UNIX, but it always contains a null string. RETURN VALUES Upon successful completion, the getgrnam_r( ) function returns 0 (zero).
System Functions (f - i) getgroups(2) NAME getgroups - Gets the group list of the current process LIBRARY G-series native OSS processes: /G/system/sysnn/zsecsrl H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include #include int getgroups( int gidsetsize, gid_t grouplist [ ]); PARAMETERS gidsetsize Specifies the number of entries that can be stored in the array pointed to by the grouplist parameter.
gethostbyaddr_r(2) OSS System Calls Reference Manual NAME gethostbyaddr_r - Gets a network host entry by address (AF_INET only) (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] [#include ] #include
System Functions (f - i) gethostbyaddr_r(2) NOTES Use the endhostent( ) function to close the /etc/hosts file. RETURN VALUES Upon successful completion of gethostbyaddr_r( ), a pointer to a hostent structure is returned if the address was found, and a null pointer if the address was not found. If the call to gethostbyaddr_r( ) fails, a null pointer is returned.
gethostbyname_r(2) OSS System Calls Reference Manual NAME gethostbyname_r - Gets a host entry by name (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include [extern h_errno;] struct hostent *gethostbyname_r ( const char *name, struct hostent *host, char *buffer, int buflen, int *h_errnop ); PARAMETERS name Specifies the network name or alias.
System Functions (f - i) gethostbyname_r(2) RETURN VALUES Upon successful completion, gethostbyname_r( ) returns a pointer to a hostent structure if the entry was found, and a null pointer if the entry was not found. If the call to gethostbyname_r( ) fails, a null pointer is returned. ERRORS If any of these conditions occur, the gethostbyname_r( ) function sets h_errno to the value that corresponds to the condition: HOST_NOT_FOUND The name you used is not a valid hostname or alias.
gethostent_r(2) OSS System Calls Reference Manual NAME gethostent_r - Gets the next entry in the network host database (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include struct hostent *gethostent_r ( struct hostent *host, char *buffer, int buflen, int *h_errnop ); PARAMETERS host Points to a struct hostent structure allocated by the caller.
System Functions (f - i) gethostent_r(2) NO_DATA | NO_ADDRESS The requested name is valid but no associated address was found. Another type of name server request might succeed. In addition, if the following condition occurs, the gethostent_r( ) function sets errno to the corresponding value: [ERANGE] Insufficient storage was supplied via buffer and buflen to contain the data to be referenced by the resulting hostent structure. /etc/hosts The Internet network hostname database.
gethostname(2) OSS System Calls Reference Manual NAME gethostname - Gets the name of the local host LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include int gethostname( char *address, int address_len); PARAMETERS address Returns the address of an array of bytes where the hostname is stored. If sufficient space is provided, the returned address parameter is NULL terminated.
System Functions (f - i) getlogin(2) NAME getlogin - Gets login name LIBRARY G-series native OSS processes: /G/system/sysnn/zsecsrl H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include char *getlogin(void); DESCRIPTION The getlogin( ) function returns the login name associated with the current session. The login name can be a username or a user alias.
getlogin_r(2) OSS System Calls Reference Manual NAME getlogin_r - Gets login name (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int getlogin_r ( char *name, size_t namesize ); PARAMETERS name Points to the buffer where the login name is stored. namesize Specifies the size of the buffer passed in bytes.
System Functions (f - i) getnetbyaddr_r(2) NAME getnetbyaddr_r - Gets a network entry by address (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] [#include ] #include struct netent *getnetbyaddr_r ( in_addr_t num, int type, struct netent *ret, char *buffer, int buflen ); PARAMETERS num Specifies the number of the network in host-byte order.
getnetbyaddr_r(2) OSS System Calls Reference Manual FILES /etc/networks The Internet network name database file. RELATED INFORMATION Functions: getnetent(3), getnetent_r(2), getnetbyaddr(3), getnetbyname(3), getnetbyname_r(2), setnetent(3), endnetent(3). Files: networks(4). STANDARDS CONFORMANCE This function is an extension to the UNIX98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.
System Functions (f - i) getnetbyname_r(2) NAME getnetbyname_r - Gets a network entry by name (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include struct netent *getnetbyname_r ( const char *name, struct netent *ret, char *buffer, int buflen ); PARAMETERS name Specifies the network name or alias. ret Points to a netent structure allocated by the caller.
getnetbyname_r(2) OSS System Calls Reference Manual STANDARDS CONFORMANCE This function is an extension to the UNIX98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
System Functions (f - i) getnetent_r(2) NAME getnetent_r - Gets the next entry in the network database (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include struct netent *getnetent_r ( struct netent *ret, char *buffer, int buflen ); PARAMETERS ret Points to a netent structure allocated by the caller.
getnetent_r(2) OSS System Calls Reference Manual STANDARDS CONFORMANCE This function is an extension to the UNIX98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
System Functions (f - i) getpeername(2) NAME getpeername - Gets the name of the peer socket LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include int getpeername( int socket, struct sockaddr *address, size_t *address_len ); PARAMETERS socket Specifies the open file descriptor of the socket. address Points to a sockaddr structure, where the address of the peer socket is returned.
getpeername(2) OSS System Calls Reference Manual • The connection was forcibly closed by the peer socket. The socket can only be closed. [EFAULT] A user-supplied memory buffer cannot be accessed or written. [EINVAL] The socket has been shut down. [ENOBUFS] There were not enough system resources available to complete the call. A retry at a later time might succeed. [ENOMEM] Required memory resources were not available. A retry at a later time might succeed.
System Functions (f - i) getpgid(2) NAME getpgid - Gets the process group ID for a specified OSS process LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include pid_t getpgid( pid_t pid); PARAMETERS pid Specifies the process ID of the target process. If the specified value is 0 (zero), the target process is the calling process.
getpgrp(2) OSS System Calls Reference Manual NAME getpgrp - Gets the process group ID of the calling process LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ pid_t getpgrp(void); DESCRIPTION The getpgrp( ) function returns the process group ID of the calling process. Use From the Guardian Environment Calls to getpgrp( ) from Guardian processes are not successful.
System Functions (f - i) getpid(2) NAME getpid - Gets the OSS process ID LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ pid_t getpid(void); DESCRIPTION The getpid( ) function returns the OSS process ID of the calling process. Use From the Guardian Environment Calls to getpid( ) from Guardian processes are not successful.
getppid(2) OSS System Calls Reference Manual NAME getppid - Gets the parent OSS process ID LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ pid_t getppid(void); DESCRIPTION The getppid( ) function returns the parent OSS process ID of the calling process.
System Functions (f - i) getpriority(2) NAME getpriority - Gets the OSS process scheduling priority LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include int getpriority( int which, id_t who); PARAMETERS which Specifies the symbolic value for the source of the nice value to be returned. The following symbolic values defined in the sys/resource.
getpriority(2) OSS System Calls Reference Manual [ENOTOSS] The calling process is not an OSS process. The requested operation is not supported from the Guardian environment. [ESRCH] No process was located using the which and who parameter values specified. RELATED INFORMATION Functions: nice(2). STANDARDS CONFORMANCE The following is an HP extension to the XPG4 Version 2 specification: • 3−96 The function can return the errno value [ENOTOSS].
System Functions (f - i) getprotobyname_r(2) NAME getprotobyname_r - Gets a protocol entry by name (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include struct protoent *getprotobyname_r ( const char *name, struct protoent *ret, char *buffer, int buflen ); PARAMETERS name Specifies the protocol name or alias. ret Points to a protoent structure allocated by the caller.
getprotobyname_r(2) OSS System Calls Reference Manual RELATED INFORMATION Functions: getprotobyname(3), getprotobynumber(3), getprotobynumber_r(2), getprotoent(3), getprotoent_r(2), setprotoent(3), endprotoent(3). Files: protocols(4). STANDARDS CONFORMANCE This function is an extension to the UNIX98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.
System Functions (f - i) getprotobynumber_r(2) NAME getprotobynumber_r - Gets a protocol entry by number (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include struct protoent *getprotobynumber_r ( int num, struct protoent *ret, char *buffer, int buflen ); PARAMETERS num Specifies the protocol number. ret Points to a protoent structure allocated by the caller.
getprotobynumber_r(2) OSS System Calls Reference Manual RELATED INFORMATION Functions: getprotobyname(3), getprotobyname_r(2), getprotobynumber(3), getprotoent(3), getprotoent_r(2), setprotoent(3), endprotoent(3). Files: protocols(4). STANDARDS CONFORMANCE This function is an extension to the UNIX98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.
System Functions (f - i) getprotoent_r(2) NAME getprotoent_r - Gets the next protocol entry (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include struct protoent *getprotoent_r ( struct protoent *ret, char *buffer, int buflen ); PARAMETERS ret Points to a protoent structure allocated by the caller.
getprotoent_r(2) OSS System Calls Reference Manual STANDARDS CONFORMANCE This function is an extension to the UNIX98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
System Functions (f - i) getpwent_r(2) NAME getpwent_r - Gets user attribute information from the user database (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include struct passwd *getpwent_r ( struct passwd *ret, char *buffer, size_t buflen ); PARAMETERS ret Points to a passwd structure allocated by the caller.
getpwent_r(2) OSS System Calls Reference Manual pw_shell The initial program for the user. The pw_passwd, pw_age, pw_comment, and pw_gecos fields are provided for compatibility with some versions of UNIX, but these fields always contain null strings. Database Structure and Access Traditional UNIX implementations access user and group information by sequentially reading unstructured files. In contrast, an HP NonStop server stores user and group information in structured, key-sequenced, Enscribe files.
System Functions (f - i) getpwnam_r(2) NAME getpwnam_r - Gets user attribute information from the user database (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] [#include ] #include
getpwnam_r(2) OSS System Calls Reference Manual pw_gid The group ID of the primary group of the user. pw_age The password aging string (not returned). pw_comment Comment string (not returned). pw_gecos Personal information about the user (not returned). pw_dir The home directory of the user. pw_shell The initial program for the user. The pw_passwd, pw_age, pw_comment, and pw_gecos fields are provided for compatibility with some versions of UNIX, but these fields always contain null strings.
System Functions (f - i) [ERANGE] getpwnam_r(2) Insufficient storage was supplied via buffer and buflen to contain the data to be referenced by the resulting passwd structure. RELATED INFORMATION Functions: endpwent(3), getpwent(3), getpwent_r(2), getpwent(3), getpwnam(3), getpwuid(3), getpwuid_r(2), setpwent(3). STANDARDS CONFORMANCE This function is an extension to the UNIX98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.
getpwuid_r(2) OSS System Calls Reference Manual NAME getpwuid_r - Gets user attribute information from the user database (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] [#include ] #include
System Functions (f - i) getpwuid_r(2) pw_uid The user ID of the user. pw_gid The group ID of the primary group of the user. pw_age The password aging string (not returned). pw_comment Comment string (not returned). pw_gecos Personal information about the user (not returned). pw_dir The home directory of the user. pw_shell The initial program for the user.
getpwuid_r(2) OSS System Calls Reference Manual RELATED INFORMATION Functions: endpwent(3), getpwent(3), getpwent_r(2), getpwnam(3), getpwnam_r(2), getpwuid(3), setpwent(3). STANDARDS CONFORMANCE This function is an extension to the UNIX98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
System Functions (f - i) getservbyname_r(2) NAME getservbyname_r - Gets a network service entry by name (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include struct servent *getservbyname_r ( const char *name, const char *proto, struct servent *ret, char *buffer, int buflen ); PARAMETERS name Specifies the service name or the service alias name.
getservbyname_r(2) OSS System Calls Reference Manual FILES /etc/services This is the Internet network service-name database. RELATED INFORMATION Functions: getservbyname(3), getservbyport(3), getservbyport_r(2), getservent(3), getservent_r(2), setservent(3), endservent(3). Files: services(4). STANDARDS CONFORMANCE This function is an extension to the UNIX98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.
System Functions (f - i) getservbyport_r(2) NAME getservbyport_r - Gets a network service entry by port number (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include struct servent *getservbyport_r ( int port, const char *proto, struct servent *ret, char *buffer, int buflen ); PARAMETERS port Specifies the port number for the service, in network-byte order.
getservbyport_r(2) OSS System Calls Reference Manual FILES /etc/services The Internet network service name database file. RELATED INFORMATION Functions: getservbyname(3), getservebyname_r(2), getservbyport(3), getservent(3), getservent_r(2), setservent(3), endservent(3). Files: services(4). STANDARDS CONFORMANCE This function is an extension to the UNIX98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.
System Functions (f - i) getservent_r(2) NAME getservent_r - Gets the next entry from the network services database (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include struct servent *getservent_r ( struct servent *ret, char *buffer, int buflen ); PARAMETERS ret Points to a servent structure allocated by the caller.
getservent_r(2) OSS System Calls Reference Manual STANDARDS CONFORMANCE This function is an extension to the UNIX98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
System Functions (f - i) getsid(2) NAME getsid - Gets the process group ID of the session leader LIBRARY G-series native OSS processes: system library SYNOPSIS #include pid_t getsid( pid_t pid); PARAMETERS pid Specifies the OSS process ID of the target process. If the value specified is pid_t(0) (an OSS process ID of zero), the function uses the OSS process ID of the calling process.
getsockname(2) OSS System Calls Reference Manual NAME getsockname - Gets the locally bound name of a socket LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int getsockname( int socket, struct sockaddr *address, size_t *address_len ); PARAMETERS socket Specifies the file descriptor of the socket. address Points to a sockaddr structure, where the locally bound address of the specified socket is returned.
System Functions (f - i) getsockname(2) [ECONNRESET] One of the following conditions occurred: • The transport-provider process for this socket is no longer available. • The TCP/IP subsystem for this socket is no longer available. • The connection was forcibly closed by the peer socket. The socket can only be closed. [EFAULT] A user-supplied memory buffer cannot be accessed or written. [EINVAL] The socket has been shut down.
getsockopt(2) OSS System Calls Reference Manual NAME getsockopt - Gets socket options LIBRARY G-series native OSS processes: /G/system/sysnn/zinetsrl H-series OSS processes: /G/system/zdllnnn/zinetdll SYNOPSIS #include [#include ] Required for IP protocol level [#include
System Functions (f - i) getsockopt(2) • -1 to indicate that the default value should be used. IPV6_MULTICAST_LOOP Indicates that the host belongs to the multicast group that it is sending to, and a copy of the datagram should be sent by loopback to the originating host. IPV6_UNICAST_HOPS Indicates the hop limit for outbound unicast UDP datagrams. The limit is an int that is either: • Between 0 and 255 to indicate the maximum number of hops allowed.
getsockopt(2) OSS System Calls Reference Manual SO_BROADCAST Reports whether transmission of broadcast messages is supported. This option returns an int value in the buffer pointed to by the option_value parameter. SO_DEBUG Reports whether debugging information is being recorded. This option returns an int value in the buffer pointed to by the option_value parameter.
System Functions (f - i) getsockopt(2) SO_SNDBUF Reports the send buffer size in bytes. This option returns an int value in the buffer pointed to by the option_value parameter. SO_TYPE Reports the socket type in a form that can be tested against a symbolic value such as SOCK_DGRAM or SOCK_STREAM. This option returns an int value in the buffer pointed to by the option_value parameter.
getsockopt(2) OSS System Calls Reference Manual DESCRIPTION The getsockopt( ) function allows an application program to query socket options. The calling program specifies the file descriptor, the option, and a place to store the requested information. The operating system gets the socket option information from its internal data structures and passes the requested information back to the calling program.
System Functions (f - i) getsockopt(2) STANDARDS CONFORMANCE The HP implementation does not: • Implement the SO_LINGER option for AF_UNIX sockets. • Return the errno value [ENOSR]. The following are HP extensions to the XPG4 specification: 527186-007 • The errno value [ECONNRESET] can be returned when the transport provider process is unavailable. • The SO_REUSEPORT option is supported.
gettimeofday(2) OSS System Calls Reference Manual NAME gettimeofday - Gets date and time LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include int gettimeofday( struct timeval *tp, struct timezone *tzp); PARAMETERS tp Points to a timeval structure, defined in the sys/time.h file. The timeval structure contains the current time when the call is completed.
System Functions (f - i) gettimeofday(2) ERRORS If any of the following conditions occurs, the gettimeofday( ) function sets errno to the corresponding value: [EFAULT] A parameter points to an invalid address. [ENOTOSS] The calling process is not an OSS process. The requested operation is not supported from the Guardian environment. RELATED INFORMATION Functions: ctime(3), strftime(3). Commands: date(1).
getuid(2) OSS System Calls Reference Manual NAME getuid - Gets the the real user ID of the current process LIBRARY G-series native OSS processes: /G/system/sysnn/zsecsrl H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include #include /* optional except for POSIX.1 */ uid_t getuid(void); DESCRIPTION The getuid( ) function returns the real user ID of the current process.
System Functions (f - i) gmtime_r(2) NAME gmtime_r - Converts time since the Epoch to broken-down Coordinated Universal Time (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include struct tm *gmtime_r ( const time_t *timer, struct tm *result ); PARAMETERS timer Points to a variable that specifies a time value in seconds.
gmtime_r(2) OSS System Calls Reference Manual ERRORS No error values are returned. This function does not set the errno variable. RELATED INFORMATION Functions: asctime(3), asctime_r(2), ctime(3), ctime_r(2), difftime(3), getenv(3), localtime(3), localtime(2), mktime(3), strftime(3), time(3), tzset(3), utime(3). STANDARDS CONFORMANCE This function is an extension to the UNIX98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.
System Functions (f - i) ioctl(2) NAME ioctl - Controls device files LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include int ioctl( int filedes, int request, / * arg */ . . . ); The ellipsis (. . .) indicates that the function is variable. PARAMETERS filedes Specifies the open file descriptor of the tty device or socket. request Specifies the function to be performed for the tty device or socket.
ioctl(2) OSS System Calls Reference Manual SIOCSIFADDR Sets the interface address. The data structure pointed to by arg is of type ifreq. Returns the error [EOPNOTSUPP]. SIOCSIFDSTADDR Sets the destination address on a point-to-point interface. The data structure pointed to by arg is of type ifreq. Returns the error [EOPNOTSUPP]. SIOCSIFFLAGS Sets the interface flags. The data structure pointed to by arg is of type ifreq. Returns the error [EOPNOTSUPP].
System Functions (f - i) ioctl(2) TIOCSWINSZ Causes the values stored in the winsize structure pointed to by arg to be sent to the Telserv window identified by the filedes parameter.
ioctl(2) OSS System Calls Reference Manual [ENOTSUP] The request parameter specifies an operation that is not supported on the device specified by the filedes parameter. [ENOTTY] The device parameter is not associated with a character-special device, or the specified request does not apply to the type of object that descriptor device references. [ENXIO] No such device or address exists. [EOPNOTSUPP] Operation not supported on socket.
Section 4. System Functions (k - m) This section contains reference pages for Open System Services (OSS) system function calls with names that begin with k through m. These reference pages reside in the cat2 directory and are sorted alphabetically by U.S. English conventions in this section.
kill(2) OSS System Calls Reference Manual NAME kill - Sends a signal to a process or group of processes LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ int kill( pid_t pid, int signal); PARAMETERS pid Specifies the process or group of processes to be sent a signal. signal Specifies the signal.
System Functions (k - m) kill(2) The POSIX.1 standard leaves unspecified the set of system processes that does not receive a signal when the kill( ) function is called with pid equal to 0, -1, or a negative number less than -1. Applications in the HP implementation should therefore not depend on which system processes receive signals. Safeguard Considerations HP recommends that users not use Safeguard protection on OSS processes.
kill(2) OSS System Calls Reference Manual RETURN VALUES Upon successful completion, the kill( ) function returns the value 0 (zero). Otherwise, the value -1 is returned, errno is set to indicate the error, and no signal is sent. ERRORS If any of the following conditions occurs, the kill( ) function sets errno to the corresponding value: [EINVAL] The value in the signal parameter is an invalid or unsupported signal number. [ENOTOSS] The calling process was not an OSS process.
System Functions (k - m) lchmod(2) NAME lchmod - Changes file-access permissions LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ int lchmod( const char *path, mode_t mode); PARAMETERS path Specifies the full pathname of the file.
lchmod(2) OSS System Calls Reference Manual S_ISGID Sets the process’s effective group ID to the group ID of the file’s group on execution. S_ISVTX For a directory, permits modification to the directory only if the effective user ID of the process matches that of the file being accessed. S_IRWXU Permits the file’s owner to read, write, and execute the file (or to search the directory). S_IRUSR Permits the file’s owner to read the file. S_IWUSR Permits the file’s owner to write to the file.
System Functions (k - m) lchmod(2) Access Control Lists (ACLs) When you execute the lchmod( ) function, you can change the effective permissions granted by optional entries in the ACL for a file.
lchmod(2) OSS System Calls Reference Manual [EIO] An input or output error occurred. The device holding the file might be in the down state, or both processors that provide access to the device might have failed. [ELOOP] Too many symbolic links were encountered in translating the path parameter.
System Functions (k - m) lchmod(2) STANDARDS CONFORMANCE This function is an HP extension to the XPG4 Version 2 specification.
lchown(2) OSS System Calls Reference Manual NAME lchown - Changes the owner and group IDs of a file LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.
System Functions (k - m) lchown(2) If the owner or group parameter is specified as -1 cast to the type of uid_t or gid_t, respectively, the corresponding ID of the file is unchanged. To change only one attribute, specify the other as -1. Upon successful completion, the lchown( ) function marks the st_ctime field of the file for update. Access Control Lists (ACLs) A user can allow or deny specific individuals and groups access to a file by using an ACL on the file.
lchown(2) OSS System Calls Reference Manual ERRORS If any of these conditions occur, the lchown( ) function sets errno to the corresponding value: [EACCES] Search permission is denied on a component of the path parameter. [EFAULT] The path parameter is an invalid address. [EFSBAD] The fileset catalog for one of the filesets involved in the operation is corrupt. [EINVAL] The owner or group parameter is out of range. An attempt was made to change ownership of a Guardian file that is not a disk file.
System Functions (k - m) lchown(2) [ENOTDIR] A component of path is not a directory. [ENXIO] The fileset containing the client’s current working directory or root directory is not mounted. [EOSSNOTRUNNING] The program attempted an operation on an object in the OSS environment while a required system process was not running. [EPERM] The calling process does not have appropriate privileges. [EROFS] The named file resides on a read-only fileset.
lgamma_r(2) OSS System Calls Reference Manual NAME lgamma_r - Computes the logarithm of the gamma function (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include double lgamma_r ( double x, int *signgamp ); extern int signgam; PARAMETERS x Specifies a positive double value. signgamp Points to the sign of the lgamma_r( ) function.
System Functions (k - m) lgamma_r(2) If the correct value would cause overflow, HUGE_VAL is returned. If the correct value would cause underflow, 0.0 (zero) is returned. ERRORS If this condition occurs, the lgamma_r( ) function sets errno to the corresponding value: [EDOM] The value of x is 0.0 (zero), negative infinity, or a nonpositive integer. RELATED INFORMATION Functions: exp(3), fp_class(3), gamma(3), gamma_r(2), isnan(3), lgamma(2).
link(2) OSS System Calls Reference Manual NAME link - Creates an additional directory entry for an existing file on the current fileset LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int link( const char *path1, const char *path2); PARAMETERS path1 Points to the pathname of an existing file. If any component of the path1 parameter refers to a symbolic link, the link is traversed and pathname resolution continues.
System Functions (k - m) link(2) Use From the Guardian Environment The link( ) function is one of a set of functions that have the following effects when the first of them is called from the Guardian environment: • Two Guardian file system file numbers (not necessarily the next two available) are allocated for the root directory and the current working directory. These file numbers cannot be closed by calling the Guardian FILE_CLOSE_ procedure.
link(2) OSS System Calls Reference Manual • A component of the pathname pointed to by the path1 parameter • A component of the pathname pointed to by the path2 parameter • The intermediate result of pathname resolution when a symbolic link is part of the path1 or path2 parameter The pathconf( ) function can be called to obtain the applicable limits. [ENOENT] [ENOROOT] One of the following is true: • The file specified by the path1 parameter does not exist.
System Functions (k - m) link(2) RELATED INFORMATION Commands: ln(1). Functions: unlink(2). STANDARDS CONFORMANCE The POSIX standards leave some features to the implementing vendor to define. The following features are affected in the HP implementation: • The link( ) function is not supported between filesets. • The link( ) function is not supported for directories.
listen(2) OSS System Calls Reference Manual NAME listen - Listens for socket connections and limits the backlog of incoming connections LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int listen( int socket, int backlog ); PARAMETERS socket Specifies the file descriptor for the socket. backlog Specifies the maximum number of outstanding connections.
System Functions (k - m) listen(2) [EDESTADDRREQ] The socket is not bound to a local address, and the protocol does not support listening on an unbound socket. [EINVAL] One of the following conditions occurred: • The socket is already connected. • The socket has been shut down. [ENOBUFS] There was not enough buffer space available to complete the call. A retry at a later time may succeed. [ENOMEM] Required memory resources were not available. A retry at a later time may succeed.
localtime_r(2) OSS System Calls Reference Manual NAME localtime_r - Converts time since the Epoch to broken-down local time (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include struct tm *localtime_r ( const time_t *timer, struct tm *result ); PARAMETERS timer Points to a variable that specifies a time value in seconds.
System Functions (k - m) localtime_r(2) RELATED INFORMATION Functions: asctime(3), asctime_r(2), ctime(3), ctime_r(2), difftime(3), getenv(3), gmtime(3), gmtime_r(2), mktime(3), strftime(3), time(3), tzset(3), utime(3). STANDARDS CONFORMANCE This function is an extension to the UNIX98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.
lseek(2) OSS System Calls Reference Manual NAME lseek - Sets file offset for read or write operation LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.
System Functions (k - m) [EINVAL] [EISDIR] lseek(2) One of these conditions exists: • The whence parameter is an invalid value, or the resulting file offset would be an invalid value (that is, a value less than 0 [zero]). • The filedes parameter refers to a file (other than a pipe, FIFO, or directory) on which seeking cannot be performed. The filedes parameter refers to an OSS directory. [EISGUARDIAN] The value used for the filedes parameter is appropriate only in the Guardian environment.
lseek(2) OSS System Calls Reference Manual HP extensions to the XPG4 Version 2 specification are: • 4−26 The errno values [EINVAL], [EISDIR], [EISGUARDIAN], and [EWRONGID] can be returned.
System Functions (k - m) lseek64(2) NAME lseek64 - Sets file offset for read or write operation LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.
lseek64(2) OSS System Calls Reference Manual If the lseek64( ) function fails, the file offset remains unchanged, the value -1 cast to the type off_t is returned, and errno is set to indicate the error. ERRORS If any of these conditions occurs, the file offset remains unchanged, and the lseek64( ) function sets errno to the corresponding value: [EBADF] The filedes parameter is not an open file descriptor.
System Functions (k - m) lstat(2) NAME lstat - Provides information about a symbolic link or any file LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include int lstat( const char *path, struct stat *buffer); PARAMETERS path Points to the pathname of a file.
lstat(2) OSS System Calls Reference Manual For symbolic links to local OSS objects, the st_mode and st_size fields are valid and the other fields in the structure are undefined. For symbolic links that resolve to files in /E, the st_dev, st_ino, st_atime, st_mtime, and st_ctime fields are defined as described in this reference page.
System Functions (k - m) st_mode lstat(2) File mode. The following bits are ORed into the st_mode field: S_IFMT File type. This field can contain one of the following values: S_IFCHR Character special file. S_IFDIR Directory. S_IFIFO FIFO. S_IFREG Regular file. S_IFSOCK Socket. For an AF_UNIX socket, the user permissions from the inode for the socket are returned for the permission bits. The access flags are also returned from the inode.
lstat(2) OSS System Calls Reference Manual st_gid For Contains Regular file Directory FIFO AF_UNIX socket /dev/null /dev/tty User ID of the file owner User ID of the file owner User ID of the file owner User ID of the creator of the socket file User ID of the super ID User ID of the super ID Group ID. Values for OSS objects are listed in the following table. Values for Guardian objects are described in Use on Guardian Objects, later in this reference page.
System Functions (k - m) st_atime lstat(2) For Contains Regular file Directory FIFO AF_UNIX socket /dev/null /dev/tty Size of the file in bytes 4096 0 (zero) 0 (zero) 0 (zero) 0 (zero) Access time. Values for OSS objects are listed in the following table. Values for Guardian objects are described in Use on Guardian Objects, later in this reference page.
lstat(2) OSS System Calls Reference Manual For Contains Regular file Directory FIFO AF_UNIX socket /dev/null /dev/tty Time of the last file status change Time of the last file status change Time of the last file status change Value retrieved from the inode Current time Composite value of the times of all openers of the file For the /E entry of the local node, the value is the time of the most recent mounting of the root fileset.
System Functions (k - m) lstat(2) Guardian st_mode Example in /G File Type File Type Permissions ___________________________________________________________________ /G vol vol/subvol vol/subvol/fileid vol/#123 ztnt ztnt/#pty0001 vol1/zyq00001 N/A Disk volume Subvolume Disk file Temporary disk file Subtype 30 process Subtype 30 process with qualifier Subvolume Directory Directory Directory Regular file Regular file Directory Character special r-xr-xr-x rwxrwxrwx rwxrwxrwx See following text See followin
lstat(2) OSS System Calls Reference Manual • The current working directory is assigned from the VOLUME attribute of the Guardian environment =_DEFAULTS DEFINE. • The use of static memory by the process increases slightly. These effects occur only when the first of the set of functions is called. The effects are not cumulative. NOTES The OSS Network File System (NFS) cannot access files that have optional ACL entries. RETURN VALUES Upon successful completion, the value 0 (zero) is returned.
System Functions (k - m) lstat(2) [ENOROOT] The program attempted an operation while the root fileset was unavailable. [ENOTDIR] A component of the pathname specified by the path parameter is not a directory. [ENOTSUP] The path parameter refers to a file on a logical disk volume administered through the Storage Management Foundation (SMF). [ENXIO] An invalid device or address was specified during an input or output operation on a special file.
lstat64(2) OSS System Calls Reference Manual NAME lstat64 - Provides information about a symbolic link or any file LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include int lstat64( const char *path, struct stat64 *buffer); PARAMETERS path Points to the pathname of a file.
System Functions (k - m) lstat64(2) The file information is written to the area specified by the buffer parameter, which is a pointer to a stat64 structure with the following definition from the sys/stat.
lstat64(2) OSS System Calls Reference Manual For Contains Regular file Directory FIFO AF_UNIX socket ID of device containing directory entry ID of device containing directory ID of special fileset for pipes ID of device containing the fileset in which the socket file was created ID of device containing directory entry ID of device containing directory entry /dev/null /dev/tty st_ino File serial number (inode number).
System Functions (k - m) lstat64(2) inode. S_IRWXG Permissions for the owning group, or if the st_acl flag is set, permissions for the the class ACL entry. S_IRWXO Other class S_IRWXU Owner class S_ISGID Set group ID on execution S_ISUID Set user ID on execution S_ISVTX Sticky bit; used only for directories (not ORed for files in /G, the Guardian file system) | | Values for Guardian objects are described in Use on Guardian Objects, later in this reference page. st_nlink Number of links.
lstat64(2) OSS System Calls Reference Manual st_gid For Contains Regular file Directory FIFO AF_UNIX socket /dev/null /dev/tty User ID of the file owner User ID of the file owner User ID of the file owner User ID of the creator of the socket file User ID of the super ID User ID of the super ID Group ID. Values for OSS objects are listed in the following table. Values for Guardian objects are described in Use on Guardian Objects, later in this reference page.
System Functions (k - m) st_atime lstat64(2) For Contains Regular file Directory FIFO AF_UNIX socket /dev/null /dev/tty Size of the file in bytes 4096 0 (zero) 0 (zero) 0 (zero) 0 (zero) Access time. Values for OSS objects are listed in the following table. Values for Guardian objects are described in Use on Guardian Objects, later in this reference page.
lstat64(2) OSS System Calls Reference Manual For Contains Regular file Directory FIFO AF_UNIX socket /dev/null /dev/tty Time of the last file status change Time of the last file status change Time of the last file status change Value retrieved from the inode Current time Composite value of the times of all openers of the file For the /E entry of the local node, the value is the time of the most recent mounting of the root fileset.
System Functions (k - m) lstat64(2) Guardian st_mode Example in /G File Type File Type Permissions ___________________________________________________________________ /G vol vol/subvol vol/subvol/fileid vol/#123 ztnt ztnt/#pty0001 vol1/zyq00001 N/A Disk volume Subvolume Disk file Temporary disk file Subtype 30 process Subtype 30 process with qualifier Subvolume Directory Directory Directory Regular file Regular file Directory Character special r-xr-xr-x rwxrwxrwx rwxrwxrwx See following text See follow
lstat64(2) OSS System Calls Reference Manual Use From the Guardian Environment A Guardian process can use thee lstat( ) function when you use the #define _XOPEN_SOURCE_EXTENDED 1 feature test macro or an equivalent compiler command option to compile the process.
System Functions (k - m) lstat64(2) • The intermediate result of pathname resolution when a symbolic link is part of the path parameter You can call the pathconf( ) function to obtain the applicable limits. [ENOENT] One of the following conditions exists: • The file specified by the path parameter does not exist. • path points to an empty string. • The specified pathname cannot be mapped to a valid Guardian filename.
lstat64(2) OSS System Calls Reference Manual STANDARDS CONFORMANCE This function is an HP extension to the XPG4 Version 2 specification.
System Functions (k - m) mkdir(2) NAME mkdir - Creates a directory LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ int mkdir( const char *path, mode_t mode); PARAMETERS path Points to the pathname for the new directory.
mkdir(2) OSS System Calls Reference Manual permission bits ("rwxrwxrwx") are automatically set. • The new directory is empty except for . (dot) and . . (dot-dot). To execute the mkdir( ) function, a process must have search permission for the parent directory of the directory pointed to by the path parameter and write permission in the parent directory of the path directory. The mkdir( ) function cannot create a directory named /dev, /dev/tty, or /dev/null in the root directory of the OSS file system.
System Functions (k - m) mkdir(2) RETURN VALUES Upon successful completion, the mkdir( ) function returns the value 0 (zero). If the function call fails, the value -1 is returned and errno is set to indicate the error.
mkdir(2) OSS System Calls Reference Manual • The specified file is on a remote HP NonStop node and communication with the remote name server has been lost. [ENOSPC] The fileset does not contain enough space to hold the contents of the new directory or to extend the parent directory of the new directory. [ENOTDIR] A component of the pathname prefix is not a directory. [ENXIO] The fileset containing the client’s current working directory or root directory is not mounted.
System Functions (k - m) mknod(2) NAME mknod - Creates a file or assigns a pathname to a character special file LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include int mknod( const char *path, mode_t mode, dev_t device); PARAMETERS path Specifies the pathname of the new file.
mknod(2) OSS System Calls Reference Manual device S_ISGID Set the group ID of the file upon execution of the file S_ISUID Set the user ID of the file upon execution of the file S_ISVTX Restrict the deletion of files in a directory (ignored for other file types) S_IWGRP Write access by members of the group list S_IWOTH Write access by others S_IWUSR Write access by the owner of the file S_IXGRP Execute (search) access by members of the group list S_IXOTH Execute (search) access by others S
System Functions (k - m) • mknod(2) Access permission and attribute bits set according to the value of the mode parameter, modified as described in "ACL Inheritance" in the acl(5) reference page. Upon successful completion of the function call, the st_atime, st_ctime, and st_mtime fields of the file are marked for update. The st_ctime and st_mtime fields of the directory that contains the new entry are also marked for update.
mknod(2) OSS System Calls Reference Manual RETURN VALUES Upon successful completion, the value 0 (zero) is returned. Otherwise, the value -1 is returned and errno is set to indicate the error. ERRORS If any of the following conditions occurs, the new file is not created and the mknod( ) function sets errno to the corresponding value: [EACCES] A component of the pathname prefix denies search permission, or write permission is denied on the parent directory of the file to be created.
System Functions (k - m) mknod(2) • The path parameter includes a symbolic link, but the file to which it refers does not exist. • The path parameter specifies a file on a remote HP NonStop node but communication with the remote node has been lost. [ENOROOT] The root fileset (fileset 0) is not in the STARTED state. [ENOSPC] The directory that would contain the new file cannot be extended, or the fileset is out of resources. [ENOTDIR] A component of the pathname prefix is not a directory.
msgctl(2) OSS System Calls Reference Manual NAME msgctl - Performs message control operations LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include int msgctl( int msqid, int cmd, struct msqid_ds *buf); PARAMETERS msqid Specifies the message queue identifier. cmd Specifies the type of operation.
System Functions (k - m) msgctl(2) IPC_STAT buf Queries the message queue identifier by copying the contents of its associated msqid_ds data structure into the structure specified by the buf parameter. Specifies the address of a msqid_ds structure. This structure is used only with the IPC_STAT and IPC_SET values of the cmd parameter. With IPC_STAT, the results of the query are copied to this structure.
msgctl(2) OSS System Calls Reference Manual • All processes for the relevant message server have failed. • The message queue corresponding to the value specified as the msqid parameter has been removed from the system. [EMSGQNOTRUNNING] The message queue server associated with the message queue identifier is not running. [ENOTOSS] The calling process is not an OSS process. The requested operation is not supported from the Guardian environment.
System Functions (k - m) msgget(2) NAME msgget - Creates or returns the identifier for a message queue LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include int msgget( key_t key, int msgflg); PARAMETERS key Specifies the key that identifies the message queue. The IPC_PRIVATE key can be used to ensure the return of a new (unused) message queue identifier.
msgget(2) OSS System Calls Reference Manual • The msg_ctime field is set to the current time. This field is updated when any of the following events occur: — The message queue identifier is created. — The message queue identifier is removed. • The msg_qbytes field is set to the system limit. The message queue identifier is used for the following purposes: • It identifies a specific message server. • It allows detection of references to a previously removed message queue.
System Functions (k - m) msgget(2) ERRORS If any of the following conditions occurs, the msgget( ) function sets errno to the value that corresponds to the condition. [EACCES] A message queue identifier exists for the key parameter but operation permission, which is specified by the low-order nine bits of the msgflg parameter, is not granted. [EEXIST] A message queue identifier exists for the key parameter, and both IPC_CREAT and IPC_EXCL are set.
msgrcv(2) OSS System Calls Reference Manual NAME msgrcv - Receives a message from a message queue LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include int msgrcv( int msqid, void *msgp, size_t msgsz, long int msgtyp, int msgflg); PARAMETERS msqid Specifies the identifier of the message queue from which to read a message. msgp Specifies a pointer to the msgbuf structure that is to receive the message.
System Functions (k - m) msgrcv(2) < 0 (negative) The process receives the first message of the lowest type on the queue. To qualify as the lowest type, a message’s type must be less than or equal to the absolute value of the msgtyp parameter. The msgflg parameter specifies the action that the system should take if the queue does not contain a message of the requested type.
msgrcv(2) OSS System Calls Reference Manual ERRORS If any of the following conditions occurs, the msgrcv( ) function sets errno to the value that corresponds to the condition. [E2BIG] The number of bytes to be received in the mtext field is greater than the value of the msgsz parameter and the MSG_NOERROR flag is used in the msgflg parameter. [EACCES] The calling process does not have read permission for the specified message queue.
System Functions (k - m) msgsnd(2) NAME msgsnd - Sends a message to a message queue LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include int msgsnd( int msqid, const void *msgp, size_t msgsz, int msgflg); PARAMETERS msqid Specifies the identifier of the message queue in which to place the message. The identifier is typically returned by a previous call to the msgget( ) function.
msgsnd(2) OSS System Calls Reference Manual — The process catches a signal. In this case, the message is not sent and the process resumes execution as directed by a sigaction( ) function call. If the msgsnd( ) function finishes successfully, the system updates the msqid_ds structure associated with the msqid parameter. Specifically, it does the following: • Increments the value in the msg_qnum field by 1. • Increments the value in the msg_cbytes field by the message text size.
System Functions (k - m) [EINVAL] msgsnd(2) One of the following conditions is true: • The msqid parameter does not specify a valid message queue identifier. • The value of the mtype field is less than 1. • The value of the msgsz parameter is less than 0 (zero) or greater than the system-defined limit. • All processes for the relevant message server have failed. [EMSGQNOTRUNNING] The message queue server associated with the message queue identifier is not running.
Section 5. System Functions (n - p) This section contains reference pages for Open System Services (OSS) system function calls with names that begin with n through p. These reference pages reside in the cat2 directory and are sorted alphabetically by U.S. English conventions in this section.
nice(2) OSS System Calls Reference Manual NAME nice - Changes the scheduling priority of the calling process LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include int nice( int increment); PARAMETERS increment Specifies a value that is added to the current nice value of the calling process.
System Functions (n - p) nice(2) If the sum of the old nice value and the increment is • less than 0 (zero), then the new nice value is 0 (zero). • greater than 39, then the new nice value is 39 because the current value of 2*NZERO -1 is 39. Refer to NOTES for a description of the relative priorities of Guardian and OSS processes. Use From the Guardian Environment The nice( ) function can be used from the Guardian environment.
open(2) OSS System Calls Reference Manual NAME open - Opens a file for reading or writing; creates a regular file in the OSS environment LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include #include #include /* optional except for POSIX.1 */ /* optional except for POSIX.
System Functions (n - p) open(2) this process is running and on the fileset that contains the new directory. See "ACL Inheritance" in the acl(5) reference page. | The file type flags are described in DESCRIPTION.
open(2) OSS System Calls Reference Manual • The group ID of the file is determined by the value of the S_ISGID flag in the parent directory. If S_ISGID is set, the group ID of the file is set to the group ID of the parent directory; otherwise, the group ID of the file is set to the effective group ID of the calling process. If the file is a Guardian file (that is, within /G), the group ID is set to that of the primary group of the effective user ID.
System Functions (n - p) open(2) The file status flags that define the initial state of the open file are: O_APPEND Open the file only for append access. If set, the file pointer is set to the end of the file before each write. This flag is ignored for Telserv terminal devices. O_NONBLOCK Open the file for nonblocked access. If set, the call to open( ) does not block, and subsequent read( ) or write( ) operations on the file are nonblocking.
open(2) OSS System Calls Reference Manual • If the O_NONBLOCK flag is set, the open( ) function returns an error if no process currently has the file open for reading. The O_RDWR file access flag is supported when opening a FIFO file; the call to the open( ) function finishes immediately, even if the O_NONBLOCK flag is not set.
System Functions (n - p) open(2) You cannot use the open( ) function on any other type of Guardian object. An attempt to open: — A Format 2 file that is larger than approximately 2 gigabytes fails with errno set to [EOVERFLOW]. — A structured file fails with errno set, usually to [EINVAL]. — A file administered through the Storage Management Foundation (SMF) fails with errno set to [ENOTSUP]. — Any file or device of any other type not described here fails with errno set, usually to [EINVAL].
open(2) OSS System Calls Reference Manual • The current working directory is assigned from the VOLUME attribute of the Guardian environment =_DEFAULTS DEFINE. • The use of static memory by the process increases slightly. These effects occur only when the first of the set of functions is called. The effects are not cumulative. RETURN VALUES Upon successful completion, the function returns the file descriptor, a nonnegative integer.
System Functions (n - p) [EIO] open(2) • The function call specified the O_CREAT flag but did not specify the mode parameter. • The O_CREAT flag is set and bits other than the file permission and appropriate file type flags are set in the mode parameter. • Both the O_TRUNC flag and O_RDONLY flag are set. • None of the access flags O_RDONLY, O_WRONLY, or O_RDWR are set.
open(2) OSS System Calls Reference Manual • O_CREAT is set, and the pathname prefix does not exist. • The path parameter points to an empty string. • The function call attempted to open a file in the Guardian file system, but the specified pathname cannot be mapped to a valid Guardian filename. • The path parameter points to a file on a remote HP NonStop node, but communication with the remote node has been lost. [ENOMEM] The system has insufficient resources to allow another open file.
System Functions (n - p) open(2) [EROFS] The named file resides on a read-only fileset, and write access is required. [ETXTBSY] The file is being executed, and the oflag value is O_WRONLY or O_RDWR. For all other error conditions, errno is set to the appropriate Guardian file-system error number. For more information about a specific Guardian file-system error, see the Guardian Procedure Errors and Messages Manual. RELATED INFORMATION Commands: getacl(1), setacl(1).
open64(2) OSS System Calls Reference Manual NAME open64 - Opens a file for reading or writing; creates a regular file in the OSS environment LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include #include #include /* optional except for POSIX.1 */ /* optional except for POSIX.
System Functions (n - p) open64(2) The file type flags are described in DESCRIPTION.
open64(2) OSS System Calls Reference Manual File Status Flags The file status flags that specify special open processing are: O_CREAT Create and open the file. If the file exists, this flag has no effect except as noted under the O_EXCL flag. If the file does not exist, a regular file is created with these characteristics: • If access control lists (ACLs) are supported, ACL entries are added to the file ACL as described in "ACL Inheritance" in the acl(5) reference page.
System Functions (n - p) open64(2) The open fails if any of these conditions is true: • The file supports enforced record locks, and another process has locked a portion of the file. • The file does not allow write access. • The oflag parameter also specifies the O_RDONLY flag. If the oflag parameter also specifies the O_SYNC flag, the truncation is a synchronous update. A program can request some control over when updates should be made permanent for a regular file opened for write access.
open64(2) OSS System Calls Reference Manual The effect of setting the O_CREAT flag is immediate. When opening a file with the O_CREAT flag set: • If the named file does not already exist, a regular disk file is created. • If the named file is not a regular file, the O_CREAT flag is ignored. When opening a FIFO file with the O_RDONLY flag set: • If the O_NONBLOCK flag is not set, the open64( ) function blocks until another process opens the file for writing.
System Functions (n - p) open64(2) Opening Guardian Files If the file is a Guardian file (that is, if it is in the /G file system): • The file can be opened only if it is: — A file on a physical disk volume and either: — An odd, unstructured Enscribe file. In this case, it is opened as a regular file with a primary and secondary extent size that is a multiple of 2. If the extent size is odd, the open fails.
open64(2) OSS System Calls Reference Manual (CAID) of the calling process. During open64( ) processing, all access permissions are checked. This includes Guardian environment checks by Guardian standard security mechanisms (and by the Safeguard product) for Guardian disk file and process access.
System Functions (n - p) open64(2) • [EFSBAD] The function call attempted to open a Guardian EDIT file, but the corrupted flag is set in the file label. The fileset catalog for one of the filesets involved in the operation is corrupt. [EGUARDIANOPEN] The function call attempted to open a Guardian EDIT file for write access or for Guardian shared or exclusive exclusion access, but the file has already been opened with a Guardian procedure call. [EINTR] A signal was caught during the open operation.
open64(2) OSS System Calls Reference Manual [ENAMETOOLONG] One of these names is too long: • The pathname pointed to by the path parameter • A component of the pathname pointed to by the path parameter • The intermediate result of pathname resolution when a symbolic link is part of the path parameter You can call the pathconf( ) function to obtain the applicable limits. [ENFILE] The maximum allowable number of files are currently open in this node.
System Functions (n - p) open64(2) • The O_NONBLOCK flag is set, the named file is a FIFO file, the O_WRONLY flag is set, and no process has the file open for reading. • The fileset containing the client’s current working directory or root directory is not mounted. [EOPNOTSUPP] The named file is a socket bound to the file system (not an AF_INET or AF_INET6 socket) and cannot be opened. [EOSSNOTRUNNING] A required system process is not running.
open64(2) OSS System Calls Reference Manual • The O_TRUNC flag is ignored for files other than regular files. • Attempting to open an OSS directory with an access flag of O_WRONLY or O_RDWR fails. • Specifying the O_NONBLOCK flag when opening character special devices that support nonblocking opens is supported.
System Functions (n - p) pipe(2) NAME pipe - Creates an interprocess communication channel LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include int pipe( int filedes [2]); PARAMETERS filedes Specifies the address of an array of two integers into which new file descriptors are placed.
pipe(2) OSS System Calls Reference Manual [EMFILE] No more file descriptors are available for this process. [ENOMEM] The system has insufficient resources. [ENOROOT] The function was called while the root fileset (fileset 0) was not available. [EOSSNOTRUNNING] The function was called while a required system process was not running. For all other error conditions, errno is set to the appropriate Guardian file-system error number.
System Functions (n - p) pthread_atfork(2) NAME pthread_atfork - Declares fork-handler routines to be called when the calling thread’s process forks a child process LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
pthread_atfork(2) OSS System Calls Reference Manual EXAMPLES If your library uses a mutex my_mutex, you might provide pthread_atfork( ) handler routines coded as follows: void my_prepare(void) { pthread_mutex_lock(&my_mutex); } void my_parent(void) { pthread_mutex_unlock(&my_mutex); } void my_child(void) { pthread_mutex_unlock(&my_mutex); /* Reinitialize state that doesn’t apply...like heap owned */ /* by other threads */ } { . . . pthread_atfork(my_prepare, my_parent, my_child); . .
System Functions (n - p) pthread_attr_destroy(2) NAME pthread_attr_destroy - Destroys a thread attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/ZDLLnnn/zsptdll SYNOPSIS #include int pthread_attr_destroy( pthread_attr_t *attr ); PARAMETERS attr specifies the thread attributes object to be destroyed. DESCRIPTION This function destroys a thread attributes object.
pthread_attr_getdetachstate(2) OSS System Calls Reference Manual NAME pthread_attr_getdetachstate - Obtains the detachstate attribute of a thread attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_attr_getdetachstate( const pthread_attr_t *attr, int *detachstate ); PARAMETERS attr specifies the address of the thread attributes object whose detachstate attribute is obtained.
System Functions (n - p) pthread_attr_getguardsize_np(2) NAME pthread_attr_getguardsize_np - Obtains the guardsize attribute of a thread attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_attr_getguardsize_np( const pthread_attr_t *attr, size_t *guardsize ); PARAMETERS attr specifies the address of the thread attributes object whose guardsize attribute is obtained.
pthread_attr_getinheritsched(2) OSS System Calls Reference Manual NAME pthread_attr_getinheritsched - Obtains the inherit scheduling attribute of a thread attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
System Functions (n - p) pthread_attr_getschedparam(2) NAME pthread_attr_getschedparam - Obtains the scheduling parameters of the scheduling policy attribute of a thread attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
pthread_attr_getschedpolicy(2) OSS System Calls Reference Manual NAME pthread_attr_getschedpolicy - Obtains the scheduling policy attribute of a thread attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
System Functions (n - p) pthread_attr_getstackaddr(2) NAME pthread_attr_getstackaddr - Obtains the stackbase address attribute of the specified thread attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_attr_getstackaddr( const pthread_attr_t *attr, void **stackaddr ); PARAMETERS attr Specifies the address of the thread attributes object whose stack address attribute is obtained.
pthread_attr_getstacksize(2) OSS System Calls Reference Manual NAME pthread_attr_getstacksize - Obtains the stacksize attribute of a thread attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_attr_getstacksize( const pthread_attr_t *attr, size_t *stacksize ); PARAMETERS attr specifies the address of the thread attributes object whose stacksize attribute is obtained.
System Functions (n - p) pthread_attr_init(2) NAME pthread_attr_init - Initializes a thread attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_attr_init( pthread_attr_t *attr ); PARAMETERS attr specifies the address of the thread attributes object to be initialized.
pthread_attr_init(2) OSS System Calls Reference Manual RETURN VALUES If an error condition occurs, the thread attributes object cannot be used and this function returns an integer value indicating the type of error. Possible return values are: 0 Successful completion. [EINVAL] The value specified by the attr parameter is not a valid thread attributes object. [ENOMEM] Insufficient memory exists to initialize the thread attributes object.
System Functions (n - p) pthread_attr_setdetachstate(2) NAME pthread_attr_setdetachstate - Sets the detachstate attribute of a thread attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_attr_setdetachstate( pthread_attr_t *attr, int detachstate ); PARAMETERS attr specifies the thread attributes object whose detachstate attribute is to be set.
pthread_attr_setdetachstate(2) OSS System Calls Reference Manual RELATED INFORMATION Functions: pthread_attr_init(2), pthread_attr_getdetachstate(2), pthread_create(2), pthread_join(2). STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.
System Functions (n - p) pthread_attr_setguardsize_np(2) NAME pthread_attr_setguardsize_np - Sets the guardsize attribute of a thread attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_attr_setguardsize_np( pthread_attr_t *attr, size_t guardsize ); PARAMETERS attr specifies the address of the thread attributes object whose guardsize attribute is to be set.
pthread_attr_setguardsize_np(2) [EINVAL] OSS System Calls Reference Manual The value specified for the attr parameter or the guardsize parameter is invalid. RELATED INFORMATION Functions: pthread_attr_init(2), pthread_attr_getguardsize_np(2), pthread_attr_setstacksize(2), pthread_create(2). STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification and to the following industry standards: • 5−42 IEEE Std 1003.
System Functions (n - p) pthread_attr_setinheritsched(2) NAME pthread_attr_setinheritsched - Sets the inherit scheduling attribute of a thread attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_attr_setinheritsched( pthread_attr_t *attr, int inheritsched ); PARAMETERS attr specifies the address of the thread attributes object whose inherit scheduling attribute is to be set.
pthread_attr_setinheritsched(2) [ENOTSUP] OSS System Calls Reference Manual An attempt was made to set the attribute to an unsupported value. RELATED INFORMATION Functions: pthread_attr_init(2), *Lpthread_attr_getinheritsched(2), pthread_attr_setschedpolicy(2), pthread_attr_setschedparam(2), pthread_create(2). STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification.
System Functions (n - p) pthread_attr_setschedparam(2) NAME pthread_attr_setschedparam - Sets the scheduling parameters of the scheduling policy attribute of a thread attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
pthread_attr_setschedparam(2) OSS System Calls Reference Manual SCHED_FG_NP PRI_FG_MIN_NP to PRI_FG_MAX_NP SCHED_BG_NP PRI_BG_MIN_NP to PRI_BG_MAX_NP The default priority is 24. RETURN VALUES If an error condition occurs, this function returns an integer value indicating the type of error. Possible return values ares: 0 Successful completion. [EINVAL] The value specified by the attr parameter is not a valid thread attributes object or the value specified by param is invalid.
System Functions (n - p) pthread_attr_setschedpolicy(2) NAME pthread_attr_setschedpolicy - Sets the scheduling policy attribute of a thread attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_attr_setschedpolicy( pthread_attr_t *attr, int policy ); PARAMETERS attr specifies the address of the thread attributes object whose scheduling policy attribute is to be set.
pthread_attr_setstacksize(2) OSS System Calls Reference Manual NAME pthread_attr_setstacksize - Sets the stacksize attribute of a thread attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_attr_setstacksize( pthread_attr_t *attr, size_t stacksize ); PARAMETERS attr specifies the address of the thread attributes object whose stacksize attribute is to be set.
System Functions (n - p) pthread_cancel(2) NAME pthread_cancel - Requests that a thread terminate execution LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_cancel( pthread_t thread ); PARAMETERS thread specifies the thread that receives the cancelation request. DESCRIPTION This function sends a cancelation request to the specified target thread.
pthread_cancel(2) OSS System Calls Reference Manual RELATED INFORMATION Functions: pthread_cleanup_pop(2), pthread_cleanup_push(2), pthread_create(2), pthread_exit(2), pthread_join(2), pthread_setcancelstate(2), pthread_setcanceltype(2), pthread_testcancel(2). STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.
System Functions (n - p) pthread_cleanup_pop(2) NAME pthread_cleanup_pop - (Macro) Removes the cleanup-handler routine from the calling thread’s cleanup-handler stack and optionally executes it LIBRARY None. This application program interface is implemented as a macro. SYNOPSIS #include void pthread_cleanup_pop( int execute ); PARAMETERS execute controls whether the cleanup-handler routine specified in the matching call to pthread_cleanup_push( ) is executed.
pthread_cleanup_push(2) OSS System Calls Reference Manual NAME pthread_cleanup_push - (Macro) Establishes a cleanup-handler routine to be executed when the thread terminates LIBRARY None. This application program interface is implemented as a macro. SYNOPSIS #include void pthread_cleanup_push( void ( *routine ) ( void * ), void *arg ); PARAMETERS routine specifies the routine to be executed as the cleanup handler. arg specifies an argument to be passed to the cleanup routine.
System Functions (n - p) pthread_cond_broadcast(2) NAME pthread_cond_broadcast - Unblocks all threads that are waiting on the specified condition variable LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_cond_broadcast( pthread_cond_t *cond ); PARAMETERS cond specifies a condition variable upon which the threads (to be awakened) are waiting.
pthread_cond_destroy(2) OSS System Calls Reference Manual NAME pthread_cond_destroy - Destroys a condition variable LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_cond_destroy( pthread_cond_t *cond ); PARAMETERS cond specifies the condition variable to be destroyed. DESCRIPTION This function destroys the condition variable specified by the cond parameter.
System Functions (n - p) pthread_cond_init(2) NAME pthread_cond_init - Initializes a condition variable LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_cond_init( pthread_cond_t *cond, const pthread_condattr_t *attr ); PARAMETERS cond specifies the condition variable to be initialized.
pthread_cond_init(2) OSS System Calls Reference Manual [EBUSY] The implementation has detected an attempt to reinitialize the object indicated by cond, a previously initialized, but not yet destroyed, condition variable. [EINVAL] The value specified by the attr parameter is invalid. [ENOMEM] Insufficient memory exists to initialize the condition variable.
System Functions (n - p) pthread_cond_signal(2) NAME pthread_cond_signal - Unblocks at least one thread that is waiting on the specified condition variable LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/systemzdllsnnn/zsptdll SYNOPSIS #include int pthread_cond_signal( pthread_cond_t *cond ); PARAMETERS cond specifies the condition variable to be signaled.
pthread_cond_signal_int_np(2) OSS System Calls Reference Manual NAME pthread_cond_signal_int_np - Unblocks one thread that is waiting on the specified condition variable; callable only from an interrupt-handler routine LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_cond_signal_int_np( pthread_cond_t *cond ); PARAMETERS cond specifies the condition variable to be signaled.
System Functions (n - p) pthread_cond_timedwait(2) NAME pthread_cond_timedwait - Causes a thread to wait either for a condition variable to be signaled or broadcast, or for a specific expiration time LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
pthread_cond_timedwait(2) OSS System Calls Reference Manual RETURN VALUES If an error condition occurs, this function returns an integer value indicating the type of error. Possible return values are: 0 Successful completion. [EINVAL] One of the following conditions exists: [ENOMEM] • The value specified by cond, mutex, or abstime is invalid. • Different mutexes are supplied for concurrent pthread_cond_timedwait( ) operations or pthread_cond_wait( ) operations on the same condition variable.
System Functions (n - p) pthread_cond_wait(2) NAME pthread_cond_wait - Causes a thread to wait for the specified condition variable to be signaled or broadcast LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_cond_wait( pthread_cond_t *cond, pthread_mutex_t *mutex ); PARAMETERS cond specifies the condition variable that the calling thread waits on.
pthread_cond_wait(2) [EINVAL] [ENOMEM] OSS System Calls Reference Manual One of the following conditions exists: • The value specified by the cond or mutex parameter is invalid. • Different mutexes are supplied for concurrent pthread_cond_wait( ) operations or pthread_cond_timedwait( ) operations on the same condition variable. • The mutex was not owned by the calling thread at the time of the call.
System Functions (n - p) pthread_condattr_destroy(2) NAME pthread_condattr_destroy - Destroys a condition variable attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_condattr_destroy( pthread_condattr_t *attr ); PARAMETERS attr specifies the condition variable attributes object to be destroyed.
pthread_condattr_init(2) OSS System Calls Reference Manual NAME pthread_condattr_init - Initializes a condition variable attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_condattr_init( pthread_condattr_t *attr ); PARAMETERS attr specifies the condition variable attributes object to be initialized.
System Functions (n - p) pthread_condattr_init(2) The use of the header file spthread.h is an HP exception to the POSIX standard.
pthread_create(2) OSS System Calls Reference Manual NAME pthread_create - Creates a thread LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_create( pthread_t *thread, const pthread_attr_t *attr, void * ( *start_routine ) ( void * ), void *arg ); PARAMETERS thread specifies the location to receive the identifier for the thread being created.
System Functions (n - p) pthread_create(2) For the duration of the new thread’s existence, the system maintains and manages the thread object and other thread state overhead. The system assigns each new thread a thread identifier, which the system writes into the address specified by the thread parameter before the new thread executes. At thread creation, the scheduling policy and scheduling parameters stored in the thread attributes object passed to pthread_create( ) is used by default.
pthread_create(2) OSS System Calls Reference Manual • To exit a thread terminated by a call to pthread_exit( ), the system raises the pthread_exit_e exception. To exit a thread terminated by cancelation, the system raises the pthread_cancel_e exception. Your program can use the exception package to operate on the generated exception.
System Functions (n - p) pthread_delay_np(2) NAME pthread_delay_np - Delays execution of a thread LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_delay_np( const struct timespec *interval ); PARAMETERS interval specifies the number of seconds and nanoseconds to delay execution. The value specified for each must be greater than or equal to 0 (zero).
pthread_detach(2) OSS System Calls Reference Manual NAME pthread_detach - Marks a thread object for deletion LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/ZDLLnnn/zsptdll SYNOPSIS #include int pthread_detach( pthread_t thread ); PARAMETERS thread specifies the thread object being marked for deletion.
System Functions (n - p) pthread_equal(2) NAME pthread_equal - Compares two thread identifiers LIBRARY None. This routine has been implemented as a macro. SYNOPSIS #include int pthread_equal( pthread_t t1, pthread_t t2 ); PARAMETERS t1 specifies the first thread identifier to be compared. t2 specifies the second thread identifier to be compared. DESCRIPTION This function compares two thread identifiers.
pthread_exit(2) OSS System Calls Reference Manual NAME pthread_exit - Terminates the calling thread LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include void pthread_exit( void *value_ptr ); PARAMETERS value_ptr specifies the value to be copied and returned to the caller of the pthread_join( ) function. Note that void * is used as a universal datatype, not as a pointer.
System Functions (n - p) pthread_get_expiration_np(2) NAME pthread_get_expiration_np - Calculates an absolute expiration time LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/ZDLLnnn/zsptdll SYNOPSIS #include int pthread_get_expiration_np( const struct timespec *delta, struct timespec *abstime ); PARAMETERS delta specifies the number of seconds and nanoseconds to add to the current system time to determine an expiration time.
pthread_getattr_np(2) OSS System Calls Reference Manual NAME pthread_getattr_np - Gets the attribute object for a thread LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_getattr_np ( const pthread_t thread, pthread_attr_t **attr_p ); PARAMETERS thread Specifies the thread for which you want the attribute object. attr_p Receives the attribute object pointer returned by the call.
System Functions (n - p) pthread_getconcurrency(2) NAME pthread_getconcurrency - Gets level of concurrency LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_getconcurrency(void); DESCRIPTION Concurrency values range from 0 to MAXINT inclusive. A concurrency level of 0 suggests to the scheduler that the minimum possible amount of concurrency is required.
pthread_getschedparam(2) OSS System Calls Reference Manual NAME pthread_getschedparam - Obtains the current scheduling policy and scheduling parameters of a thread LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_getschedparam( pthread_t thread, int *policy, struct sched_param *param ); PARAMETERS thread specifies the thread whose scheduling policy and parameters are obtained.
System Functions (n - p) pthread_getschedparam(2) STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
pthread_getspecific(2) OSS System Calls Reference Manual NAME pthread_getspecific - Obtains the thread-specific data associated with a key LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include void *pthread_getspecific( pthread_key_t key ); PARAMETERS key specifies the context key that identifies the thread-specific data to be obtained.
System Functions (n - p) pthread_join(2) NAME pthread_join - Causes the calling thread to wait for the termination of a thread LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_join( pthread_t thread, void **value_ptr); PARAMETERS thread specifies the thread whose termination is awaited by the calling thread. value_ptr receives the return value of the terminating thread.
pthread_join(2) OSS System Calls Reference Manual STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
System Functions (n - p) pthread_key_create(2) NAME pthread_key_create - Generates a unique thread-specific data key LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_key_create( pthread_key_t *key, void (*destructor)(void *)); PARAMETERS key specifies the location where the new thread-specific data key is to be stored.
pthread_key_create(2) OSS System Calls Reference Manual RETURN VALUES If an error condition occurs, this function returns an integer value indicating the type of error. Possible return values are: 0 Successful completion. [EAGAIN] The system lacked the necessary resources to create another thread-specific data key, or the limit on the total number of keys for a process (PTHREAD_KEYS_MAX) has been exceeded. [ENOMEM] Insufficient memory exists to create the key.
System Functions (n - p) pthread_key_delete(2) NAME pthread_key_delete - Deletes a thread-specific data key LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_key_delete( pthread_key_t key); PARAMETERS key specifies the thread-specific data key to be deleted.
pthread_kill(2) OSS System Calls Reference Manual NAME pthread_kill - Sends a signal to a thread LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include #include int pthread_kill( pthread_t thread, int sig); PARAMETERS thread specifies the thread to receive the signal. sig specifies the signal to send.
System Functions (n - p) pthread_kill(2) RETURN VALUES If an error condition occurs, this function returns an integer value indicating the type of error. Possible return values are: 0 Successful completion. [EINVAL] The value of the sig parameter is invalid or specifies an unsupported signal. [ESRCH] The thread parameter does not specify an existing thread.
pthread_lock_global_np(2) OSS System Calls Reference Manual NAME pthread_lock_global_np - Locks the global mutex for threads LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_lock_global_np( void); DESCRIPTION This function locks the threads global mutex.
System Functions (n - p) pthread_mutex_destroy(2) NAME pthread_mutex_destroy - Destroys a mutex LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_mutex_destroy( pthread_mutex_t *mutex); PARAMETERS mutex specifies the mutex to be destroyed. DESCRIPTION This function destroys the specified mutex by uninitializing it. Call this function when your program no longer needs the specified mutex object.
pthread_mutex_init(2) OSS System Calls Reference Manual NAME pthread_mutex_init - Initializes a mutex LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_mutex_init( pthread_mutex_t *mutex, const pthread_mutexattr_t *attr); PARAMETERS mutex specifies the mutex to be initialized. attr specifies the mutex attributes object that defines the characteristics of the mutex to be initialized.
System Functions (n - p) pthread_mutex_init(2) RELATED INFORMATION Functions: pthread_mutex_destroy(2), pthread_mutex_lock(2), pthread_mutex_trylock(2), pthread_mutex_unlock(2), pthread_mutexattr_destroy(2), pthread_mutexattr_init(2). STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.
pthread_mutex_lock(2) OSS System Calls Reference Manual NAME pthread_mutex_lock - Locks an unlocked mutex LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_mutex_lock( pthread_mutex_t *mutex); PARAMETERS mutex specifies the mutex to be locked. DESCRIPTION This function locks a mutex.
System Functions (n - p) pthread_mutex_trylock(2) NAME pthread_mutex_trylock - Attempts to lock a specified mutex but does not wait if the mutex is already locked LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_mutex_trylock( pthread_mutex_t *mutex); PARAMETERS mutex specifies the mutex to be locked. DESCRIPTION This function attempts to lock the mutex specified by the mutex parameter.
pthread_mutex_unlock(2) OSS System Calls Reference Manual NAME pthread_mutex_unlock - Unlocks a mutex LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_mutex_unlock( pthread_mutex_t *mutex); PARAMETERS mutex specifies the mutex to be unlocked. DESCRIPTION This function unlocks the mutex specified by the mutex parameter.
System Functions (n - p) pthread_mutexattr_destroy(2) NAME pthread_mutexattr_destroy - Destroys a mutex attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_mutexattr_destroy( pthread_mutexattr_t *attr); PARAMETERS attr specifies the mutex attributes object to be destroyed. DESCRIPTION This function destroys a mutex attributes object by unintializing it.
pthread_mutexattr_getkind_np(2) OSS System Calls Reference Manual NAME pthread_mutexattr_getkind_np - Obtains the mutex type attribute of a mutex attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include extern int pthread_mutexattr_getkind_np( pthread_mutexattr_t attr ); PARAMETERS attr specifies the mutex attributes object whose mutex type is to be obtained.
System Functions (n - p) pthread_mutexattr_init(2) NAME pthread_mutexattr_init - Initializes a mutex attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_mutexattr_init( pthread_mutexattr_t *attr); PARAMETERS attr specifies the mutex attributes object to be initialized.
pthread_mutexattr_init(2) OSS System Calls Reference Manual STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
System Functions (n - p) pthread_mutexattr_setkind_np(2) NAME pthread_mutexattr_setkind_np - Sets the mutex type attribute of a mutex attributes object LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include extern int pthread_mutexattr_setkind_np( pthread_mutexattr_t *attr, int kind ); PARAMETERS attr specifies the mutex attributes object whose mutex type attribute is to be modified.
pthread_mutexattr_setkind_np(2) OSS System Calls Reference Manual [EPERM] The caller does not have the appropriate privileges to perform this operation. [ERANGE] One or more of the parameters have an invalid value. RELATED INFORMATION Functions: pthread_mutex_init(2), pthread_mutexattr_getkind_np(2), pthread_mutexattr_init(2). STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification and to the following industry standards: • 5−98 IEEE Std 1003.
System Functions (n - p) pthread_once(2) NAME pthread_once - Calls a routine to be executed once by a single thread LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include pthread_once_t once_control = PTHREAD_ONCE_INIT; int pthread_once( pthread_once_t *once_control, void ( *routine)(void) ); PARAMETERS once_control specifies a block that controls the one-time execution code.
pthread_self(2) OSS System Calls Reference Manual NAME pthread_self - Obtains the thread identifier of the calling thread LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include pthread_t pthread_self( void ); DESCRIPTION This function returns the thread identifier of the calling thread. RETURN VALUES This function returns the thread identifier of the calling thread.
System Functions (n - p) pthread_setcancelstate(2) NAME pthread_setcancelstate - Sets the calling thread’s cancelability state LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_setcancelstate( int state, int *oldstate ); PARAMETERS state specifies the new cancelability state for the calling thread.
pthread_setcancelstate(2) OSS System Calls Reference Manual STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
System Functions (n - p) pthread_setcanceltype(2) NAME pthread_setcanceltype - Sets the calling thread’s cancelability type LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_setcanceltype( int type, int *oldtype ); PARAMETERS type specifies the cancelability type to set for the calling thread.
pthread_setcanceltype(2) OSS System Calls Reference Manual STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard. The use of [ENOTSUP] is an HP extension to the POSIX standard.
System Functions (n - p) pthread_setconcurrency(2) NAME pthread_setconcurrency - Sets level of concurrency LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_setconcurrency(int new_level); DESCRIPTION Concurrency values range from 0 to MAXINT inclusive. A concurrency level of 0 suggests to the scheduler that the minimum possible amount of concurrency is required.
pthread_setschedparam(2) OSS System Calls Reference Manual NAME pthread_setschedparam - Sets the scheduling policy and scheduling parameters of a thread LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_setschedparam( pthread_t thread, int policy, const struct sched_param *param ); PARAMETERS thread specifies the thread whose scheduling policy and parameters are to be set.
System Functions (n - p) pthread_setschedparam(2) [EINVAL] The value specified by the policy or param parameter is invalid. [ENOTSUP] An attempt was made to set the scheduling policy or a scheduling parameter to an unsupported value. [ESRCH] The thread parameter does not refer to an existing thread. RELATED INFORMATION Functions: pthread_attr_setschedparam(2), pthread_attr_setschedpolicy(2), pthread_create(2), pthread_self(2), sched_yield(2).
pthread_setspecific(2) OSS System Calls Reference Manual NAME pthread_setspecific - Sets the thread-specific data associated with a key LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_setspecific( pthread_key_t key, const void *value ); PARAMETERS key specifies the thread-specific key that identifies the thread-specific data to be set to the new value.
System Functions (n - p) pthread_sigmask(2) NAME pthread_sigmask - Examines or changes the calling thread’s signal mask LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include [#include ] int pthread_sigmask( int how, const sigset_t *set, sigset_t *oset ); PARAMETERS how indicates how the set of masked signals is to be changed.
pthread_sigmask(2) OSS System Calls Reference Manual STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
System Functions (n - p) pthread_testcancel(2) NAME pthread_testcancel - Requests delivery of a pending cancelation request to the calling thread LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include void pthread_testcancel(void); DESCRIPTION This function requests delivery of a pending cancelation request to the calling thread. Thus, calling this function creates a cancelation point within the calling thread.
pthread_unlock_global_np(2) OSS System Calls Reference Manual NAME pthread_unlock_global_np - Unlocks the threads global mutex LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int pthread_unlock_global_np(void); DESCRIPTION This function unlocks the threads global mutex.
Section 6. System Functions (r) This section contains reference pages for Open System Services (OSS) system function calls with names that begin with r. These reference pages reside in the cat2 directory and are sorted alphabetically by U.S. English conventions in this section.
rand_r(2) OSS System Calls Reference Manual NAME rand_r - Returns pseudorandom numbers (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int rand_r ( unsigned int *seed ); PARAMETERS seed Specifies the initial value on which random numbers should be based. DESCRIPTION The rand_r( ) function is the reentrant version of the rand( ) function.
System Functions (r) read(2) NAME read - Reads from a file LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.
read(2) OSS System Calls Reference Manual • If no process has the pipe open for writing, the read( ) function returns the value 0 (zero) to indicate EOF. • If some process has the pipe open for writing: — If the O_NONBLOCK flag is not set, the read( ) function blocks until either some data is written or the pipe is closed by all processes that had opened the pipe for writing. — If the O_NONBLOCK flag is set, the read( ) function returns the value -1 and sets errno to [EAGAIN].
System Functions (r) [EAGAIN] read(2) The O_NONBLOCK flag is set for the file descriptor, and the process would be delayed in the read operation. The O_NONBLOCK flag is set, and no data was available. [EBADF] The filedes parameter is not a valid file descriptor open for reading. [ECONNRESET] One of these conditions occurred: • The transport-provider process for this socket is no longer available. • The TCP/IP subsystem for this socket is no longer available.
read(2) OSS System Calls Reference Manual [ETIMEDOUT] Data transmission on the socket timed out. [EWOULDBLOCK] The process attempted an operation on a socket for which O_NONBLOCK is set, there is no data, and no error has occurred. [EWRONGID] One of these conditions occurred: • The process attempted an operation through an operating system input/output process (such as a terminal server process) that has failed or is in the down state.
System Functions (r) readdir_r(2) NAME readdir_r - Reads a directory stream (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] [#include ] #include int readdir_r ( DIR *dirp, struct dirent *ret, struct dirent **result ); PARAMETERS dirp Points to the dirent structure of an open directory. ret Points to the directory entry at the current position in the directory stream.
readdir_r(2) OSS System Calls Reference Manual RETURN VALUES Upon successful completion, the readdir_r( ) function returns the value 0 (zero). Otherwise, a nonzero error number is returned, and errno is set to indicate the error. For the possible values that can be returned, see the ERRORS subsection of this reference page.
System Functions (r) readlink(2) NAME readlink - Reads the value of a symbolic link LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include int readlink( const char *path, char *buffer, size_t buf_size); PARAMETERS path Specifies the pathname of the destination file or directory. buffer Points to the user’s buffer.
readlink(2) OSS System Calls Reference Manual • The current working directory is assigned from the VOLUME attribute of the Guardian environment =_DEFAULTS DEFINE. • The use of static memory by the process increases slightly. These effects occur only when the first of the set of functions is called. The effects are not cumulative. RETURN VALUES Upon successful completion, the readlink( ) function returns the number of characters placed in the buffer (not including any terminating null).
System Functions (r) readlink(2) • The fileset containing the requestor’s current working directory or root directory is not mounted. This error can occur after failure and restart of an OSS name server process until the fileset has been repaired and remounted. [EOSSNOTRUNNING] The program attempted an operation on an object in the OSS environment while a required system process is not running. RELATED INFORMATION Functions: link(2), lstat(2), stat(2), symlink(2), unlink(2).
readv(2) OSS System Calls Reference Manual NAME readv - Reads from a file into scattered buffers LIBRARY G-series native OSS processes: /G/system/sysnn/zossesrl H-series OSS processes: /G/system/zdllnnn/zossedll SYNOPSIS #include #include
System Functions (r) readv(2) — If the O_NONBLOCK flag is not set, the readv( ) function blocks until either some data is written or the pipe is closed by all processes that had opened the pipe for writing. — If the O_NONBLOCK flag is set, the readv( ) function returns the value -1 and sets errno to [EAGAIN]. When attempting to read from a socket and no data is currently available: • If the O_NONBLOCK flag is not set, the readv( ) function blocks until data becomes available or an error occurs.
readv(2) OSS System Calls Reference Manual ERRORS If any of these conditions occurs, the readv( ) function sets errno to the corresponding value: [EAGAIN] [EBADF] One of these conditions occurred: • The O_NONBLOCK flag is set for the file descriptor, and the process would be delayed in the read operation. • The O_NONBLOCK flag is set for the file descriptor, and no data was available. The filedes parameter is not a valid file descriptor open for reading.
System Functions (r) readv(2) [ENETDOWN] The filedes parameter specifies a file on a remote HP NonStop node, but communication with the remote node has been lost. [ENOTCONN] The socket is no longer connected to a peer socket. [EOVERFLOW] The file is a regular file, the value of nbyte is greater than 0 (zero), the starting position is before the End-of-File (EOF), and the starting position is greater than or equal to the file offset maximum established when the file described by filedes was opened.
recv(2) OSS System Calls Reference Manual NAME recv - Receives a message from a connected socket LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include ssize_t recv( int socket, void *buffer, size_t length, int flags ); PARAMETERS socket Specifies the file descriptor of the socket. buffer Points to the buffer where the message should be written.
System Functions (r) recv(2) If the recv( ) function call fails, the value -1 is returned and errno is set to indicate the error. ERRORS If any of the following conditions occurs, the recv( ) function sets errno to the corresponding value: [EBADF] The socket parameter is not a valid file descriptor. [ECONNRESET] One of the following conditions occurred: • The transport-provider process for this socket is no longer available. • The TCP/IP subsystem for this socket is no longer available.
recv(2) 6−18 OSS System Calls Reference Manual Hewlett-Packard Company 527186-007
System Functions (r) recvfrom(2) NAME recvfrom - Receives a message from a socket LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include ssize_t recvfrom( int socket, void *buffer, size_t length, int flags, struct sockaddr *address, size_t *address_len ); PARAMETERS socket Specifies the file descriptor of the socket. buffer Points to the buffer where the message should be written.
recvfrom(2) OSS System Calls Reference Manual If no messages are available at the socket and the socket’s file descriptor is blocking (O_NONBLOCK is not set), the recvfrom( ) function blocks until a message arrives. If no messages are available at the socket and the socket’s file descriptor is marked nonblocking (O_NONBLOCK is set), the recvfrom( ) function fails and sets errno to [EWOULDBLOCK].
System Functions (r) recvfrom(2) [ENOTSOCK] The socket parameter does not refer to a socket. [EOPNOTSUPP] The specified value for the flags parameter is not supported for this socket type or protocol. [ETIMEDOUT] A transmission timed out on an active connection. [EWOULDBLOCK] The socket file descriptor is marked nonblocking (O_NONBLOCK is set) and the operation would block.
recvmsg(2) OSS System Calls Reference Manual NAME recvmsg - Receives a message from a socket using a message structure LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include ssize_t recvmsg( int socket, struct msghdr *message, int flags ); PARAMETERS socket Specifies the file descriptor of the socket.
System Functions (r) recvmsg(2) If no messages are available at the socket and the socket’s file descriptor is blocking (O_NONBLOCK is not set), the recvmsg( ) function blocks until a message arrives. If no messages are available at the socket and the socket’s file descriptor is marked nonblocking (O_NONBLOCK is set), the recvmsg( ) function fails and sets errno to [EWOULDBLOCK]. In the msghdr structure, the msg_name and msg_namelen members specify the source address if the socket is unconnected.
recvmsg(2) OSS System Calls Reference Manual [ECONNRESET] One of these conditions occurred: • The transport-provider process for this socket is no longer available. • The TCP/IP subsystem for this socket is no longer available. • The connection was forcibly closed by the peer socket. The socket can only be closed. [EFAULT] A user-supplied memory buffer cannot be accessed or written. [EINTR] A signal interrupted the function before any data was available.
System Functions (r) recvmsg(2) RELATED INFORMATION Functions: recv(2), recvfrom(2), select(2), send(2), sendmsg(2), sendto(2), shutdown(2), socket(2), socketpair(2). STANDARDS CONFORMANCE The HP implementation does not return the errno value [ENOSR]. HP extensions to the XPG4 specification are: 527186-007 • The errno value [ECONNRESET] can be returned when the transport-provider process is not available. • The errno value [EMFILE] can be returned.
rename(2) OSS System Calls Reference Manual NAME rename - Renames a file or directory LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: system library H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: implicit libraries DESCRIPTION The C run-time library supports two variants of the rename( ) function: rename_oss( ) and rename_guardian( ).
System Functions (r) rename_guardian(2) NAME rename_guardian - Renames a file (Guardian rename( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include
rename_guardian(2) OSS System Calls Reference Manual RETURN VALUES Upon successful completion, the rename( ) function returns a 0 (zero). Otherwise, a nonzero value is returned and the name of the file is not changed. RELATED INFORMATION Functions: rename(2), rename_oss(2). STANDARDS CONFORMANCE The rename_guardian( ) function is a HP extension to the XPG4 Version 2 specification.
System Functions (r) rename_oss(2) NAME rename_oss - Renames a file or directory (OSS rename( ) function) LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: system library H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: implicit libraries SYNOPSIS #include
rename_oss(2) OSS System Calls Reference Manual If the from and to parameters specify directories, the following requirements exist: • The directory specified by the from parameter must not be an ancestor of the directory specified by the to parameter. For example, the to pathname must not contain a pathname prefix that specifies from. • The directory specified by the to parameter must be empty, except for the . (dot) and . . (dot-dot) entries.
System Functions (r) rename_oss(2) To use the rename_oss( ) and rename_guardian( ) functions, specify the _TANDEM_SOURCE feature-test macro. RETURN VALUES Upon successful completion, the rename( ) function returns the value 0 (zero). Otherwise, the value -1 is returned and errno is set to indicate the error. ERRORS If any of the following conditions occurs, the rename( ) function sets errno to the corresponding value. The file or directory name remains unchanged.
rename_oss(2) OSS System Calls Reference Manual — /dev — /dev/tty or /dev/null — lost+found [EEXIST] The to parameter specifies an existing nonempty directory or an existing Guardian file (a file in /G). [EFAULT] Either the to or from parameter is an invalid address. [EFSBAD] The fileset catalog for one of the filesets involved in the operation is corrupt.
System Functions (r) rename_oss(2) [ENOMEM] The system has insufficient resources to complete the operation. [ENOROOT] One of the following conditions exists: • The root fileset of the local node (fileset 0) is not in the STARTED state. • The current root fileset for the specified file is unavailable. The OSS name server for the fileset might have failed. • The specified file is on a remote HP NonStop node and communication with the remote name server has been lost.
rename_oss(2) • OSS System Calls Reference Manual The errno value [EMLINK] is not returned, because links to directories are not allowed. The following are HP extensions to the XPG4 Version 2 specification: • The errno values [EFAULT], [EFSBAD], [EGUARDIANOPEN], [ENOMEM], [ENOROOT], [ENXIO], [EOSSNOTRUNNING], [EPERM], and [EXDEV] can be returned. The rename_oss( ) function is a HP extension to the XPG4 Version 2 specification.
System Functions (r) rmdir(2) NAME rmdir - Removes a directory LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include int rmdir( const char *path); PARAMETERS path Specifies the directory pathname. The pathname cannot be specified as . (dot) or . . (dot-dot).
rmdir(2) OSS System Calls Reference Manual Use From the Guardian Environment The rmdir( ) function is one of a set of functions that have the following effects when the first of them is called from the Guardian environment: • Two Guardian file system file numbers (not necessarily the next two available) are allocated for the root directory and the current working directory. These file numbers cannot be closed by calling the Guardian FILE_CLOSE_ procedure.
System Functions (r) rmdir(2) [EFSBAD] The fileset catalog for one of the filesets involved in the operation is corrupt. [EINVAL] The specified . (dot) or . . (dot-dot) pathname cannot be removed. [EIO] During a read from or write to a fileset, an I/O error occurred. [ELOOP] Too many symbolic links were encountered in translating the path parameter.
rmdir(2) OSS System Calls Reference Manual RELATED INFORMATION Functions: chmod(2), chroot(2), mkdir(2), mkfifo(3), mknod(2), remove(3), rename(2), umask(2), unlink(2). Commands: rmdir(1). STANDARDS CONFORMANCE The POSIX standards leave some features to the implementing vendor to define. The following features are affected in the HP implementation: • The rmdir( ) function can be used to remove the root directory or the current working directory of a process.
Section 7. System Functions (s and S) This section contains reference pages for Open System Services (OSS) system function calls with names that begin with s or S. These reference pages reside in the cat2 or cat3 directory and are sorted alphabetically by U.S. English conventions in this section.
sched_get_priority_max(2) OSS System Calls Reference Manual NAME sched_get_priority_max - Returns the maximum priority for a scheduling policy LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/systemzdllsnnn/zsptdll SYNOPSIS [ #include ] #include int sched_get_priority_max ( int policy ); PARAMETERS policy specifies one of the scheduling policies defined in the sched.h header file.
System Functions (s and S) sched_get_priority_min(2) NAME sched_get_priority_min - Returns the minimum priority for a scheduling policy LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [ #include ] #include int sched_get_priority_min ( int policy ); PARAMETERS policy specifies one of the scheduling policies defined in the sched.h header file.
sched_yield(2) OSS System Calls Reference Manual NAME sched_yield - Signals a willingness to yield the processor to another thread in the current process LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int sched_yield(void); DESCRIPTION This function forces the calling thread to relinquish its processor until it again becomes the head of its thread list.
System Functions (s and S) select(2) NAME select - Selects among file descriptors for synchronous input/output multiplexing LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include
select(2) OSS System Calls Reference Manual timeout Points to a type timeval structure that specifies the time to wait for a response from a call to the select( ) function. When the timeout parameter is not a null pointer, the maximum time interval to wait for the select( ) function to finish is specified by values stored in space reserved by the type timeval structure pointed to by the timeout parameter. A timeout value of 0 (zero) is treated as "do not wait".
System Functions (s and S) select(2) On return, the select( ) function replaces the original file descriptor sets with the corresponding file descriptor sets that have a bit set for each file descriptor representing those objects that are ready for the requested operation. The total number of ready objects represented by set bits in all the file descriptor sets is returned by the select( ) function.
select(2) OSS System Calls Reference Manual • The application can use a variable value for the nfds parameter that is based on the highest numbered file descriptor; for example: fd = open(... .); err = select(fd + 1, ...); • The application can use a fixed value for the nfds parameter that is based on the value of the FD_SETSIZE literal at the time of compilation; for example: err = select(FD_SETSIZE, ...
System Functions (s and S) select(2) ERRORS If any of these conditions occur, the select( ) function sets errno to the corresponding value: [EBADF] One of the specified file descriptor sets is invalid. One of these conditions occurred: • The invalid file descriptor set contains a file descriptor for a file that is not open.
select(2) OSS System Calls Reference Manual • The errno value [ENETDOWN] can be returned. • The errno value [ETHNOTRUNNING] can be returned. • The time interval specified by the timeout parameter must meet these criteria: — The maximum interval is 2**31 seconds plus 2**31 microseconds. If a value greater than this is specified, the maximum is used instead. — If a specified interval is not a whole multiple of 10 milliseconds, the next highest whole multiple is used instead.
System Functions (s and S) semctl(2) NAME semctl - Performs semaphore control operations LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include int semctl( int semid, int semnum, int cmd [, . . . ]); In this instance, the elipsis ( . . . ) indicates that the function is extensible. An additional, optional parameter can be specified. PARAMETERS semid Specifies the ID of the semaphore set.
semctl(2) OSS System Calls Reference Manual *array Points to an array of semaphore values. These values are returned when the cmd parameter has the value GETALL. These values are used to set semaphore values when the cmd parameter has the value SETALL. arg Specifies the instance of the union used for the fourth parameter. DESCRIPTION An OSS semaphore is identified by a set ID and by a unique semaphore number within that set ID. The semaphore set ID is unique within an HP NonStop server node.
System Functions (s and S) SETALL semctl(2) Sets the respective values of all semaphores in the set to the values specified in the array pointed to in the fourth parameter (arg.array). When this operation successfully executes, the system clears the semaphore’s adjust-on-exit value in all processes that have a semadj value for this semaphore.
semctl(2) OSS System Calls Reference Manual GETPID Returns the value of the sempid field from the semid_ds structure. GETVAL Returns the value of the semval field from the semid_ds structure. GETZCNT Returns the value of the semzcnt field from the semid_ds structure. Upon successful completion, all other values of cmd return the value 0 (zero). If the semctl( ) function fails, the value -1 is returned and errno is set to indicate the error.
System Functions (s and S) semctl(2) RELATED INFORMATION Commands: ipcrm(1), ipcs(1). Functions: ftok(3), semget(2), semop(2). STANDARDS CONFORMANCE The following are HP extensions to the XPG4 Version 2 specification: • 527186-007 The errno values [EFAULT] and [ENOTOSS] can be returned.
semget(2) OSS System Calls Reference Manual NAME semget - Creates a new semaphore set ID or returns the ID of an existing semaphore set LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include int semget( key_t key, int nsems, int semflg); PARAMETERS key Specifies the key that identifies the semaphore set.
System Functions (s and S) semget(2) • The sem_nsems field is set to the value of the nsems parameter. • The sem_otime field is set to 0 (zero), and the sem_ctime field is set equal to the current time. The semget( ) function does not initialize the sem structure associated with each semaphore in the set. The individual OSS semaphores are initialized by using the semctl( ) function with the SETVAL or SETALL value for the cmd parameter.
semget(2) OSS System Calls Reference Manual [EEXIST] A semaphore set ID already exists for the key parameter, but ((semflg & IPC_CREAT) && (semflg & IPC_EXCL)) is not equal to 0 (zero). [EINVAL] One of the following conditions is true: • A semaphore set ID already exists for the key parameter, but the number of semaphores in the set is less than nsems and nsems is not equal to 0 (zero).
System Functions (s and S) semop(2) NAME semop - Performs semaphore operations LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include int semop( int semid, struct sembuf *sops, size_t nsops); PARAMETERS semid Specifies the ID of the semaphore set. sops Points to the user-defined array of sembuf structures that contain the semaphore operations. nsops Specifies the number of sembuf structures in the array.
semop(2) OSS System Calls Reference Manual sem_flg Specifies various flags for the operations. The possible values are as follows: SEM_UNDO Instructs the system to adjust the process’s adjust-on-exit value (semadj) for a modified semaphore. When the process exits, the system uses this value to restore the semaphore to the value it had before any modifications by the process. This flag is used to prevent locking of resources allocated through a semaphore by a process that no longer exists.
System Functions (s and S) semop(2) If the sem_op field of the sembuf structure contains 0 (zero) and the calling process has read access permission, semop( ) does one of the following: • If the semval field of the sem structure contains 0 (zero), semop( ) returns immediately. • If semval is not zero and (sem_flg & IPC_NOWAIT) is not zero, semop( ) returns immediately.
semop(2) OSS System Calls Reference Manual [EINVAL] [ENOSPC] One of the following conditions is true: • The semid parameter is not a valid semaphore set ID. • The number of semaphores for which the SEM_UNDO flag is specified exceeds the system-defined limit. One of the following conditions is true: • The system-defined limit on the number of undo entries for an undo structure would be exceeded.
System Functions (s and S) send(2) NAME send - Sends a message on a connected socket LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include ssize_t send( int socket, const void *buffer, size_t length, int flags ); PARAMETERS socket Specifies the file descriptor of the socket. buffer Points to the buffer containing the message to send. length Specifies the length in bytes of the message to send.
send(2) OSS System Calls Reference Manual RETURN VALUES Upon successful completion, the send( ) function returns the number of bytes sent. Otherwise, the value -1 is returned and errno is set to indicate the error. ERRORS If any of the following conditions occurs, the send( ) function sets errno to the corresponding value: [EBADF] The socket parameter is not a valid file descriptor.
System Functions (s and S) send(2) [EWOULDBLOCK] The socket’s file descriptor is marked nonblocking (O_NONBLOCK is set) and the operation would block. RELATED INFORMATION Functions: connect(2), getsockopt(2), recv(2), recvfrom(2), recvmsg(2), select(2), sendmsg(2), sendto(2), setsockopt(2), shutdown(2), socket(2). STANDARDS CONFORMANCE The HP implementation does not return the errno value [ENOSR].
sendmsg(2) OSS System Calls Reference Manual NAME sendmsg - Sends a message on a socket using a message structure LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include ssize_t sendmsg( int socket, const struct msghdr *message, int flags ); PARAMETERS socket Specifies the file descriptor of the socket.
System Functions (s and S) sendmsg(2) fails and sets errno to [EWOULDBLOCK]. In the msghdr structure, the msg_control and msg_controllen members specify the ancillary data buffer that can be used only by sockets in the AF_UNIX domain to pass file descriptors to another process on the same node. The msg_control member can be a null pointer if ancillary data is not desired or required.
sendmsg(2) OSS System Calls Reference Manual [EDESTADDRREQ] The socket is not connection-oriented, no peer address is set, and no destination address is specified. [EFAULT] A user-supplied memory buffer cannot be accessed. [EINTR] A signal interrupted the function before any data was transmitted. [EINVAL] One of these conditions occurred: • The socket is in the AF_UNIX domain, and the msg_control member contains either more than 16 file descriptors or fewer than 1 file descriptor.
System Functions (s and S) [ENOMEM] sendmsg(2) Required memory resources were not available. A retry at a later time might succeed. [ENOPROTOOPT] The socket is in the AF_UNIX domain, and the cmsg_level member is not equal to SOL_SOCKET. [ENOTCONN] The socket is connection-oriented but is not connected. [ENOTDIR] The socket is in the AF_UNIX domain, and the pathname specified by the msghdr structure contains a component that is not a directory.
sendto(2) OSS System Calls Reference Manual NAME sendto - Sends a message on a socket LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include ssize_t sendto( int socket, const void *message, size_t length, int flags, const struct sockaddr *dest_addr, size_t dest_len ); PARAMETERS socket Specifies the file descriptor of the socket. message Points to the buffer containing the message to be sent.
System Functions (s and S) sendto(2) DESCRIPTION The sendto( ) function sends a message through a connection-oriented or connectionless socket. If the socket is connectionless, the message is sent to the address specified in the sockaddr structure pointed to by the dest_addr parameter. If the socket is connection-oriented, the dest_addr parameter is ignored. Successful completion of a call to sendto( ) does not imply successful delivery of the message.
sendto(2) OSS System Calls Reference Manual [EINTR] A signal interrupted the function before any data was transmitted. [EIO] The socket is in the AF_UNIX domain and an input or output error occurred. [EINVAL] The dest_len parameter is not a valid length for the address family. [ELOOP] The socket is in the AF_UNIX domain and too many symbolic links were encountered in translating the pathname in the sockaddr structure.
System Functions (s and S) [EPIPE] sendto(2) One of the following conditions occurred: • An attempt was made to send a message on a socket that is shut down for writing. • An attempt was made to send a message on a connection-oriented socket and the peer socket is closed or shut down for reading. The SIGPIPE signal is also sent to the calling process. [EWOULDBLOCK] The socket file descriptor is marked nonblocking (O_NONBLOCK is set) and the operation would block.
setgid(2) OSS System Calls Reference Manual NAME setgid - Sets the group ID of the calling process LIBRARY G-series native OSS processes: /G/system/sysnn/zsecsrl H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include #include /* Optional except for POSIX.1 */ int setgid( gid_t gid); PARAMETERS gid Specifies the new group ID.
System Functions (s and S) setpgid(2) NAME setpgid - Sets the process group ID for job control LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ int setpgid( pid_t pid, pid_t pgid); PARAMETERS pid Specifies the process whose process group ID is to be changed. pgid Specifies the new process group ID.
setpgid(2) OSS System Calls Reference Manual [EPERM] [ESRCH] One of the following conditions exists: • The process indicated by the pid parameter is a session leader. • The value of the pid parameter matches the OSS process ID of a child process of the calling process, and the child process is not in the same session as the calling process.
System Functions (s and S) setpgrp(2) NAME setpgrp - Sets the process group ID LIBRARY G-series native OSS processes: system library SYNOPSIS #include #include pid_t setpgrp(void); DESCRIPTION The setpgrp( ) function creates a new session when the calling process is not a process group leader. The calling process then becomes the session leader of this session and the process leader of a new process group, and it has no controlling terminal.
setregid(2) OSS System Calls Reference Manual NAME setregid - Sets the real and effective group IDs LIBRARY G-series native OSS processes: /G/system/sysnn/zsecsrl H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include int setregid( gid_t rgid, gid_t egid ); PARAMETERS rgid Specifies the new real group ID. egid Specifies the new effective group ID.
System Functions (s and S) setregid(2) STANDARDS CONFORMANCE The following are HP extensions to the XPG4 Version 2 specification: 527186-007 • If both the real and effective group IDs are changed so that they differ from each other and from the saved-set group ID, then the saved-set group ID is set to the value of the effective group ID. • A process without appropriate privileges can set the effective group ID if the new effective group ID matches a group ID in the group list of the process.
setreuid(2) OSS System Calls Reference Manual NAME setreuid - Sets the real and effective user IDs LIBRARY G-series native OSS processes: /G/system/sysnn/zsecsrl H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include int setreuid( uid_t ruid, uid_t euid ); PARAMETERS ruid Specifies the new real user ID. euid Specifies the new effective user ID.
System Functions (s and S) • 527186-007 setreuid(2) A process without appropriate privileges cannot set the real user ID.
setsid(2) OSS System Calls Reference Manual NAME setsid - Creates a new session and sets the process group ID LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ pid_t setsid(void); DESCRIPTION The setsid( ) function creates a new session when the calling process is not a process group leader.
System Functions (s and S) setsockopt(2) NAME setsockopt - Sets socket options LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include [#include ] [#include ] [#include ] [#include
setsockopt(2) OSS System Calls Reference Manual IPV6_LEAVE_GROUP Disables IPv6 multicast UDP datagrams on a specified interface. IPV6_MULTICAST_IF Specifies the interface (subnet) to use for outbound multicast UDP datagrams. option_value is an unsigned int. IPV6_MULTICAST_HOPS Specifies the hop limit for outbound multicast UDP datagrams.
System Functions (s and S) setsockopt(2) IP_MULTICAST_TTL Specifies the hop limit for outbound multicast UDP datagrams. option_value is an int that is either: • Between 0 and 255 to indicate the maximum number of hops allowed • Between 0 and 255 to indicate the maximum number of hops allowed • -1 to indicate that the default value should be used All other values cause an error and errno is set to [EINVAL].
setsockopt(2) OSS System Calls Reference Manual SO_KEEPALIVE Specifies whether to keep connections active by enabling the periodic transmission of messages on a connected socket. The default value used when the socket is created is 0 (zero), which indicates that no periodic messages are sent. This option is valid only for AF_INET or AF_INET6 sockets. If this option is specified for sockets of other types, the function call fails and sets errno to [ENOPROTOOPT]. option_value takes an int value.
System Functions (s and S) setsockopt(2) SO_REUSEPORT Specifies whether the rules used in validating ports supplied by a bind( ) function call should allow reuse of local ports. The default value used for the option when the socket is created is 0 (zero), which indicates that ports should not be reused. This option is valid only for UDP ports. This option takes an int value. Specifying a nonzero value permits ports to be reused. SO_SNDBUF Sets the send buffer size in bytes.
setsockopt(2) OSS System Calls Reference Manual TCP_SACKENA Specifies whether TCP selective acknowledgments are enabled. option_value takes an int value. A nonzero value indicates that selective acknowledgments are enabled. A 0 (zero) value indicates that selective acknowledgments should not be used. TCP_TOTRXMTVAL Sets the total maximum retransmission duration in multiples of 500 milliseconds. Once the duration is reached, the TCP cpnnection is dropped. option_value takes an int value.
System Functions (s and S) setsockopt(2) [EFAULT] A user-supplied memory buffer cannot be accessed. [EINVAL] One of the following conditions exists: • The specified option is not valid at the specified socket level. • The socket has been shut down. [ENOBUFS] There was not enough buffer space available to complete the call. A retry at a later time might succeed. [ENOMEM] Required memory resources were not available. A retry at a later time might succeed.
setuid(2) OSS System Calls Reference Manual NAME setuid - Sets the user ID of the calling process LIBRARY G-series native OSS processes: /G/system/sysnn/zsecsrl H-series OSS processes: /G/system/zdllnnn/zsecdll SYNOPSIS #include #include /* optional except for POSIX.1 */ int setuid( uid_t uid); PARAMETERS uid Specifies the new user ID.
System Functions (s and S) shmat(2) NAME shmat - Attaches a shared memory segment to the address space of the calling process LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include void *shmat( int shmid, const void *shmaddr, int shmflag); PARAMETERS shmid Specifies the identifier for the shared memory segment. The identifier is usually returned by a previous call to the shmget( ) function.
shmat(2) OSS System Calls Reference Manual Shared Segment Memory Alignment A shared memory segment must be aligned on a region boundary. A region is 32 megabytes (MB) of virtual memory. If the function call requests rounding, the value returned for shmaddr is rounded down to the closest multiple of 32 MB. The SHMLBA constant, which traditionally represents the number of bytes in a page of memory, represents the number of bytes in a region in the OSS implementation.
System Functions (s and S) [EINVAL] shmat(2) One of the following is true: • The shmid parameter does not specify a valid shared memory identifier. • The shmaddr parameter is not a null pointer and the value of (shmaddr ((ptrdiff_t)shmaddr % SHMLBA)) is an invalid address for attaching shared memory. • The shmaddr parameter is not a null pointer, (shmflag & SHM_RND) is 0 (zero), and the value of shmaddr is an invalid address for attaching shared memory.
shmctl(2) OSS System Calls Reference Manual NAME shmctl - Performs shared memory control operations LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include int shmctl( int shmid, int cmd, struct shmid_ds *buf); PARAMETERS shmid Specifies the shared memory identifier for the segment. cmd Specifies the type of operation.
System Functions (s and S) shmctl(2) DESCRIPTION The shmctl( ) function allows a process to query or set the contents of the shmid_ds structure associated with the specified shared memory identifier. It also allows a process to remove the shared memory identifier and its associated shmid_ds structure. The value of the cmd parameter determines which operation is performed.
shmctl(2) OSS System Calls Reference Manual • [EINVAL] The cmd parameter is IPC_SET, and the buf structure is not in the address space of the process. One of the following conditions exists: • The shmid parameter does not specify a valid shared memory identifier. • The cmd parameter is not a valid command. [ENOTOSS] The calling process is not an OSS process. The requested operation is not supported from the Guardian environment.
System Functions (s and S) shmdt(2) NAME shmdt - Detaches a shared memory segment LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include int shmdt( const void *shmaddr); PARAMETERS shmaddr Specifies the starting virtual address for the shared memory segment that is to be detached. This is the address returned by a previous shmat( ) function call.
shmdt(2) OSS System Calls Reference Manual RETURN VALUES Upon successful completion, the shmdt( ) function returns the value 0 (zero). The shared memory segment is detached. The value of the shm_nattch field in the structure associated with the shared memory identifier in the shared memory table is decremented. Otherwise, the shmdt( ) function returns the value -1 and sets errno to indicate the error.
System Functions (s and S) shmget(2) NAME shmget - Creates a new shared memory segment or returns the identifier of an existing shared memory segment LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include int shmget( key_t key, size_t size, int shmflag); PARAMETERS key Specifies the key that identifies the shared memory segment.
shmget(2) OSS System Calls Reference Manual DESCRIPTION The shmget( ) function returns the shared memory identifier for the shared memory segment identified by the key parameter. If the key parameter already has a shared memory identifier associated with it and (shmflag & IPC_CREAT) is 0 (zero), that identifier is returned.
System Functions (s and S) • shmget(2) It allows detection of attempts to reference shared memory segments in other processors. Key Creation The key represents a user-designated name for a given shared memory segment. Keys are usually selected by calling the ftok( ) function before calling the shmget( ) function. The ftok( ) function returns a key based on a path and an interprocess communications identifier. This key is then passed to the shmget( ) function, which returns a shared memory identifier.
shmget(2) OSS System Calls Reference Manual segment. Use From the Guardian Environment If called from a Guardian process, the function call fails and errno is set to the value of [ENOTOSS]. NOTES The shared memory identifier is not the Guardian environment segid value or segment identifier. Programs should not be written to depend upon the maximum number of attached shared segments. This limit is subject to change.
System Functions (s and S) shmget(2) RELATED INFORMATION Commands: ipcrm(1), ipcs(1). Functions: ftok(3), shmat(2), shmctl(2), shmdt(2). STANDARDS CONFORMANCE The following are HP extensions to the XPG4 Version 2 specification: • 527186-007 The errno value [ENOTOSS] can be returned.
shutdown(2) OSS System Calls Reference Manual NAME shutdown - Shuts down socket send and receive operations LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int shutdown( int socket, int how ); PARAMETERS socket Specifies the file descriptor of the socket. how Specifies the type of shutdown. The values are as follows: SHUT_RD Disables further receive operations. SHUT_RDWR Disables further send and receive operations.
System Functions (s and S) [ENOMEM] shutdown(2) Required memory resources were not available. A retry at a later time may succeed. [ENOTCONN] The socket is not connected. [ENOTSOCK] The socket parameter does not specify a socket. RELATED INFORMATION Functions: getsockopt(2), read(2), recv(2), recvfrom(2), recvmsg(2), select(2), send(2), sendmsg(2), sendto(2), setsockopt(2), socket(2), write(2). STANDARDS CONFORMANCE The HP implementation does not return the errno value [ENOSR].
sigaction(2) OSS System Calls Reference Manual NAME sigaction - Specifies the action to take upon delivery of a signal LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS [ #include ] #include int sigaction( int signal, const struct sigaction *action, struct sigaction *o_action ); PARAMETERS signal Specifies the signal. The signal names are defined in the signal.h header file.
System Functions (s and S) sigaction(2) Specifying the Action If the action parameter is not a null pointer, it points to a sigaction structure that describes the action to be taken on receipt of the signal specified in the signal parameter. If the o_action parameter is not a null pointer, it points to a sigaction structure in which the signal action data in effect at the time of the sigaction( ) call is returned.
sigaction(2) OSS System Calls Reference Manual The SIGKILL, SIGSTOP, and SIGABEND signals cannot be blocked. If a program attempts to block any of these signals, the system removes them from the signal mask without generating an error.
System Functions (s and S) sigaction(2) Files: signal(4). STANDARDS CONFORMANCE The POSIX standards leave some features to the implementing vendor to define. The following features are affected in the HP implementation: • The ordering of members within the sigaction structure might not match the ordering used in signal.h header files in other environments or on other systems.
sigpending(2) OSS System Calls Reference Manual NAME sigpending - Examines pending signals LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int sigpending( sigset_t *set); PARAMETERS set Points to an object of type sigset_t that returns the set of signals that are blocked from delivery and pending to the calling process.
System Functions (s and S) sigprocmask(2) NAME sigprocmask - Changes or examines the signal mask LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include
sigprocmask(2) OSS System Calls Reference Manual Use From the Guardian Environment If called from a TNS or accelerated Guardian process, the actions of this function are undefined and errno is set to [ENOTOSS]. EXAMPLES The following example shows how to use sigprocmask(SIG_BLOCK) to add the signal SIGINT to the signal set named newset and save the old mask. Later, the sigprocmask(SIG_SETMASK) function restores the mask to the previous value returned by the sigprocmask(SIG_BLOCK) function.
System Functions (s and S) sigsuspend(2) NAME sigsuspend - Changes the set of blocked signals and waits for a signal LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int sigsuspend( sigset_t *signal_mask ); PARAMETERS signal_mask Points to a set of signals to be blocked from delivery to the calling process.
sigsuspend(2) OSS System Calls Reference Manual RELATED INFORMATION Functions: pause(3), sigaction(2), signal(3), sigprocmask(2), spt_sigsuspend(2). | Files: signal(4). STANDARDS CONFORMANCE The following are HP extensions to the XPG4 Version 2 specification: 7−74 • HP has defined several new signals, including SIGABEND. See the signal(4) reference page for a complete list. • The [ENOTOSS] errno value is an HP extension.
System Functions (s and S) sockatmark(2) NAME sockatmark - Determines whether a socket is at the out-of-band mark LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int sockatmark( int socket); PARAMETERS socket Specifies the file descriptor for the socket. DESCRIPTION The sockatmark( ) function determines whether the specified socket is at an out-of-band mark in its receive queue data.
sockatmark(2) OSS System Calls Reference Manual RELATED INFORMATION Functions: recv(2), recvmsg(2), socket(2). STANDARDS CONFORMANCE This function is an extension to the XPG4 specification.
System Functions (s and S) socket(2) NAME socket - Creates an endpoint for communications LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int socket( int domain, int type, int protocol ); PARAMETERS domain Specifies the address family of the communications domain in which the socket is to be created. type Specifies the type of socket to be created.
socket(2) OSS System Calls Reference Manual Socket-level options control socket operations. The getsockopt( ) and setsockopt( ) functions are used to get and set these options, which are defined in the sys/socket.h file.
System Functions (s and S) • socket(2) If you do assign a base address, do not use any address in the range 0x20000000 through 0x41FFFFFF or any of these flat segment regions: 0x20000000 0x28000000 0x30000000 0x38000000 0x40000000 0x48000000 0x22000000 0x2A000000 0x32000000 0x3A000000 0x42000000 0x4A000000 0x24000000 0x2C000000 0x34000000 0x3C000000 0x44000000 0x4C000000 0x26000000 0x2E000000 0x36000000 0x3E000000 0x46000000 0x4E000000 On some processors, QIO allocates its shared memory region by def
socket(2) OSS System Calls Reference Manual [ENOMEM] Required memory resources were not available. A retry at a later time might succeed. [EPROTONOSUPPORT] The specified address family does not support the specified protocol. [EPROTOTYPE] The specified socket type is not supported by the protocol. [ETANOTRUNNING] The OSS transport agent for this processor is not running.
System Functions (s and S) socketpair(2) NAME socketpair - Creates a pair of connected sockets LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int socketpair( int domain, int type, int protocol, int socket_vector[2] ); PARAMETERS domain Specifies the communications domain in which the sockets are created. This parameter must be set to AF_UNIX. type Specifies the type of sockets to create.
socketpair(2) OSS System Calls Reference Manual Use From the Guardian Environment The socketpair( ) function is one of a set of functions that have these effects when the first of them is called from the Guardian environment: • Two Guardian file system file numbers (not necessarily the next two available) are allocated for the root directory and the current working directory. These file numbers cannot be closed by calling the Guardian FILE_CLOSE_ procedure.
System Functions (s and S) socketpair(2) RETURN VALUES Upon successful completion, the socketpair( ) function returns the value 0 (zero). Otherwise, the value -1 is returned, and errno is set to indicate the error. ERRORS If any of these conditions occurs, the socketpair( ) function sets errno to the corresponding value: [EACCES] The process does not have appropriate privileges to create a socket. [EAFNOSUPPORT] The specified address family is not supported.
socketpair(2) OSS System Calls Reference Manual STANDARDS CONFORMANCE The HP implementation does not support the SOCK_SEQPACKET socket type. The HP implementation does not return the errno value [ENOSR]. HP extensions to the XPG4 specification are: • 7−84 The errno values [ENOENT] and [ETANOTRUNNING] can be returned.
System Functions (s and S) socket_transport_name_get(2) NAME socket_transport_name_get - Gets the name of the transport-provider process LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int socket_transport_name_get( int domain, char *buffer, int maxlen ); PARAMETERS domain Specifies the domain for which the transport-provider process name should be obtained.
socket_transport_name_get(2) OSS System Calls Reference Manual The default AF_INET or AF_INET6 transport-provider name is $ZTC0, unless overridden by an existing Guardian DEFINE =TCPIPˆPROCESSˆNAME. If =TCPIPˆPROCESSˆNAME exists, it must be a MAP DEFINE with a FILE attribute string of the desired AF_INET or AF_INET6 transport-provider name. The default AF_UNIX transport-provider name is $ZPLS. This is the only supported AF_UNIX transport-provider name.
System Functions (s and S) socket_transport_name_set(2) NAME socket_transport_name_set - Sets the name of the transport-provider process LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int socket_transport_name_set( int domain, char *buffer ); PARAMETERS domain Specifies the domain for which the transport-provider process name is being set.
socket_transport_name_set(2) OSS System Calls Reference Manual Each user process has a current transport-provider name for each domain that is used when creating a socket in that domain. The default AF_INET or AF_INET6 transport-provider name is $ZTC0, unless overridden by an existing Guardian DEFINE =TCPIPˆPROCESSˆNAME. If =TCPIPˆPROCESSˆNAME exists, it must be a MAP DEFINE with a FILE attribute string of the desired AF_INET or AF_INET6 transport-provider name.
System Functions (s and S) spt_accept(2) NAME spt_accept - Initiates thread-aware accept( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_accept( int socket, struct sockaddr *address, size_t *address_len); PARAMETERS See the accept(2) reference page. DESCRIPTION This is a thread-aware version of the accept( ) function. The socket must be nonblocking for this function to be thread aware.
spt_acceptx(2) OSS System Calls Reference Manual NAME spt_acceptx - Accepts a new connection on a socket (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include
System Functions (s and S) spt_acceptx(2) NOTES The macro to map accept( ) to spt_acceptx( ) is available in C applications when SPT_THREAD_AWARE_NONBLOCK has been defined in the following manner before including spthread.h: #define SPT_THREAD_AWARE_NONBLOCK The alias to link accept( ) to spt_acceptx( ) is available in C++ applications when SPT_THREAD_AWARE_PRAGMA_NONBLOCK has been defined in the following manner before including spthread.
spt_acceptx(2) OSS System Calls Reference Manual [ENFILE] The maximum number of file descriptors for this processor are already open. [ENOBUFS] Not enough buffer space was available to complete the call. A retry at a later time might succeed. [ENOMEM] Required memory resources were not available. A retry at a later time might succeed. [ENOTSOCK] The socket parameter does not specify a socket. [EOPNOTSUPP] The socket type of the specified socket does not support accepting connections.
System Functions (s and S) spt_alarm(2) NAME spt_alarm - Schedules an alarm signal for delivery to a process (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include unsigned int spt_alarm( nsigned int *seconds); PARAMETERS seconds Specifies the number of real-time seconds to wait before sending the SIGALRM signal.
spt_alarm(2) OSS System Calls Reference Manual STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
System Functions (s and S) spt_awaitio(2) NAME spt_awaitio - Awaits a tagged I/O file LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
spt_awaitio(2) OSS System Calls Reference Manual ERRORS 16 filenum is not registered. 29 filenum < 0 (zero). 40 timelimit has expired. [EINTR] Wait was interrupted via spt_interrupt( ), spt_interruptTag( ), or a signal was received via pthread_kill( ) and is not blocked, ignored, or handled. STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.
System Functions (s and S) SPT_CANCEL(2) NAME SPT_CANCEL - Cancels the oldest incomplete operation on a Guardian file opened for nowait I/O LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include
SPT_CANCEL(2) OSS System Calls Reference Manual ERRORS None. This function does not set the errno variable. RELATED INFORMATION Functions: SPT_CONTROL(2), SPT_FILE_CLOSE_(2), SPT_FILE_OPEN_(2), SPT_LOCKFILE(2), SPT_LOCKREC(2), SPT_READLOCKX(2), SPT_READUPDATELOCKX(2), SPT_READUPDATEX(2), SPT_READX(2), SPT_SETMODE(2), SPT_UNLOCKFILE(2), SPT_UNLOCKREC(2), SPT_WRITEREADX(2), SPT_WRITEUPDATEUNLOCKX(2), SPT_WRITEUPDATEX(2), SPT_WRITEX(2).
System Functions (s and S) spt_close(2) NAME spt_close - Initiates thread-aware close( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_close( int filedes); PARAMETERS See the close(2) reference page. DESCRIPTION This is a thread-aware version of the close( ) function. Use spt_close( ) instead of close( ) to ensure proper operation of the various thread-aware IO functions.
spt_closex(2) OSS System Calls Reference Manual NAME spt_closex - Closes a file descriptor (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include
System Functions (s and S) spt_closex(2) RETURN VALUES Upon successful completion, the value 0 (zero) is returned. Otherwise, the value -1 is returned, and errno is set to indicate the error. ERRORS If any of these conditions occur, the spt_closex( ) function sets errno to the corresponding value: [EBADF] The filedes parameter is not a valid open file descriptor. [EIO] An input or output error occurred.
spt_connect(2) OSS System Calls Reference Manual NAME spt_connect - Initiates thread-aware connect( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_connect( int socket, const struct sockaddr *address, size_t address_len); PARAMETERS See the connect(2) reference page. DESCRIPTION This is a thread-aware version of the connect( ) function.
System Functions (s and S) spt_connectx(2) NAME spt_connectx - Connects a socket (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int spt_connectx( int socket, const struct sockaddr *address, size_t address_len ); PARAMETERS socket Specifies the file descriptor for the socket.
spt_connectx(2) OSS System Calls Reference Manual • A connection is established. • A timeout occurs. • A signal is caught. If a timeout occurs, the spt_connectx( ) call fails and errno is set to [ETIMEDOUT]; the connection is aborted. If an spt_connectx( ) call is interrupted by a signal that is caught while the call is blocked waiting to establish a connection, the spt_connectx( ) call fails and sets errno to [EINTR]; the connection is not aborted and is later established asynchronously.
System Functions (s and S) spt_connectx(2) [EALREADY] A connection request is already in progress for the specified socket. [EBADF] The socket parameter is not a valid file descriptor. [ECONNREFUSED] The specified address is not listening for connections or rejected the attempt to connect. [ECONNRESET] One of the following conditions occurred: • The transport-provider process for this socket is no longer available. • The TCP/IP subsystem for this socket is no longer available.
spt_connectx(2) OSS System Calls Reference Manual The pathconf( ) function can be called to obtain the applicable limits. [ENETDOWN] The local interface used to reach the destination is down. [ENETUNREACH] No route to the network or host is present. [ENOBUFS] Not enough buffer space was available to complete the call. A retry at a later time might succeed.
System Functions (s and S) SPT_CONTROL(2) NAME SPT_CONTROL - Performs device-dependent input/output operations LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include
SPT_CONTROL(2) OSS System Calls Reference Manual The following considerations apply to use on magnetic tapes: When device is not ready If a magnetic tape rewind is performed concurrently with application program execution (that is, a rewind operation other than 6), any attempt to perform a read, write, or control operation to the rewinding tape unit while rewind is taking place results in an error indication. A subsequent call to the FILE_GETINFO_ or FILEINFO procedure shows that an error 100 occurred.
System Functions (s and S) spt_dup2x(2) NAME spt_dup2x - Duplicates and controls an open file descriptor (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include
spt_dup2x(2) OSS System Calls Reference Manual NOTES The macro to map dup2( ) to spt_dup2x( ) is available in C applications when SPT_THREAD_AWARE_NONBLOCK has been defined in the following manner before including spthread.h: #define SPT_THREAD_AWARE_NONBLOCK The alias to link dup2( ) to spt_dup2x( ) is available in C++ applications when SPT_THREAD_AWARE_PRAGMA_NONBLOCK has been defined in the following manner before including spthread.
System Functions (s and S) spt_dup2x(2) RELATED INFORMATION Functions: close(2), dup(2), dup2(2), exec(2), fcntl(2), open(2), read(2), spt_fcntlx(2), spt_readx(2), spt_writex(2), tdm_execve(2), tdm_execvep(2), write(2). STANDARDS CONFORMANCE This function is an extension to the UNIX 98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.
spt_fclose(2) OSS System Calls Reference Manual NAME spt_fclose - Initiates thread-aware fclose( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_fclose(FILE *stream); PARAMETERS See the fclose(3) reference page online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the fclose( ) function.
System Functions (s and S) spt_fclosex(2) NAME spt_fclosex - Closes a stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int spt_fclosex ( FILE *stream ); PARAMETERS stream Specifies the output or update stream. DESCRIPTION The spt_fclosex( ) function is the thread-aware version of the fclose( ) function.
spt_fclosex(2) OSS System Calls Reference Manual ERRORS If any of these conditions occur, the spt_fclosex( ) function sets errno to the value that corresponds to the condition: [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying the stream parameter and the process would be delayed in the write operation. [EBADF] The file descriptor underlying the stream parameter is not valid.
System Functions (s and S) spt_fcntlx(2) NAME spt_fcntlx - Controls open file descriptors (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] [#include ] [#include ] #include
spt_fcntlx(2) F_GETFD OSS System Calls Reference Manual Gets the value of the file descriptor flags, defined in the fcntl.h header file, that are associated with the value of the filedes parameter. File descriptor flags are associated with a single file descriptor and do not affect other file descriptors that refer to the same file. The argument1 parameter or argument2 parameter is ignored. The value F_GETFD is invalid for an OSSTTY or Telserv terminal device.
System Functions (s and S) spt_fcntlx(2) The O_ASYNC flag is not supported for sockets. If the O_ASYNC flag is used with F_SETFL, the fcntl( ) call fails, and errno is set to [EINVAL]. The file access mode is not changed when F_SETFL is used. F_GETOWN Gets the process ID or process group ID currently receiving the SIGURG signal for a socket. A process group ID is returned as a negative value. A positive value indicates the process ID.
spt_fcntlx(2) OSS System Calls Reference Manual opened with read access. An exclusive lock prevents any other process from setting a shared lock or an exclusive lock on any portion of the protected area. A request for an exclusive lock fails if the file descriptor was not opened with write access. The flock structure describes the type (l_type field), starting offset (l_whence), relative offset (l_start), size (l_len), and process ID (l_pid) of the segment of the file to be affected.
System Functions (s and S) F_SETOWN spt_fcntlx(2) Returns the value 0 (zero). If the spt_fcntlx( ) function fails, the value -1 is returned, and errno is set to indicate the error. ERRORS If any of these conditions occur, the spt_fcntlx( ) function sets errno to the corresponding value: [EAGAIN] The request parameter is F_SETLK, the type of lock (l_type) is shared (F_RDLCK) or exclusive (F_WRLCK), and a segment of a file to be locked is already exclusive-locked by another process.
spt_fcntlx(2) [EIO] OSS System Calls Reference Manual • The request parameter is F_SETFL, and any file status flag other than O_NONBLOCK, O_APPEND, O_CREAT, O_EXCL, O_SYNC, or O_TRUNC is set. (Values set in the O_ACCMODE mask are ignored.) • The request parameter is F_SETOWN, and the filedes parameter does not specify a socket. • The call attempted to set an advisory record lock on a file that is not a regular file. An input or output error occurred.
System Functions (s and S) spt_fcntlx(2) STANDARDS CONFORMANCE This function is an extension to the UNIX 98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard. The POSIX standard allows certain behaviors of fcntl( ) to be implementer-defined.
spt_fd_read_ready(2) OSS System Calls Reference Manual NAME spt_fd_read_ready - Waits on read-ready file descriptor LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_fd_read_ready( const int fd, struct timeval *timeout); PARAMETERS fd Specifies an OSS file descriptor. timeout On input, the maximum interval to wait for fd ready; if NULL, then no timeout will occur. On output, the interval remaining.
System Functions (s and S) spt_fd_write_ready(2) NAME spt_fd_write_ready - Waits on write-ready file descriptor LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_fd_write_ready( const int fd, struct timeval *timeout); PARAMETERS fd Specifies an OSS file descriptor. timeout On input, specifies the maximum interval to wait for fd ready. If NULL, specifies that no timeout will occur.
spt_fflush(2) OSS System Calls Reference Manual NAME spt_fflush - Initiates thread-aware fflush( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_fflush( FILE *stream); PARAMETERS See the fflush(3) reference page either online or in the Guardian C Native Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the fflush(|) function.
System Functions (s and S) spt_fflushx(2) NAME spt_fflushx - Flushes a stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int spt_fflushx( FILE *stream ); PARAMETERS stream Specifies the output or update stream. DESCRIPTION The spt_fflushx( ) function is the thread-aware version of the fflush( ) function.
spt_fflushx(2) OSS System Calls Reference Manual [EFBIG] An attempt was made to write a file that exceeds the process’s file size limit or the maximum file size. [EINTR] The spt_fflushx( ) function was interrupted by a signal that was caught. [EIO] The TOSTOP tty local mode causes a background process to get a SIGTTOU signal if it attempts to write to the controlling terminal. The SIGTTOU signal, if it is not caught or ignored, will cause the process to block in a stopped state.
System Functions (s and S) spt_fgetc(2) NAME spt_fgetc - Initiates thread-aware fgetc( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_fgetc( FILE *stream); PARAMETERS See the fgetc(3) reference page either online or in the Guardian C Native Library Calls Reference Manual. DESCRIPTION Thread-aware fgetc(3).
spt_fgetcx(2) OSS System Calls Reference Manual NAME spt_fgetcx - Gets a character from a specified input stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int spt_fgetcx ( FILE *stream ); PARAMETERS stream Points to the file structure of an open file. DESCRIPTION The spt_fgetcx( ) function is the thread-aware version of the fgetc( ) function.
System Functions (s and S) spt_fgetcx(2) [ENXIO] A request was made on a nonexistent device, or the request was outside the capabilities of the device. [EIO] The call is attempting to read from the process’s controlling terminal and either the process is ignoring or blocking the SIGTTIN signal or the process group is orphaned. [ENOMEM] Insufficient memory is available for the operation.
spt_fgets(2) OSS System Calls Reference Manual NAME spt_fgets - Initiates thread-aware fgets( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include char *spt_fgets( char *string, int n, FILE *stream); PARAMETERS See the fgets(3) reference page either online or in the Guardian C Native Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the fgets( ) function.
System Functions (s and S) spt_fgetsx(2) NAME spt_fgetsx - Gets a string from a stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include char *spt_fgetsx ( char *string, int n, FILE *stream ); PARAMETERS string Points to a string to receive bytes. n Specifies an upper bound on the number of bytes to read. stream Points to the FILE structure of an open file.
spt_fgetsx(2) OSS System Calls Reference Manual [EBADF] The file descriptor underlying the input stream is not a valid file descriptor or is not open for reading. [EINTR] The read operation was interrupted by a signal that was caught and no data was transferred. [EIO] The call is attempting to read from the process’s controlling terminal and either the process is ignoring or blocking the SIGTTIN signal or the process group is orphaned. [ENOMEM] Insufficient memory is available for the operation.
System Functions (s and S) spt_fgetwc(2) NAME spt_fgetwc - Initiates thread-aware fgetwc( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_fgetwc( FILE *stream); PARAMETERS See the fgetwc(3) reference page either online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the fgetwc( ) function.
spt_fgetwcx(2) OSS System Calls Reference Manual NAME spt_fgetwcx - Gets a wide character from a a specified input stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include wint_t spt_fgetwcx ( FILE *stream ); PARAMETERS stream Specifies the input data. DESCRIPTION The spt_fgetwcx( ) function is the thread-aware version of the fgetwc( ) function.
System Functions (s and S) spt_fgetwcx(2) STANDARDS CONFORMANCE This function is an extension to the UNIX 98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
SPT_FILE_CLOSE_(2) OSS System Calls Reference Manual NAME SPT_ FILE_CLOSE_ - Closes an open Guardian file LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include short SPT_FILE_CLOSE_ ( short filenum, [short tape_disposition ] ); PARAMETERS filenum specifies the file number of a Guardian file open instance that identifies the file to be closed.
System Functions (s and S) SPT_FILE_CLOSE_(2) Closing a nowait file open If an SPT_FILE_CLOSE_( ) call is executed for a nowait file that has pending operations, any incomplete operations are canceled. There is no indication as to whether the operation completed or not. Labeled tape processing If your system has labeled tape processing enabled, all tape actions (as specified by tape_disposition) wait for completion.
spt_FileIOHandler_p(2) OSS System Calls Reference Manual NAME spt_FileIOHandler_p - Executes callback type required by spt_regFileIOHandler( ) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
System Functions (s and S) SPT_FILE_OPEN_(2) NAME SPT_FILE_OPEN_ - Establishes a communication path between an application process and a file LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include
SPT_FILE_OPEN_(2) OSS System Calls Reference Manual 1 Read only 2 Write only 3 Extend (supported only for tape) The default is 0 (zero). exclusion Specifies the desired mode of compatibility with other openers of the file. Valid values are: 0 Shared 1 Exclusive 2 Process exclusive 3 Protected The default is 0 (zero). nowait_depth Specifies the number of nowait I/O operations that can be in progress for the file concurrently with other processing.
System Functions (s and S) process pair SPT_FILE_OPEN_(2) Specifies whether an I/O operation is automatically redirected to the backup process if the primary process or its processor module fails. For processes, this parameter is called sync depth. The process determines the maximum value. The value must be at least 1 for an I/O operation to a remote process pair to recover from a network failure.
SPT_FILE_OPEN_(2) OSS System Calls Reference Manual 10 Open an OSS file by its OSS pathname. Specifies that the file to be opened is identified by the pathname parameter. 11 Reserved; specify 0 (zero). 12 No transactions. For $RECEIVE, messages are not to include transaction identifiers. This bit must be 0 (zero) if bit 15 is 1. 13 Internationalization locale support. For $RECEIVE, data messages include internationalization locale information. This bit must be 0 (zero) if bit 15 is 1.
System Functions (s and S) SPT_FILE_OPEN_(2) primary_processhandle Indicates that the caller is requesting a backup open and specifies the process handle of the primary process that already has the file open when its backup attempts to open the file. If this parameter is supplied and not null (a null process handle has -1 in each word), filenum must contain the filenum value that was returned to the primary.
SPT_FILE_OPEN_(2) OSS System Calls Reference Manual • Are independent • Might arrive in either order at the destination • Might complete in either order Multiple opens on a given file can create a deadlock. Locks are granted on an open file (that is, file number) basis. Therefore, if a process opens the same file multiple times, a lock of one file number excludes access to the file through other file numbers.
System Functions (s and S) SPT_FILE_OPEN_(2) using nowait I/O to a process; the opener does not wait for the process being opened to service the open message. Direct and buffered I/O transfers A file opened by SPT_FILE_OPEN_( ) uses direct I/O transfers by default; SETMODE 72 is used to force the system to use an intermediate buffer in the process file segment (PFS) for I/O transfers.
SPT_FILE_OPEN_(2) OSS System Calls Reference Manual for read-write access read and write security levels are checked. A Guardian file has one of seven levels of security for each access mode. The owner of the file can set the security level for each access mode by using SETMODE function 1 or by using the File Utility Program (FUP) SECURE command. The following table shows the seven levels of security: Table 7−2.
System Functions (s and S) SPT_FILE_OPEN_(2) Any other user, local access XXXYXXY If the caller to SPT_FILE_OPEN_( ) fails the security check, the open fails with an error 48. You can obtain the security level of a file by a call to the Guardian FILE_GETINFOLIST[BYNAME]_ procedure, the FILEINFO procedure, or by the File Utility Program (FUP) INFO command. If you are using the Safeguard product, this security information might not apply.
SPT_FILE_OPEN_(2) OSS System Calls Reference Manual its structured form. (HP reserves the right to change this block format at any time.) For information about Enscribe block formats, see the Enscribe Programmer’s Guide.
System Functions (s and S) SPT_FILE_OPEN_(2) Considerations for Terminals The terminal used as the operator console should not be opened with exclusive access. If it is, console messages are not logged. Interprocess Communication Considerations Maximum concurrent nowait operations for an open of $RECEIVE The maximum number of concurrent nowait operations permitted for an open of $RECEIVE is 1. Attempting to open $RECEIVE and to specify a value greater than 1 causes an error 28 to be returned.
SPT_FILE_OPEN_(2) OSS System Calls Reference Manual • Used the Guardian OPEN procedure to open $RECEIVE. Notification of this failure is not sent to the process reading $RECEIVE. Opening an unconverted (C-series format) process from a high-PIN process A high-PIN process cannot open an unconverted process unless the unconverted process has the HIGHREQUESTERS object-file attribute set.
System Functions (s and S) 12 SPT_FILE_OPEN_(2) Callback has already been registered for this filenum. Some error numbers are warnings (that is, they indicate conditions that do not prevent the file from being opened); check the value returned for the filenum parameter to determine whether the file was opened successfully. Forexplanation of other error numbers returned, see the Guardian Procedure Errors and Messages Manual. ERRORS None. This function does not set the errno variable.
spt_fork(2) OSS System Calls Reference Manual NAME spt_fork - Initiates a thread-aware fork() operation LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include pid_t spt_fork( void ); PARAMETERS None. DESCRIPTION This is a thread-aware version of the fork( ) function call that creates a new process from the current thread.
System Functions (s and S) spt_fprintf(2) NAME spt_fprintf - Initiates thread-aware fprintf( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_fprintf( FILE *stream, const char *format, ...); PARAMETERS See the fprintf(3) reference page either online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the fprintf( ) function.
spt_fprintfx(2) OSS System Calls Reference Manual NAME spt_fprintfx - Prints formatted output to an output stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int spt_fprintfx ( FILE *stream, const char *format [, value] . . . ); PARAMETERS stream Points to a FILE structure specifying an open stream to which converted values will be written.
System Functions (s and S) • spt_fprintfx(2) - Left align the result of the conversion within the field. + Begin the result of a signed conversion with a sign (+ or -). (space) Prefix a space character to the result if the first character of a signed conversion is not a sign. If both the (space) and + flags appear, the (space) flag is ignored. # Convert the value to an alternate form. For o conversion, it increases the precision to force the first digit of the result to be a 0 (zero).
spt_fprintfx(2) • OSS System Calls Reference Manual An optional h, l, ll, or L indicating the size of the argument corresponding to the following integer or floating-point conversion specifier: — An h followed by a d, i, o, u, x, or X conversion specifier indicates that the argument will be treated as a short int or unsigned short int. — An h followed by an n conversion specifier indicates that the argument will be treated as a pointer to a short int.
System Functions (s and S) 527186-007 spt_fprintfx(2) x or X Accepts an integer (int) value and converts it to unsigned hexadecimal notation. The letters abcdef are used for the x conversion and the letters ABCDEF are used for the X conversion. The precision specifies the minimum number of digits to appear. If the value being converted can be represented in fewer digits, it is expanded with leading zeros. The default precision is 1.
spt_fprintfx(2) OSS System Calls Reference Manual S Accepts a pointer to an array of wchar_t type. Wide characters from the array are converted to an array of bytes containing multibyte characters and the multibyte characters up to (but not including) the null character are printed. If a precision is specified, no more than the number of bytes specified by the precision are printed.
System Functions (s and S) spt_fprintfx(2) can be either positive or negative. For a description of the IEEE value classes, see the fp_class(3) reference page. Guardian functions are available to convert between floating-point formats. For a discussion of floating-point conversions, see the Guardian Programmer’s Guide. RETURN VALUES Upon successful completion, this function returns the number of bytes in the output string. Otherwise, a negative value is returned.
spt_fprintfx(2) OSS System Calls Reference Manual RELATED INFORMATION Functions: fp_class(3), fprintf(3), isnan(3), toascii(3), printf(3), putc(3), scanf(3), sprintf(3), spt_fprintf(2), spt_printfx(2). STANDARDS CONFORMANCE This function is an extension to the UNIX 98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.
System Functions (s and S) fputwc(3) NAME fputwc - Writes a wide character to a specified stream LIBRARY G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL G-series native OSS processes: /G/system/sysnn/zcrtlsrl H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL H-series OSS processes: /G/system/zdllnnn/zcrtldll SYNOPSIS #include wint_t fputwc( wint_t c, FILE *stream); PARAMETERS c Specifies the wide character to be written. stream Points to the output data.
fputwc(3) OSS System Calls Reference Manual [ENOMEM] Insufficient storage space is available. [ENOSPC] There was no free space remaining on the device containing the file. [ENXIO] A request was made of a non-existent device, or the request was outside the capabilities of the device. [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process.
System Functions (s and S) spt_fputc(2) NAME spt_fputc - Thread-aware fputc( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_fputc( int c, FILE *stream); PARAMETERS See the fputc(3) man page either online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the fputc( ) function.
spt_fputcx(2) OSS System Calls Reference Manual NAME spt_fputcx - Writes a byte to a specified output stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int spt_fputcx ( int c, FILE *stream ); PARAMETERS c Specifies the character to be written. stream Points to the file structure of an open file.
System Functions (s and S) spt_fputcx(2) RETURN VALUES The spt_fputcx( ) function, upon successful completion, returns the value written. If this function fails, it returns the constant EOF and sets errno. If the file descriptor underlying stream becomes invalid (is closed by another thread), EOF is returned with an errno value of [EBADF]. If a signal is received via pthread_kill(2) and is not blocked, ignored, or handled, EOF is returned with an errno value of [EINTR].
spt_fputcx(2) OSS System Calls Reference Manual RELATED INFORMATION Functions: ferror(3), fputc(3), getc(3), getwc(3), printf(3), putc(3), putchar(3), puts(3), putwc(3), spt_getcx(2), spt_getwcx(2), spt_printfx(2), spt_putcx(2), spt_putcharx(2), spt_putsx(2), spt_putwcx(2), spt_writex(2), write(2). STANDARDS CONFORMANCE This function is an extension to the UNIX 98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.
System Functions (s and S) spt_fputs(2) NAME spt_fputs - Initiates thread-aware fputs( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_fputs( const char *string, FILE *stream); PARAMETERS See the fputs(3) reference page either online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the fputs( ) function.
spt_fputsx(2) OSS System Calls Reference Manual NAME spt_fputsx - Writes a string to a stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int spt_fputsx ( const char *string, FILE *stream ); PARAMETERS string Points to a string to be written to output. stream Points to the FILE structure of an open file.
System Functions (s and S) spt_fputsx(2) incomplete output. In addition, if any of these conditions occur, the spt_fputsx( ) function sets errno to the corresponding value: [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying stream and the process would be delayed in the write operation. [EBADF] The file descriptor underlying stream is not a valid file descriptor open for writing.
spt_fputwc(2) OSS System Calls Reference Manual NAME spt_fputwc - Thread-aware fputwc( ) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include wint_t spt_fputwc( wint_t c, FILE *stream); PARAMETERS See fputwc(3) reference page either online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the fputwc( ) function.
System Functions (s and S) spt_fputwcx(2) NAME spt_fputwcx - Writes a wide character to a specified stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include wint_t spt_fputwcx ( wint_t c, FILE *stream ); PARAMETERS c Specifies the wide character to be written. stream Points to the output data.
spt_fputwcx(2) OSS System Calls Reference Manual [EBADF] The file descriptor underlying stream is not a valid file descriptor open for writing. [EFBIG] An attempt was made to write to a file that exceeds the process’s file size limit or the maximum file size. [EINTR] The operation was interrupted by a signal that was caught, and no data was transferred.
System Functions (s and S) spt_fread(2) NAME spt_fread - Initiates thread-aware fread( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include size_t spt_fread( void *pointer, size_t size, size_t num_items, FILE *stream); PARAMETERS See the fread(3) reference page either online or in the Open System Services Library Calls Reference Manual.
spt_freadx(2) OSS System Calls Reference Manual NAME spt_freadx - Reads input from a stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include size_t spt_freadx ( void ∗ pointer, size_t size, size_t num_items, FILE ∗ stream ); PARAMETERS pointer Points to an array. size Specifies the size of the variable type of the array pointed to by the pointer parameter.
System Functions (s and S) spt_freadx(2) and is not blocked, ignored, or handled, EOF is returned with an errno value of [EINTR]. ERRORS The spt_freadx( ) function fails if: • The stream parameter is not open for reading. • The stream is unbuffered. • The stream’s buffer needed to be flushed and the function call caused an underlying spt_writex( ) or lseek( ) to be invoked and this underlying operation fails.
spt_fwrite(2) OSS System Calls Reference Manual NAME spt_fwrite - Initiates thread-aware fwrite( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include ssize_t spt_fwrite( const void *pointer, size_t size, size_t num_items, FILE *stream); PARAMETERS See the fwrite(3) reference page either online or in the Open System Services Library Calls Reference Manual.
System Functions (s and S) spt_fwritex(2) NAME spt_fwritex - Writes to an output stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include size_t spt_fwritex ( const void ∗ pointer, size_t size, size_t num_items, FILE ∗ stream ); PARAMETERS pointer Points to an array. size Specifies the size of the variable type of the array pointed to by the pointer parameter.
spt_fwritex(2) OSS System Calls Reference Manual ERRORS The spt_fwritex( ) function fails if: • The stream parameter is not open for writing. • The output file size cannot be increased. • The stream is unbuffered. • The buffer of stream needs to be flushed and the function call causes an underlying spt_writex( ) or lseek( ) to be invoked, and this underlying operation fails.
System Functions (s and S) spt_fwritex(2) STANDARDS CONFORMANCE This function is an extension to the UNIX 98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
spt_generateTag(2) OSS System Calls Reference Manual NAME spt_generateTag - Increments and returns a static long tag LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include long spt_generateTag(void); PARAMETERS None. DESCRIPTION Increments and returns a static long string appropriate for use as a tag. Note that this long string will eventually wrap, thereby returning tags that may still be in use.
System Functions (s and S) spt_getc(2) NAME spt_getc - Initiates thread-aware getc( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_getc( FILE *stream); PARAMETERS See the getc(3) reference page either online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the getc( ) function.
spt_getchar(2) OSS System Calls Reference Manual NAME spt_getchar - Executes thread-aware getchar( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_getchar(void); PARAMETERS See the getchar(3) reference page either online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the getchar( ) function.
System Functions (s and S) spt_getcharx(2) NAME spt_getcharx - Gets a character from the standard input stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int spt_getcharx (void); PARAMETERS None. DESCRIPTION The spt_getcharx( ) function is the thread-aware version of the getchar( ) function.
spt_getcharx(2) OSS System Calls Reference Manual [EINTR] The read operation was interrupted by a signal that was caught, and no data was transferred. [ENXIO] A request was made on a nonexistent device, or the request was outside the capabilities of the device. [EIO] The call is attempting to read from the process’s controlling terminal and either the process is ignoring or blocking the SIGTTIN signal or the process group is orphaned. [ENOMEM] Insufficient memory is available for the operation.
System Functions (s and S) spt_getcx(2) NAME spt_getcx - Gets a character from a specified input stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int spt_getcx ( FILE ∗ stream ); PARAMETERS stream Points to the FILE structure of an open file. DESCRIPTION The spt_getcx( ) function is the thread-aware version of the getc( ) function.
spt_getcx(2) OSS System Calls Reference Manual ERRORS If any of these conditions occur, the spt_getcx( ) function sets errno to the corresponding value: [EAGAIN] The O_NONBLOCK flag is set for the underlying input stream and the process would be delayed by the read operation. [EBADF] The file descriptor underlying the input stream is not a valid file descriptor or is not open for reading. [EINTR] The read operation was interrupted by a signal that was caught, and no data was transferred.
System Functions (s and S) spt_gets(2) NAME spt_gets - Initiates thread-aware gets( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_gets( FILE *stream); PARAMETERS See the gets(3) reference page either online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the gets(3) function.
spt_getsx(2) OSS System Calls Reference Manual NAME spt_getsx - Gets a string from the standard input stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include char ∗ spt_getsx ( char ∗ string ); PARAMETERS string Points to a string to receive bytes. DESCRIPTION The spt_getsx( ) function is the thread-aware version of the gets( ) function.
System Functions (s and S) spt_getsx(2) [EBADF] The file descriptor underlying the input stream is not a valid file descriptor or is not open for reading. [EINTR] The read operation was interrupted by a signal that was caught, and no data was transferred. [ENXIO] A request was made on a nonexistent device, or the request was outside the capabilities of the device.
spt_getTMFConcurrentTransactions(2) OSS System Calls Reference Manual NAME spt_getTMFConcurrentTransactions - Gets the number of concurrent TMF transactions being used LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_getTMFConcurrentTransactions ( void ); PARAMETERS None. DESCRIPTION This function gets the number of concurrent TMF transactions being used.
System Functions (s and S) spt_getw(2) NAME spt_getw - Initiates thread-aware getw( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_getw( FILE *stream); PARAMETERS See the getw(3) reference page either online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the getw( ) function.
spt_getwc(2) OSS System Calls Reference Manual NAME spt_getwc - Initiates thread-aware getwc( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include wint_t spt_getwc( FILE *stream); PARAMETERS See the getwc(3) reference page either online or in the Open System Services Library Calls Refrence Manual. DESCRIPTION This is a thread-aware version of the getwc( ) function.
System Functions (s and S) spt_getwchar(2) NAME spt_getwchar - Initiates thread-aware getwchar( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include wint_t spt_getwchar(void); PARAMETERS See the getwchar(3) reference page either online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the getwchar(3) function.
spt_getwcharx(2) OSS System Calls Reference Manual NAME spt_getwcharx - Gets a wide character from the standard input stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include wint_t spt_getwcharx (void); PARAMETERS None. DESCRIPTION The spt_getwcharx( ) function is the thread-aware version of the getwchar( ) function.
System Functions (s and S) spt_getwcharx(2) STANDARDS CONFORMANCE This function is an extension to the UNIX 98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
spt_getwcx(2) OSS System Calls Reference Manual NAME spt_getwcx - Gets a wide character from a specified input stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include wint_t spt_getwcx ( FILE *stream ); PARAMETERS stream Specifies the input data. DESCRIPTION The spt_getwcx( ) function is the thread-aware version of the getwc( ) function.
System Functions (s and S) spt_getwcx(2) STANDARDS CONFORMANCE This function is an extension to the UNIX 98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
spt_getwx(2) OSS System Calls Reference Manual NAME spt_getwx - Gets a word from an input stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int spt_getwx ( FILE *stream ); PARAMETERS stream Points to the file structure of an open file. DESCRIPTION The spt_getwx( ) function is the thread-aware version of the getw( ) function.
System Functions (s and S) spt_getwx(2) [EBADF] The file descriptor underlying the stream is not a valid file descriptor or is not open for reading. [EINTR] The read operation was interrupted by a signal that was caught, and no data was transferred. [ENXIO] A request was made on a nonexistent device, or the request was outside the capabilities of the device.
spt_INITRECEIVE(2) OSS System Calls Reference Manual NAME spt_INITRECEIVE - Registers $RECEIVE filename LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
System Functions (s and S) spt_interrupt(2) NAME spt_interrupt - Interrupts all threads awaiting input or output LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include spt_error_t spt_interrupt( const short filenum, const spt_error_t errorSPT); PARAMETERS filenum Specifies the Guardian file number for thev file whose awaiting I/O is to be interrupted. errorSPT Specifies SPT error returned to waiting file.
spt_interruptTag(2) OSS System Calls Reference Manual NAME spt_interruptTag - Interrupts thread awaiting tagged I/O LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
System Functions (s and S) SPT_LOCKFILE(2) NAME SPT_LOCKFILE - Excludes other users from accessing a Guardian disk file LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include short SPT_LOCKFILE ( short filenum, [ long tag ] ); PARAMETERS filenum specifies the file number of a Guardian disk file open instance that identifies the file to be locked tag is for nowait input/output (I/O) only.
SPT_LOCKFILE(2) OSS System Calls Reference Manual Nowait and SPT_LOCKFILE( ) If the SPT_LOCKFILE( ) function is used to initiate an operation with a file opened for nowait I/O, it must complete with a corresponding call to the Guardian AWAITIO procedure. Locking modes Default mode If the file is already locked by another user when SPT_LOCKFILE( ) is called, the process requesting the lock is suspended and queued in a locking queue behind other users trying to access the file.
System Functions (s and S) SPT_LOCKFILE(2) Use on OSS Objects This procedure operates only on Guardian objects. If an OSS file is specified, Guardian filesystem error 2 occurs. RETURN VALUES The SPT_LOCKFILE( ) function returns 0 (zero) upon successful completion. Otherwise, this function returns a nonzero Guardian file-system error number that indicates the outcome of the operation. For information about Guardian file-system error numbers, see the Guardian Procedure Errors and Messages Manual.
SPT_LOCKREC(2) OSS System Calls Reference Manual NAME SPT_LOCKREC - Excludes other users from accessing a record in a Guardian disk file LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include
System Functions (s and S) SPT_LOCKREC(2) Considerations Record locking versus file locking A call to SPT_LOCKFILE( ) is not equivalent to locking all records in a file; that is, locking all records still allows insertion of new records, but file locking does not. File locks and record locks are queued in the order in which they are issued.
SPT_LOCKREC(2) OSS System Calls Reference Manual Structured files Calling LOCKREC after positioning on a nonunique key If the call to SPT_LOCKREC( ) immediately follows a call to KEYPOSITION where a nonunique alternate key is specified, the call to SPT_LOCKREC( ) fails. A subsequent call to the Guardian FILE_GETINFO_ or FILEINFO procedure shows that a Guardian file-system error 46 (invalid key) occurred.
System Functions (s and S) SPT_LOCKREC(2) ERRORS None. This function does not set the errno variable. RELATED INFORMATION Functions: SPT_CANCEL(2), SPT_CONTROL(2), SPT_FILE_CLOSE_(2), SPT_FILE_OPEN_(2), SPT_LOCKFILE(2), SPT_READLOCKX(2), SPT_READUPDATELOCKX(2), SPT_READUPDATEX(2), SPT_READX(2), SPT_SETMODE(2), SPT_UNLOCKFILE(2), SPT_UNLOCKREC(2), SPT_WRITEREADX(2), SPT_WRITEUPDATEUNLOCKX(2), SPT_WRITEUPDATEX(2), SPT_WRITEX(2).
spt_OSSFileIOHandler_p(2) OSS System Calls Reference Manual NAME spt_OSSFileIOHandler_p - Executes callback type required by the spt_regOSSFileIOHandler( function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
System Functions (s and S) spt_pause(2) NAME spt_pause - Suspends a thread until a signal is received. LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/sysnn/zsptdll SYNOPSIS #include int spt_pause(void) DESCRIPTION This function suspends the calling thread until it receives a signal whose action is either to execute a signal-catching function or to terminate the process.
spt_printf(2) OSS System Calls Reference Manual NAME spt_printf - Initiates thread-aware printf( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_printf( const char *format, ...); PARAMETERS See the printf(3) reference page either online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the printf( ) function.
System Functions (s and S) spt_printfx(2) NAME spt_printfx - Prints formatted output to the standard output stream (thread-aware function) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int spt_printfx ( const char *format [, value] . . . ); PARAMETERS format Specifies a character string combining literal characters with conversion specifications.
spt_printfx(2) • OSS System Calls Reference Manual + Begin the result of a signed conversion with a sign (+ or -). (space) Prefix a space character to the result if the first character of a signed conversion is not a sign. If both the (space) and + flags appear, the (space) flag is ignored. # Convert the value to an alternate form. For o conversion, it increases the precision to force the first digit of the result to be a 0 (zero).
System Functions (s and S) • spt_printfx(2) An optional h, l, ll, or L indicating the size of the argument corresponding to the following integer or floating-point conversion specifier: — An h followed by a d, i, o, u, x, or X conversion specifier indicates that the argument will be treated as a short int or unsigned short int. — An h followed by an n conversion specifier indicates that the argument will be treated as a pointer to a short int.
spt_printfx(2) 7−216 OSS System Calls Reference Manual x or X Accepts an integer (int) value and converts it to unsigned hexadecimal notation. The letters abcdef are used for the x conversion and the letters ABCDEF are used for the X conversion. The precision specifies the minimum number of digits to appear. If the value being converted can be represented in fewer digits, it is expanded with leading zeros. The default precision is 1.
System Functions (s and S) spt_printfx(2) S Accepts a pointer to an array of wchar_t type. Wide characters from the array are converted to an array of bytes containing multibyte characters and the multibyte characters up to (but not including) the null character are printed. If a precision is specified, no more than the number of bytes specified by the precision are printed.
spt_printfx(2) OSS System Calls Reference Manual can be either positive or negative. For a description of IEEE value classes, see the fp_class(3) reference page. Guardian functions are available to convert between floating-point formats. For a discussion of floating-point conversions, see the Guardian Programmer’s Guide. RETURN VALUES Upon successful completion, this function returns the number of bytes in the output string. Otherwise, a negative value is returned.
System Functions (s and S) spt_printfx(2) RELATED INFORMATION Functions: fp_class(3), fprintf(3), isnan(3), toascii(3), printf(3), putc(3), scanf(3), sprintf(3), spt_putcx(2), spt_fprintfx(2), spt_printf(2), spt_sprintfx(2). STANDARDS CONFORMANCE This function is an extension to the UNIX 98 specification. Interfaces documented on this reference page conform to the following industry standards: — IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.
spt_putc(2) OSS System Calls Reference Manual NAME spt_putc - Initiates thread-aware putc( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_putc( int c, FILE *stream); PARAMETERS See the putc(3) reference page either online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the putc( ) function.
System Functions (s and S) spt_putchar(2) NAME spt_putchar - Initiates thread-aware putchar( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include extern int spt_putchar( int c); PARAMETERS See the putchar(3) reference page either online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the putchar( ) function.
spt_putcharx(2) OSS System Calls Reference Manual NAME spt_putcharx - Writes a byte to the standard output stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int spt_putcharx ( int cO ); PARAMETERS c Specifies the character to be written. DESCRIPTION The spt_putcharx( ) function is the thread-aware version of the putchar( ) function.
System Functions (s and S) spt_putcharx(2) RETURN VALUES The spt_putcharx( ) function and macro, upon successful completion, return the value written. If this function or macro fails, it returns the constant EOF. The function sets errno when an error is encountered. If the file descriptor underlying stdout becomes invalid (is closed by another thread), EOF is returned with an errno value of [EBADF].
spt_putcharx(2) OSS System Calls Reference Manual RELATED INFORMATION Functions: ferror(3), fputc(3), getc(3), getwc(3), printf(3), putc(3), putchar(3), puts(3), putwc(3), spt_fputcx(2), spt_getcx(2), spt_getwcx(2), spt_printfx(2), spt_putcx(2), spt_putsx(2), spt_putwcx(2), spt_writex(2), write(2). STANDARDS CONFORMANCE This function is an extension to the UNIX 98 specification. Interfaces documented on this reference page conform to the following industry standards: — IEEE Std 1003.
System Functions (s and S) spt_putcx(2) NAME spt_putcx - Writes a byte to a specified output stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int spt_putcx ( int c, FILE *stream ); PARAMETERS c Specifies the character to be written. stream Points to the file structure of an open file.
spt_putcx(2) OSS System Calls Reference Manual the source). Consequently, you cannot use this interface where a function is necessary; for example, a subroutine pointer cannot point to it. In addition, spt_putcx( ) does not work correctly with a stream parameter that has side effects. In particular, the following does not work: spt_putcx(*f++) When a function is necessary, use the spt_fputcx( ) function instead.
System Functions (s and S) spt_putcx(2) [ENXIO] A request was made of a nonexistent device, or the request was outside the capabilities of the device. [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process. Any error encountered during the underlying call to the spt_writex( ) function can cause this function to return the corresponding errno value reported by the spt_writex( ) function.
spt_puts(2) OSS System Calls Reference Manual NAME spt_puts - Initiates thread-aware puts( ) function. LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_puts( const char *string); PARAMETERS See the puts(3) reference page either online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the puts( ) function.
System Functions (s and S) spt_putsx(2) NAME spt_putsx - Writes a string to the standard output stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int spt_putsx ( const char *string ); PARAMETERS string Points to a string to be written to output. DESCRIPTION The spt_putsx( ) function is the thread-aware version of the puts( ) function.
spt_putsx(2) OSS System Calls Reference Manual underlying operation fails with incomplete output. In addition, if any of these conditions occur, the spt_putsx( ) function sets errno to the corresponding value: [EAGAIN] The O_NONBLOCK flag is set for the file descriptor of the underlying stream and the process would be delayed in the write operation. [EBADF] The file descriptor of the underlying stream is not a valid file descriptor open for writing.
System Functions (s and S) spt_putw(2) NAME spt_putw - Initiates thread-aware putw( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_putw( int c, FILE *stream); PARAMETERS See the putw(3) reference page either online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the putw( ) function.
spt_putwc(2) OSS System Calls Reference Manual NAME spt_putwc - Initiates thread-aware putwc( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include wint_t spt_putwc( wint_t c, FILE *stream); PARAMETERS See the putwc(3) reference page either online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the putwc( ) function.
System Functions (s and S) spt_putwchar(2) NAME spt_putwchar - Initiates thread-aware fputwchar( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include wint_t spt_putwchar( wint_t c); PARAMETERS See the putwchar(3) reference page either online or in the Open System Services Library Calls Reference Manual. DESCRIPTION This is a thread-aware version of the putwchar( ) function.
spt_putwcharx(2) OSS System Calls Reference Manual NAME spt_putwcharx - Writes a wide character to the standard output stream (thread-aware) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include wint_t spt_putwcharx ( wint_t c ); PARAMETERS c Specifies the wide character to be written. DESCRIPTION The spt_putwcharx( ) function is the thread-aware version of the putwchar( ) function.
System Functions (s and S) spt_putwcharx(2) [EBADF] The file descriptor underlying the standard output stream is not a valid file descriptor open for writing. [EFBIG] An attempt was made to write to a file that exceeds the process’s file size limit or the maximum file size. [EILSEQ] The wide character code specified by the c parameter does not correspond to a valid character. [EINTR] The operation was interrupted by a signal that was caught, and no data was transferred.
spt_putwcx(2) OSS System Calls Reference Manual NAME spt_putwcx - Writes a wide character to a specified stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include wint_t spt_putwcx ( wint_t c, FILE *stream ); PARAMETERS c Specifies the wide character to be written. stream Points to the output data.
System Functions (s and S) spt_putwcx(2) ERRORS If any of these conditions occur, the spt_putwcx( ) function sets errno to the corresponding value: [EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying stream and the process would be delayed in the write operation. [EBADF] The file descriptor underlying stream is not a valid file descriptor open for writing. [EFBIG] An attempt was made to write to a file that exceeds the process’s file size limit or the maximum file size.
spt_putwx(2) OSS System Calls Reference Manual NAME spt_putwx - Writes a word to a stream (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int spt_putwx ( int w, FILE *stream ); PARAMETERS stream Points to the file structure of an open file. w Specifies the word to be written.
System Functions (s and S) spt_putwx(2) before including spthread.h: #define SPT_THREAD_AWARE_PRAGMA_NONBLOCK RETURN VALUES The spt_putwx( ) function, upon successful completion, returns a value of 0 (zero). Otherwise, it returns a nonzero value. If the file descriptor underlying stream becomes invalid (is closed by another thread), a nonzero value is returned with an errno value of [EBADF].
spt_putwx(2) OSS System Calls Reference Manual STANDARDS CONFORMANCE This function is an extension to the UNIX 98 specification. Interfaces documented on this reference page conform to the following industry standards: — IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
System Functions (s and S) spt_read(2) NAME spt_read - Initiates thread-aware read( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include ssize_t spt_read( int filedes, void *buffer, size_t nbytes); PARAMETERS See the read(2) reference page. DESCRIPTION This is a thread-aware version of the read( function. Note that file descriptor must be nonblocking for this function to be thread-aware.
SPT_READLOCKX(2) OSS System Calls Reference Manual NAME SPT_READLOCKX - Sequentially locks and reads records in a Guardian disk file LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include
System Functions (s and S) SPT_READLOCKX(2) Use for key-sequenced, relative, and entry-sequenced files For key-sequenced, relative, and entry-sequenced files, a subset of the file (defined by the current access path, positioning mode, and comparison length) is locked and read with successive calls to SPT_READLOCKX( ). For key-sequenced, relative, and entry-sequenced files, the first call to SPT_READLOCKX( ) after a positioning (or open) locks and then returns the first record of the subset.
SPT_READLOCKX(2) OSS System Calls Reference Manual — A selectable extended data segment containing the buffer need not be in use at the time of the call to AWAITIOX. — You can cancel Nowait I/O initiated with SPT_READLOCKX( ) with a call to SPT_CANCEL( ) or CANCELREQ. The I/O is canceled if the file is closed before the I/O completes or if the Guardian AWAITIOX procedure is called with a positive time limit and specific file number and the request times out.
System Functions (s and S) SPT_READUPDATELOCKX(2) NAME SPT_READUPDATELOCKX - Allows random processing of records in a Guardian disk file LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include
SPT_READUPDATELOCKX(2) Considerations Buffer use OSS System Calls Reference Manual SPT_READUPDATELOCKX( ) is intended for use with 32-bit extended addresses. Therefore, the data buffer for SPT_READUPDATELOCKX( ) can be either in the caller’s stack segment or any extended data segment. Nowait I/O and SPT_READUPDATELOCKX( ) The SPT_READUPDATELOCKX( ) function must complete with a corresponding call to the Guardian AWAITIOX procedure when used with a file that is opened for nowait I/O.
System Functions (s and S) SPT_READUPDATELOCKX(2) — You can cancel nowait I/O initiated with SPT_READUPDATELOCKX( ) with a call to SPT_CANCEL( ) or CANCELREQ. The I/O is canceled if the file is closed before the I/O completes or if the Guardian AWAITIOX procedure is called with a positive time limit and specific file number and the request times out.
SPT_READUPDATEX(2) OSS System Calls Reference Manual NAME SPT_READUPDATEX - Reads data from a Guardian disk or process file in anticipation of a subsequent write to the file LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include
System Functions (s and S) SPT_READUPDATEX(2) Interprocess communication SPT_READUPDATEX( ) reads a message from the $RECEIVE file that is answered in a later call to the Guardian REPLYX procedure. Each message read by SPT_READUPDATEX( ) must be replied to in a corresponding call to REPLYX. For programming information about the READUPDATEX procedure, see the Enscribe Programmer’s Guide and the Guardian Programmer’s Guide.
SPT_READUPDATEX(2) OSS System Calls Reference Manual RETURN VALUES The SPT_READUPDATEX( ) function returns 0 (zero) upon successful completion. Otherwise, this function returns a nonzero Guardian file-system error number that indicates the outcome of the operation. For information about Guardian file-system error numbers, see the Guardian Procedure Errors and Messages Manual. ERRORS None. This function does not set the errno variable.
System Functions (s and S) spt_readv(2) NAME spt_readv - Initiates thread-aware readv( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include ssize_t spt_readv( int filedes, struct iovec *iov, int iov_count); PARAMETERS See the readv(2) reference page. DESCRIPTION This is a thread-aware version of the readv( ) function. The file descriptor must be nonblocking for this function to be thread-aware.
spt_readvx(2) OSS System Calls Reference Manual NAME spt_readvx - Reads from a file into scattered buffers (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] [#include ] #include
System Functions (s and S) spt_readvx(2) — If no process has the pipe open for writing, the spt_readvx( ) function returns the value 0 (zero) to indicate EOF. — If some process has the pipe open for writing: — If the O_NONBLOCK flag is not set, the spt_readvx( ) function blocks until either some data is written or the pipe is closed by all processes that had opened the pipe for writing. — If the O_NONBLOCK flag is set, the spt_readvx( ) function returns the value -1 and sets errno to [EAGAIN].
spt_readvx(2) OSS System Calls Reference Manual NOTES The macro to map readv( ) to spt_readvx( ) is available in C applications when SPT_THREAD_AWARE_NONBLOCK has been defined in the following manner before including spthread.h: #define SPT_THREAD_AWARE_NONBLOCK The alias to link readv( ) to spt_readvx( ) is available in C++ applications when SPT_THREAD_AWARE_PRAGMA_NONBLOCK has been defined in the following manner before including spthread.
System Functions (s and S) spt_readvx(2) [EFILEBAD] An attempt was made to read from a Guardian EDIT file (a file in /G with file code 101) with a corrupted internal structure. [EINTR] An spt_readvx( ) operation was interrupted by a signal before any data arrived. [EINVAL] One of these conditions occurred: — The sum of the iov_len values in the iov array was negative or overflowed a data item of type ssize_t.
spt_readvx(2) OSS System Calls Reference Manual Guardian Procedure Errors and Messages Manual. RELATED INFORMATION Functions: creat(2), dup(2), fcntl(2), ioctl(2), lseek(2), open(2), opendir(3), pipe(2), readv(2), socket(2). socketpair(2), spt_fcntlx(2), spt_readv(2). STANDARDS CONFORMANCE This function is an extension to the UNIX 98 specification. Interfaces documented on this reference page conform to the following industry standards: — IEEE Std 1003.
System Functions (s and S) SPT_READX(2) NAME SPT_READX - Returns data from an open Guardian file to the application process data area LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include
SPT_READX(2) OSS System Calls Reference Manual Waited SPT_READX( ) If a waited SPT_READX( ) call is executed, the count_read parameter indicates the number of bytes actually read. Nowait SPT_READX( ) If a nowait SPT_READX( ) call is executed, count_read has no meaning and can be omitted. The count of the number of bytes read is obtained through the count-transferred parameter of the Guardian AWAITIOX procedure when the I/O operation completes.
System Functions (s and S) SPT_READX(2) Use on files opened for nowait I/O — If the buffer is in an extended data segment, you cannot deallocate or reduce the size of the extended data segment before the I/O completes with a call to the Guardian AWAITIOX procedure or is canceled by a call to the SPT_CANCEL( ) function or the Guardian CANCELREQ procedure. — You must not modify the buffer before the I/O completes with a call to the Guardian AWAITIOX procedure.
SPT_READX(2) OSS System Calls Reference Manual Transfer sizes over 4 KB are not supported in default mode for unstructured access to structured files. Large data transfers using SPT_SETMODE(141) For SPT_READX( ) only, large data transfers (more than 4096 bytes) can be done for unstructured access to structured or unstructured files, regardless of unstructured buffer size, by using SPT_SETMODE( ) function 141.
System Functions (s and S) SPT_READX(2) Indicators after PT_READX( ) call After a successful SPT_READX( ) call, the currentstate indicators have these values: — Current position is the record just read. — Positioning mode is unchanged. — Comparison length is unchanged. — Current primary-key value is set to the value of the primary-key field in the record. Unstructured files Data transfer Data transfer begins from an unstructured disk file at the position indicated by the next-record pointer.
SPT_READX(2) OSS System Calls Reference Manual Pointers after an SPT_READX( ) call After a successful SPT_READX( ) call to an unstructured file, the file pointers are: — Current-record pointer is old next-record pointer. — Next-record pointer is old next-record pointer plus count_read. RETURN VALUES The SPT_READX( ) function returns 0 (zero) upon successful completion. Otherwise, this function returns a nonzero Guardian file-system error number that indicates the outcome of the operation.
System Functions (s and S) spt_readx(2) NAME spt_readx - Reads from a file (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] [#include ] #include
spt_readx(2) OSS System Calls Reference Manual data, regardless of the size of PIPE_BUF. If the buffer cannot be resized for the write operation, a read from the pipe or FIFO file does not return more than 8192 bytes per call, regardless of the setting of O_NONBLOCK. When attempting to read from an empty pipe (or FIFO file): — If no process has the pipe open for writing, the spt_readx( ) function returns the value 0 (zero) to indicate EOF.
System Functions (s and S) spt_readx(2) NOTES The macro to map read( ) to spt_readx( ) is available in C applications when SPT_THREAD_AWARE_NONBLOCK has been defined in the following manner before including spthread.h: #define SPT_THREAD_AWARE_NONBLOCK The alias to link read( ) to spt_readx( ) is available in C++ applications when SPT_THREAD_AWARE_PRAGMA_NONBLOCK has been defined in the following manner before including spthread.
spt_readx(2) OSS System Calls Reference Manual [EINVAL] The value of the nbytes parameter is greater than SSIZE_MAX. [EIO] One of these conditions occurred: — The process is a member of a background process group attempting to read from its controlling terminal, the process is ignoring or blocking the SIGTTIN signal, or the process group is orphaned. — A physical I/O error occurred. Data might have been lost during a transfer. [EISDIR] An spt_readx( ) operation was attempted against a directory.
System Functions (s and S) spt_RECEIVEREAD(2) NAME spt_RECEIVEREAD - Initiates thread-aware function for reading $RECEIVE LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
spt_RECEIVEREAD(2) OSS System Calls Reference Manual — spt_interrupt(0, SPT_ERROR). — spt_interrupt(0, SPT_TIMEDOUT). Using any of these calls also cancels the input/output operation. RETURN VALUES This function returns Guardian file-system error numbers including: 16 filenum is not registered. STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this reference page conform to the following industry standards: — IEEE Std 1003.
System Functions (s and S) spt_recv(2) NAME spt_recv - Initiates thread-aware recv( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include ssize_t spt_recv( int socket, void *buffer, size_t length, int flags); PARAMETERS See the recv(2) reference page. DESCRIPTION This is a thread-aware version of the recv( ) function. The socket must be nonblocking for this function to be thread-aware.
spt_recvfrom(2) OSS System Calls Reference Manual NAME spt_recvfrom - Initiates thread-aware recvfrom( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include ssize_t spt_recvfrom( int socket, void *buffer, size_t length, int flags, struct sockaddr *address, size_t *address_len); PARAMETERS See the recvfrom(2) reference page. DESCRIPTION This is a thread-aware version of the recvfrom( ) function.
System Functions (s and S) spt_recvfromx(2) NAME spt_recvfromx - Receives a message from a socket (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include ssize_t spt_recvfromx ( int socket, void *buffer, size_t length, int flags, struct sockaddr *address, size_t *address_len ); PARAMETERS socket Specifies the file descriptor of the socket.
spt_recvfromx(2) OSS System Calls Reference Manual For message-based sockets (sockets of type SOCK_DGRAM), the entire message must be read in one call. If a message is too long to fit in the supplied buffer and MSG_PEEK is not set in the flags parameter, the excess bytes are discarded. For stream-based sockets (sockets of type SOCK_STREAM), message boundaries are ignored. For such sockets, data is returned as soon as it becomes available; no data is discarded.
System Functions (s and S) spt_recvfromx(2) — The TCP/IP subsystem for this socket is no longer available. — The connection was forcibly closed by the peer socket. The socket can only be closed. [EFAULT] A user-supplied memory buffer cannot be accessed or written. [EINTR] A signal interrupted the function before any data was available. [EINVAL] The MSG_OOB value is specified in the flags parameter and no out-ofband data is available. [EIO] An input or output error occurred.
spt_recvmsg(2) OSS System Calls Reference Manual NAME spt_recvmsg - Initiates thread-aware recvmsg(2) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include ssize_t spt_recvmsg( int socket, struct msghdr *message, int flags); PARAMETERS See the recvmsg(2) reference page. DESCRIPTION This is a thread-aware version of the recvmsg( ) function.
System Functions (s and S) spt_recvmsgx(2) NAME spt_recvmsgx - Receives a message from a socket using a message structure (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include ssize_t spt_recvmsgx ( int socket, struct msghdr *message, int flags ); PARAMETERS socket Specifies the file descriptor of the socket.
spt_recvmsgx(2) OSS System Calls Reference Manual in one call. If a message is too long to fit in the supplied buffer and MSG_PEEK is not set in the flags parameter, the excess bytes are discarded, and MSG_TRUNC is set in the msg_flags field of the msghdr structure. For stream-based sockets (sockets of type SOCK_STREAM), message boundaries are ignored. For such sockets, data is returned as soon as it becomes available; no data is discarded.
System Functions (s and S) spt_recvmsgx(2) #define SPT_THREAD_AWARE_PRAGMA_NONBLOCK When data is available, a call to the select( ) function indicates that the file descriptor for the socket is ready for reading. RETURN VALUES Upon successful completion, the spt_recvmsgx( ) function returns the length of the received message in bytes. If no data is available and the peer socket has performed an orderly shutdown, 0 (zero) is returned.
spt_recvmsgx(2) OSS System Calls Reference Manual [EMFILE] The socket is in the AF_UNIX domain, and processing the cmsghdr structure would cause the receiving process to exceed OPEN_MAX. [ENOBUFS] Not enough buffer space was available to complete the call. A retry at a later time might succeed. [ENOMEM] Required memory resources were not available. A retry at a later time might succeed. [ENOTCONN] A receive operation was attempted on a connection-oriented socket that is not connected.
System Functions (s and S) spt_recvx(2) NAME spt_recvx - Receives a message from a connected socket (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include ssize_t spt_recvx ( int socket, void *buffer, size_t length, int flags ); PARAMETERS socket Specifies the file descriptor of the socket. buffer Points to the buffer where the message should be written.
spt_recvx(2) OSS System Calls Reference Manual The alias to link recv( ) to spt_recvx( ) is available in C++ applications when SPT_THREAD_AWARE_PRAGMA_NONBLOCK has been defined in the following manner before including spthread.h: #define SPT_THREAD_AWARE_PRAGMA_NONBLOCK When data is available, a call to the select( ) function indicates that the file descriptor for the socket is ready for reading.
System Functions (s and S) spt_recvx(2) [ENOTSOCK] The socket parameter does not refer to a socket. [EOPNOTSUPP] The specified value for the flags parameter is not supported for this socket type or protocol. [ETIMEDOUT] A transmission timed out on an active connection. [EWOULDBLOCK] The socket file descriptor is marked nonblocking (O_NONBLOCK is set) and the operation would block.
spt_regFile(2) OSS System Calls Reference Manual NAME spt_regFile - Registers the file number LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include spt_error_t spt_regFile( const short filenum); PARAMETERS filenum Specifies the Guardian file number of the file being registered DESCRIPTION Registers the file number as one that the user will manage through the default callback.
System Functions (s and S) spt_regFileIOHandler(2) NAME spt_regFileIOHandler - Registers the file number LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include spt_error_t spt_regFileIOHandler( const short filenum, const spt_FileIOHandler_p functionPtr); PARAMETERS filenum Specifies the Guardian file number for the file being registered functionPtr Specifies user-supplied callback.
spt_regOSSFileIOHandler(2) OSS System Calls Reference Manual NAME spt_regOSSFileIOHandler - Registers the file descriptor to manage through a callback function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
System Functions (s and S) spt_regPathsendFile(2) NAME spt_regPathsendFile - Registers the Pathsend file number LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include spt_error_t spt_regPathsendFile( const short fileno ); PARAMETERS fileno Contains the scsend-op-num value obtained during the first nowaited SERVERCLASS_SEND_, SERVERCLASS_DIALOG_BEGIN_, or SERVERCLASS_DIALOG_SEND_ procedure call.
spt_regPathsendTagHandler(2) OSS System Calls Reference Manual NAME spt_regPathsendTagHandler - Registers the user-supplied Pathsend tag LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include spt_error_t spt_regPathsendTagHandler( const long tag, spt_FileIOHandler_p callback, void * userdata ); PARAMETERS tag Specifies the Pathsend tag that should be registered.
System Functions (s and S) spt_regPathsendTagHandler(2) RELATED INFORMATION Functions: spt_unregPathsendTagHandler(2), SPT_SERVERCLASS_DIALOG_ABORT_(2), SPT_SERVERCLASS_DIALOG_BEGIN_(2), SPT_SERVERCLASS_DIALOG_END_(2), SPT_SERVERCLASS_DIALOG_SEND_(2), SPT_SERVERCLASS_SEND_INFO_(2), SPT_SERVERCLASS_SEND_(2). STANDARDS CONFORMANCE This function is an extension to the UNIX98 specification. Interfaces documented on this reference page conform to the following industry standards: — IEEE Std 1003.
spt_regTimerHandler(2) OSS System Calls Reference Manual NAME spt_regTimerHandler - Registers a user-supplied timer callback function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
System Functions (s and S) spt_REPLYX(2) NAME spt_REPLYX - Initiates thread-aware REPLYX procedure call LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
spt_select(2) OSS System Calls Reference Manual NAME spt_select - Initiates thread-aware select( ) function for mulitple file descriptors LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_select( int nfds, fd_set *readfds, fd_set *writefds, fd_set *errorfds, struct timeval *timeout); PARAMETERS See the select(2) reference page.
System Functions (s and S) spt_select(2) RETURN VALUES See the select(2) reference page. The following information also applies: — If the file descriptor becomes invalid (is closed by another thread), -1 is returned with an errno of [EBADF]. — If a signal is received via the pthread_kill( ) function and is not blocked, ignored, or handled, -1 is returned with an errno value of [EINTR]. RELATED INFORMATION Functions: select(2), spt_select_single_np(2).
spt_select_single_np(2) OSS System Calls Reference Manual NAME spt_select_single_np - Initiates thread-aware select( ) function for a single file descriptor LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_select_single_np( int nfds, fd_set *readfds, fd_set *writefds, fd_set *errorfds, struct timeval *timeout); PARAMETERS See the select(2) reference page.
System Functions (s and S) spt_select_single_np(2) NOTES To use a combination of the spt_select( ) and the spt_select_single_np( ) functions in a single source file, you must explicitly call these functions. RETURN VALUES See the select(2) reference page. The following information also applies: — If the file descriptor becomes invalid (is closed by another thread), -1 is returned with an errno of [EBADF].
spt_send(2) OSS System Calls Reference Manual NAME spt_send - Initiates thread-aware send( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include ssize_t spt_send( int socket, const void *buffer, size_t length, int flags); PARAMETERS See the send(2) reference page. DESCRIPTION This is a thread-aware version of the send( ) function. The socket must be nonblocking for this function to be thread-aware.
System Functions (s and S) spt_sendmsg(2) NAME spt_sendmsg - Initiates thread-aware sendmsg( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include ssize_t spt_sendmsg( int socket, const struct msghdr *message, int flags); PARAMETERS See the sendmsg(2) reference page. DESCRIPTION This is a thread-aware version of the sendmsg( ) function.
spt_sendmsgx(2) OSS System Calls Reference Manual NAME spt_sendmsgx - Sends a message on a socket using a message structure (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include ssize_t spt_sendmsgx ( int socket, const struct msghdr *message, int flags ); PARAMETERS socket Specifies the file descriptor of the socket.
System Functions (s and S) spt_sendmsgx(2) Successful completion of a call to spt_sendmsgx( ) does not imply successful delivery of the message. A return value of -1 indicates only locally detected errors. If the sending socket has no space to hold the message to be transmitted and the socket’s file descriptor is blocking (O_NONBLOCK is not set), the spt_sendmsgx( ) function blocks until space is available.
spt_sendmsgx(2) OSS System Calls Reference Manual structure or write access to the specified socket is denied. [EAFNOSUPPORT] You cannot use addresses in the specified address family with this socket. [EBADF] One of these conditions exists: — The socket parameter is not a valid file descriptor. — The socket is in the AF_UNIX domain, and one or more of the file descriptors being passed is invalid.
System Functions (s and S) spt_sendmsgx(2) [EIO] The socket is in the AF_UNIX domain, and the transport agent failed to inherit the file descriptors being passed, or an input or output error occurred. [ELOOP] The socket is in the AF_UNIX domain, and too many symbolic links were encountered in translating the pathname specified by the msghdr structure. [EMSGSIZE] The message is too large to be sent all at once, as required by the socket.
spt_sendmsgx(2) OSS System Calls Reference Manual [EOPNOTSUPP] The specified value for the flags parameter is not supported for this socket type or protocol. [EPIPE] One of these conditions occurred: — An attempt was made to send a message on a socket that is shut down for writing. — An attempt was made to send a message on a connection-oriented socket, and the peer socket is closed or shut down for reading. The SIGPIPE signal is also sent to the calling process.
System Functions (s and S) spt_sendto(2) NAME spt_sendto - Initiates thread-aware sendto( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include ssize_t spt_sendto( int socket, const void *buffer, size_t length, int flags, const struct sockaddr *dest_addr, size_t dest_len); PARAMETERS See the sendto(2) reference page. DESCRIPTION This is a thread-aware version of the sendto( ) function.
spt_sendtox(2) OSS System Calls Reference Manual NAME spt_sendtox - Sends a message on a socket (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include ssize_t spt_sendtox ( int socket, const void *message, size_t length, int flags, const struct sockaddr *dest_addr, size_t dest_len ); PARAMETERS socket Specifies the file descriptor of the socket.
System Functions (s and S) dest_len spt_sendtox(2) Specifies the length of the sockaddr structure pointed to by the dest_addr parameter. DESCRIPTION The spt_sendtox( ) function is the thread-aware version of the sendto( ) function. The spt_sendtox( ) function sends a message through a connection-oriented or connectionless socket. If the socket is connectionless, the message is sent to the address specified in the sockaddr structure pointed to by the dest_addr parameter.
spt_sendtox(2) OSS System Calls Reference Manual [EBADF] The socket parameter is not a valid file descriptor. [ECONNRESET] One of the following conditions occurred: — The transport-provider process for this socket is no longer available. — The TCP/IP subsystem for this socket is no longer available. — The connection was forcibly closed by the peer socket. The socket can only be closed.
System Functions (s and S) spt_sendtox(2) [ENETDOWN] The local interface used to reach the destination is down. [ENETUNREACH] No route to the network or host is present. [ENOBUFS] Not enough buffer space was available to complete the call. A retry at a later time might succeed. [ENOENT] The socket is in the AF_UNIX domain and one of the following conditions exists: — A component of the pathname specified in the sockaddr structure does not name an existing file.
spt_sendx(2) OSS System Calls Reference Manual NAME spt_sendx - Sends a message on a connected socket (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include ssize_t spt_sendx ( int socket, const void *buffer, size_t length, int flags ); PARAMETERS socket Specifies the file descriptor of the socket. buffer Points to the buffer containing the message to send.
System Functions (s and S) spt_sendx(2) NOTES The macro to map send( ) to spt_sendx( ) is available in C applications when SPT_THREAD_AWARE_NONBLOCK has been defined in the following manner before including spthread.h: #define SPT_THREAD_AWARE_NONBLOCK The alias to link send( ) to spt_sendx( ) is available in C++ applications when SPT_THREAD_AWARE_PRAGMA_NONBLOCK has been defined in the following manner before including spthread.
spt_sendx(2) OSS System Calls Reference Manual [ENETDOWN] The local interface used to reach the destination is down. [ENETUNREACH] No route to the network or host is present. [ENOBUFS] Not enough buffer space was available to complete the call. A retry at a later time might succeed. [ENOMEM] Required memory resources were not available. A retry at a later time might succeed. [ENOTCONN] The socket either is not connected or has not had the peer socket previously specified.
System Functions (s and S) SPT_SETMODE(2) NAME SPT_SETMODE - Sets device-dependent Guardian file-system functions LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include
SPT_SETMODE(2) OSS System Calls Reference Manual Considerations Default settings The SPT_SETMODE( ) settings designated as default in the Guardian Procedure Calls Reference Manual are the values that apply when a file is opened (not if a particular function value is omitted when SPT_SETMODE( ) is called). Waited SPT_SETMODE( ) use The SPT_SETMODE( ) function is used on a file as a waited operation even if filenum has been opened for nowait operations.
System Functions (s and S) SPT_SETMODE(2) ERRORS None. This function does not set the errno variable. RELATED INFORMATION Functions: SPT_CANCEL(2), SPT_CONTROL(2), SPT_FILE_CLOSE_(2), SPT_FILE_OPEN_(2), SPT_LOCKFILE(2), SPT_LOCKREC(2), SPT_READLOCKX(2), SPT_READUPDATELOCKX(2), SPT_READUPDATEX(2), SPT_READX(2), SPT_UNLOCKFILE(2), SPT_UNLOCKREC(2), SPT_WRITEREADX(2), SPT_WRITEUPDATEUNLOCKX(2), SPT_WRITEUPDATEX(2), SPT_WRITEX(2).
spt_setOSSFileIOHandler(2) OSS System Calls Reference Manual NAME spt_setOSSFileIOHandler - Sets interest in file descriptor LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
System Functions (s and S) spt_setTMFConcurrentTransactions(2) NAME spt_setTMFConcurrentTransactions - Sets the number of concurrent TMF transactions LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_setTMFConcurrentTransactions ( short max_trans ); PARAMETERS max_trans Specifies the maximum number of concurrent transactions desired.
spt_sigaction(2) OSS System Calls Reference Manual NAME spt_sigaction - Specifies the action to take upon delivery of a signal (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_sigaction( int sig, const sigaction_t *act, sigaction_t *o_action ); PARAMETERS sig Specifies the signal number.
System Functions (s and S) spt_sigaction(2) ERRORS If one of these conditions occurs, the spt_sigaction( ) function sets errno to [EINVAL]: [EINVAL] One of the following conditions exists: — The sig parameter is not a valid signal number. — An attempt was made to ignore or supply a signalcatching function for the SIGKILL, SIGSTOP, or SIGABEND signal. — The signal is not supported in pthreads.
spt_signal(2) OSS System Calls Reference Manual NAME spt_signal - Installs a new signal handler LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include void * spt_signal(int sig, void (* *Vhandler)(int)) PARAMETERS sig Specifies the signal number. handler User-specified signal function that acts a signal handler.
System Functions (s and S) spt_signal(2) For C++ applications, this mapping is available only when you define the correct preprocessor before you include spthread.h: #define SPT_THREAD_SIGNAL_PRAGMA #include RETURN VALUES Upon successful completion the spt_signal( ) function returns the value of the previous signal action. Otherwise, the value SIG_ERR is retuned and errno is set indicate the error. NOTE: SIG_ERR is not a valid value for a signal-catching function.
spt_sigpending(2) OSS System Calls Reference Manual NAME spt_sigpending - Examines signals that are blocked and pending LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_sigpending(sigset_t *set); PARAMETERS set Specifies the set of signals that are blocked and pending.
System Functions (s and S) spt_sigsuspend(2) NAME spt_sigsuspend - Changes the set of blocked signals and waits for a signal LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_sigsuspend(const sigset_t *sset); PARAMETERS sset Specifies the set of signals to be blocked from delivery to the calling thread.
spt_sigsuspend(2) OSS System Calls Reference Manual RELATED INFORMATION Functions: pthread_kill(2), pthread_sigmask(2), sigsuspend(2), spt_pause(2), spt_sigaction(2), spt_signal(2),. STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this reference page conform to the following industry standards: — IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.
System Functions (s and S) spt_sigwait(2) NAME spt_sigwait - Causes the calling thread to wait for a signal LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/sysnn/zsptdll SYNOPSIS #include int spt_sigwait( sigset_t *set int *sig); PARAMETERS set specifies the set of signals that the calling thread will wait for. sig receives the signal number cleared from the specified set of signal numbers.
spt_sleep(2) OSS System Calls Reference Manual NAME spt_sleep - Suspends execution of the thread for a specified time interval LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include unsigned int spt_sleep ( unsigned int seconds ); PARAMETERS seconds Specifies the number of seconds for which the thread is to be suspended. DESCRIPTION The spt_sleep( ) function suspends a thread for a specified number of seconds.
System Functions (s and S) spt_system(2) NAME spt_system - Initiates thread-aware system( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_system( const char *command); PARAMETERS See the system(3) reference page. DESCRIPTION This is a thread-aware version of the system( ) function.
spt_TimerHandler_p(2) OSS System Calls Reference Manual NAME spt_TimerHandler_p - Executes callback type required by spt_regTimerHandler( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include typedef long (*spt_TimerHandler_p)(void); PARAMETERS None. DESCRIPTION This function executes a callback type required by the spt_regTimerHandler( ) function.
System Functions (s and S) SPT_TMF_GetTxHandle(2) NAME SPT_TMF_GetTxHandle - Gets the current TMF transaction handle LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include short SPT_TMF_GetTxHandle( SPT_TMF_TxHandle_t *tx_handle ); PARAMETERS tx_handle Receives the current active TMF transaction handle. DESCRIPTION This function retrieves the current active transaction handle of the thread.
SPT_TMF_Init(2) OSS System Calls Reference Manual NAME SPT_TMF_Init - Initializes the tfile for concurrent transaction management LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include short SPT_TMF_Init( void ); PARAMETERS None. DESCRIPTION This function opens the tfile for concurrent transaction management. RETURN VALUES SPT_SUCCESS The TMF file is initialized for concurrent transaction management.
System Functions (s and S) SPT_TMF_SetTxHandle(2) NAME SPT_TMF_SetTxHandle - Sets the TMF transaction handle LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include short SPT_TMF_SetTxHandle( SPT_TMF_TxHandle_t *tx_handle ); PARAMETERS tx_handle Specifies the transaction handle of the current TMF transaction.
SPT_UNLOCKFILE(2) OSS System Calls Reference Manual NAME SPT_UNLOCKFILE - Unlocks a disk file and any records in that file currently locked by the user LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include short SPT_UNLOCKFILE ( short filenum, [long tag ] ); PARAMETERS filenum specifies the Guardian file number of a Guardian file open instance for the file that you want unlocked.
System Functions (s and S) SPT_UNLOCKFILE(2) — read the file, its read is processed. Transaction Management Facility (TMF) and SPT_UNLOCKFILE( ) If the current transaction modifies a file audited by TMF, locks on the file are released only when TMF ends or aborts the transaction. In other words, a locked audited file that the current transaction modified is unlocked during SPT_ENDTRANSACTION( ) or SPT_ABORTTRANSACTION( ) processing for that file.
SPT_UNLOCKREC(2) OSS System Calls Reference Manual NAME SPT_UNLOCKREC - unlocks a Guardian file record currently locked by the user LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include short SPT_UNLOCKREC ( short filenum, [long tag ] ); PARAMETERS filenum specifies the Guardian file number of a Guardian file open instance for the file containing the record you want unlocked.
System Functions (s and S) SPT_UNLOCKREC(2) Calling SPT_UNLOCKREC( ) after KEYPOSITION If the call to SPT_UNLOCKREC( ) immediately follows a call to KEYPOSITION where a nonunique alternate key is specified, the SPT_UNLOCKREC( ) call fails. A subsequent call to FILE_GETINFO_ or FILEINFO shows that Guardian filesystem error 46 (invalid key) occurred. However, if an intermediate call to SPT_READX( ) or SPT_READLOCKX( ) is performed, the call to SPT_UNLOCKREC( ) is permitted.
SPT_UNLOCKREC(2) OSS System Calls Reference Manual STANDARDS CONFORMANCE This function is an extension to the UNIX 98 specification. Interfaces documented on this reference page conform to the following industry standards: — IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
System Functions (s and S) spt_unregFile(2) NAME spt_unregFile - Unregisters a Guardian file number as one that the user manages LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include extern spt_error_t spt_unregFile( const short filenum); PARAMETERS filenum Specifies the Guardian file number being unregistered DESCRIPTION This function unregisters a Guardian file number as one that the user manages.
spt_unregOSSFileIOHandler(2) OSS System Calls Reference Manual NAME spt_unregOSSFileIOHandler - Unregisters an OSS file descriptor LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include extern spt_error_t spt_unregOSSFileIOHandler( const int filedes); PARAMETERS filedes Specifies the OSS file descriptor being unregistered DESCRIPTION This function unregisters an OSS file descriptor as one that the user manages.
System Functions (s and S) spt_unregPathsendTagHandler(2) NAME spt_unregPathsendTagHandler - Unregisters the user-supplied Pathsend tag LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include spt_error_t spt_unregPathsendTagHandler ( const long tag ); PARAMETERS tag Specifies the Pathsend tag to be unregistered. DESCRIPTION This function unregisters the specified Pathsend tag as a tag that user manages.
spt_usleep(2) OSS System Calls Reference Manual NAME spt_usleep - Suspends execution of the thread for a specified number of microseconds LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_usleep ( unsigned int useconds ); PARAMETERS useconds Specifies the number of microseconds for which the thread is to be suspended. The value specified must be less than or equal to 1000000.
System Functions (s and S) spt_vfprintf(2) NAME spt_vfprintf - Initiates thread-aware vfprintf( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_vfprintf( FILE *stream, const char *format, va_list printarg); PARAMETERS See the vfprintf(3) reference page either online or in the Open System Services Library Calls Reference Manual.
spt_vfprintfx(2) OSS System Calls Reference Manual NAME spt_vfprintfx - Formats a variable number of parameters for output (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] [#include ] #include int spt_vfprintfx ( FILE *stream, const char *format, va_list printarg ); PARAMETERS stream Specifies the output stream.
System Functions (s and S) spt_vfprintfx(2) #define SPT_THREAD_AWARE_NONBLOCK #include void { error(char *funct, char *fmt, ...) va_list args; /* ** Display the name of the function that called error */ spt_fprintfx(stderr, "ERROR in %s: ", funct); /* ** Display the remainder of the message */ va_start(args, fmt); spt_vfprintfx(stderr, fmt, args); va_end(args); abort(); } RETURN VALUES Upon successful completion, this function returns the number of bytes in the output string.
spt_vfprintfx(2) OSS System Calls Reference Manual [ENOMEM] Insufficient storage space was available. [ENOSPC] No free space was remaining on the device containing the file. [ENXIO] A request was made of a nonexistent device, or the request was outside the capabilities of the device. [EPIPE] An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process.
System Functions (s and S) spt_vprintf(2) NAME spt_vprintf - Initiates thread-aware vprintf( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include int spt_vprintf( const char *format, va_list printarg); PARAMETERS See the vprintf(3) reference page either online or in the Open System Services Library Calls Reference manual. DESCRIPTION This is a thread-aware version of the vprintf( ) function.
spt_vprintfx(2) OSS System Calls Reference Manual NAME spt_vprintfx - Formats a variable number of parameters for output (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] [#include ] #include
System Functions (s and S) spt_vprintfx(2) [EBADF] The file descriptor underlying the output stream is not a valid file descriptor open for writing. [EFBIG] An attempt was made to write to a file that exceeds the process’s file size limit or the maximum file size. [EILSEQ] An invalid wide character was detected. [EINTR] The operation was interrupted by a signal that was caught, and no data was transferred. [EINVAL] There are insufficient arguments.
spt_waitpid(2) OSS System Calls Reference Manual NAME spt_waitpid - Initiates thread-aware waitpid( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include pid_t spt_waitpid( pid_t pid, int *stat_loc, int options); PARAMETERS See the waitpid(2) reference page. DESCRIPTION This is a thread-aware version of the waitpid( ) function. The socket must be nonblocking for this function to be thread-aware.
System Functions (s and S) spt_waitpid(2) STANDARDS CONFORMANCE This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this reference page conform to the following industry standards: — IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
spt_wakeup(2) OSS System Calls Reference Manual NAME spt_wakeup - Wakes up a thread awaiting tagged I/O LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
System Functions (s and S) spt_write(2) NAME spt_write - Initiates thread-aware write( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include ssize_t spt_write( int filedes, void *buffer, size_t nbytes); PARAMETERS See the write(2) reference page. DESCRIPTION This is a thread-aware version of the write( ) function. The file descriptor must be nonblocking for this function to be thread-aware.
SPT_WRITEREADX(2) OSS System Calls Reference Manual NAME SPT_WRITEREADX - Writes data to a Guardian file from an array and waits for data to be read back from the file LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include
System Functions (s and S) SPT_WRITEREADX(2) Considerations Buffer use SPT_WRITEREADX( ) is intended for use with 32-bit extended addresses. Therefore, the data buffer for SPT_WRITEREADX( ) can be either in the caller’s stack segment or any extended data segment. Terminals A special hardware feature is incorporated in the asynchronous multiplexer controller that ensures the system is ready to read from the terminal as soon as the write is completed.
SPT_WRITEREADX(2) OSS System Calls Reference Manual Use on files opened for nowait I/O — If the buffer is in an extended data segment, you cannot deallocate or reduce the size of the extended data segment before the I/O completes with a call to the Guardian AWAITIOX procedure or is canceled by a call to the SPT_CANCEL( ) function or the Guardian CANCELREQ procedure. — You must not modify the buffer before the I/O completes with a call to the Guardian AWAITIOX procedure.
System Functions (s and S) SPT_WRITEREADX(2) STANDARDS CONFORMANCE This function is an extension to the UNIX 98 specification. Interfaces documented on this reference page conform to the following industry standards: — IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
SPT_WRITEUPDATEUNLOCKX(2) OSS System Calls Reference Manual NAME SPT_WRITEUPDATEUNLOCKX - Performs random processing of records in a disk file LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include
System Functions (s and S) SPT_WRITEUPDATEUNLOCKX(2) Considerations Buffer use SPT_WRITEUPDATEUNLOCKX( ) is intended for use with 32-bit extended addresses. Therefore, the data buffer for SPT_WRITEUPDATEUNLOCKX( ) can be either in the caller’s stack segment or any extended data segment. Nowait I/O and SPT_WRITEUPDATEUNLOCKX( ) The SPT_WRITEUPDATEUNLOCKX( ) function must complete with a corresponding call to the Guardian AWAITIOX procedure when used with a file that is opened for nowait I/O.
SPT_WRITEUPDATEUNLOCKX(2) OSS System Calls Reference Manual Invalid write operations to queue files DP2 rejects SPT_WRITEUPDATEUNLOCKX( ) operations with a Guardian file-system error 2. Location of buffer and count_written The buffer and count transferred can be in the user stack or in an extended data segment. The buffer and count_written cannot be in the user code space. If the buffer and count_written are in a selectable extended data segment, the segment must be in use at the time of the call.
System Functions (s and S) SPT_WRITEUPDATEUNLOCKX(2) Use on OSS Objects This procedure operates only on Guardian objects. If an OSS file is specified, Guardian filesystem error 2 occurs. RETURN VALUES The SPT_WRITEUPDATEUNLOCKX( ) function returns 0 (zero) upon successful completion. Otherwise, this function returns a nonzero Guardian file-system error number that indicates the outcome of the operation.
SPT_WRITEUPDATEX(2) OSS System Calls Reference Manual NAME SPT_WRITEUPDATEX - Transfers data from an array in the application program to a Guardian file LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include
System Functions (s and S) SPT_WRITEUPDATEX(2) application process’s array is written in that area. For programming information about the WRITEUPDATEX procedure, see the Enscribe Programmer’s Guide and the Guardian Programmer’s Guide. Considerations Buffer use SPT_WRITEUPDATEX( ) is intended for use with 32-bit extended addresses. Therefore, the data buffer for SPT_WRITEUPDATEX( ) can be either in the caller’s stack segment or any extended data segment.
SPT_WRITEUPDATEX(2) OSS System Calls Reference Manual Do not change the contents of the data buffer between the initiation and completion of a nowait write operation. A retry can copy the data again from the user buffer and cause the wrong data to be written. Avoid sharing a buffer between a write and another I/O operation because the contents of the write buffer might change before the write is completed.
System Functions (s and S) SPT_WRITEUPDATEX(2) the odd unstructured attribute is not set when the file is created, the value of write_count is rounded up to an even value before the SPT_WRITEUPDATEX( ) call is executed. You set the odd unstructured attribute with the Guardian FILE_CREATE_, FILE_CREATELIST_, or CREATE procedure, or with the File Utility Program (FUP) SET and CREATE commands.
SPT_WRITEUPDATEX(2) OSS System Calls Reference Manual If the buffer or count transferred is in a selectable extended data segment, the segment must be in use at the time of the call. Flat segments allocated by a process are always accessible to the process.
System Functions (s and S) SPT_WRITEUPDATEX(2) Specifying the correct number of bytes written When SPT_WRITEUPDATEX( ) is used with magnetic tape, the number of bytes to be written must fit exactly; otherwise, information on the tape can be lost. However, no error indication is given. Limitation of SPT_WRITEUPDATEX( ) to the same record Five is the maximum number of times a SPT_WRITEUPDATEX( ) call can be executed to the same record on tape.
spt_writev(2) OSS System Calls Reference Manual NAME spt_writev - Initiate thread-aware writev( ) function LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include ssize_t spt_writev( int filedes, struct iovec *iov, int iov_count); PARAMETERS See the writev(2) reference page. DESCRIPTION This is a thread-aware version of the writev( ) function.
System Functions (s and S) spt_writevx(2) NAME spt_writevx - Writes to a file from scattered buffers (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] [#include ] #include
spt_writevx(2) OSS System Calls Reference Manual this case, the number of bytes written is returned. For example, suppose a file has space for 20 more bytes of data before reaching a limit. A write request of 512 bytes returns a value of 20. The limit can be either the end of the physical medium or the value that has been set by the ulimit( ) function. The next write of a nonzero number of bytes gives a failure return (except as noted later).
System Functions (s and S) spt_writevx(2) written, or transfers no data and returns the value -1 with errno set to [EAGAIN]. Also, if a request is greater than PIPE_BUF bytes and all data previously written to the pipe has been read, writev( ) transfers at least PIPE_BUF bytes.
spt_writevx(2) OSS System Calls Reference Manual ERRORS If any of these conditions occur, the spt_writevx( ) function sets errno to the corresponding value: [EAGAIN] One of these conditions occurred: — An attempt was made to write to a file descriptor that cannot accept data, and the O_NONBLOCK flag is set. — A write to a pipe (FIFO file) of PIPE_BUF bytes or less is requested, O_NONBLOCK is set, and not enough free space is available.
System Functions (s and S) spt_writevx(2) [EIO] One of these conditions occurred: — The process is a member of a background process group attempting to write to its controlling terminal, the TOSTOP flag is set, the process is neither ignoring nor blocking the SIGTTOU signal, and the process group of the process is orphaned. — A physical I/O error occurred. The device holding the file might be in the down state, or both processors that provide access to the device might have failed.
spt_writevx(2) OSS System Calls Reference Manual — The processor for the disk process of the specified file failed during an input or output operation, and the backup process took over. — The open file descriptor has migrated to a new processor, but the new processor lacks a resource or system process needed for use of the file descriptor. The file descriptor specified by the filedes parameter can only be closed.
System Functions (s and S) SPT_WRITEX(2) NAME SPT_WRITEX - Writes data from an array in the application program to an open Guardian file LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include
SPT_WRITEX(2) OSS System Calls Reference Manual Nowait I/O and SPT_WRITEX( ) calls If a nowait SPT_WRITE ( ) call is executed, count_written has no meaning and can be omitted. The count of the number of bytes written is obtained when the I/O operation completes through the count-transferred parameter of the Guardian AWAITIOX procedure. The SPT_WRITEX( ) function must complete with a corresponding call to the Guardian AWAITIOX procedure when used with a file that is opened for nowait I/O.
System Functions (s and S) SPT_WRITEX(2) Inserting a new record into a file The SPT_WRITEX( ) function inserts a new record into a file in the position designated by the file’s primary key: Key-sequenced files The record is inserted in the position indicated by the value in its primary-key field. Queue files The record is inserted into a file at a unique location.
SPT_WRITEX(2) OSS System Calls Reference Manual Structured files Inserting records into relative or entry-sequenced files If the record is inserted into a relative or entrysequenced file, the file must be positioned currently through its primary key. Otherwise, the SPT_WRITEX( ) call fails, and a subsequent call to the Guardian FILE_GETINFO_ or FILEINFO procedure shows that Guardian filesystem error 46 (invalid key) occurred.
System Functions (s and S) SPT_WRITEX(2) BUFFERSIZE boundaries and are integral multiples of BUFFERSIZE. If the SPT_WRITEX( ) call is to an unstructured disk file, data is transferred to the record location specified by the next-record pointer. The next-record pointer is updated to point to the record following the record written.
SPT_WRITEX(2) OSS System Calls Reference Manual responsibility to ensure this. — If you initiated the I/O with SPT_WRITE( ), the I/O must be completed with a call to the Guardian AWAITIOX procedure. — A selectable extended data segment containing the buffer need not be in use at the time of the call to AWAITIOX. — You can cancel nowait I/O that was initiated with SPT_WRITEX( ) with a call to SPT_CANCEL( ) or CANCELREQ.
System Functions (s and S) 527186-007 SPT_WRITEX(2) Hewlett-Packard Company 7−375
spt_writex(2) OSS System Calls Reference Manual NAME spt_writex - Writes to a file (thread-aware version) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] [#include ] #include
System Functions (s and S) spt_writex(2) If the O_SYNC flag of the file status is set and filedes refers to a regular file, a successful spt_writex( ) call does not return until the data is delivered to the underlying hardware (as described in the open(2) reference page). The O_NONBLOCK flag is effective only on pipes, FIFOs, sockets, and terminal device files (Telserv and OSSTTY processes).
spt_writex(2) OSS System Calls Reference Manual — If the O_NONBLOCK flag is set, the spt_writex( ) function returns the value -1 and errno is set to [EAGAIN]. When you attempt to write to a socket with no space available for data: — If the O_NONBLOCK flag is not set, the spt_writex( ) function blocks until space becomes available. — If the O_NONBLOCK flag is set, the spt_writex( ) function returns the value -1 and sets errno to [EAGAIN]. The O_NONBLOCK flag has no effect if space is available.
System Functions (s and S) spt_writex(2) — The O_NONBLOCK flag is set on this file, and the process would be delayed in the write operation. [EBADF] The filedes parameter does not specify a valid file descriptor open for writing. [ECONNRESET] One of these conditions occurred: — The transport-provider process for this socket is no longer available. — The TCP/IP subsystem for this socket is no longer available. — The connection was forcibly closed by the peer socket.
spt_writex(2) OSS System Calls Reference Manual [ENETDOWN] The filedes parameter specifies a file on a remote node, but communication with the remote node has been lost. [ENOSPC] No free space is left on the fileset containing the file. [ENOTCONN] An attempt was made to write to a socket that is not connected to a peer socket.
System Functions (s and S) spt_writex(2) RELATED INFORMATION Functions: creat(2), fcntl(2), lseek(2), open(2), pipe(2), socket(2), spt_fcntlx(2), spt_write(2), ulimit(3), write(2). STANDARDS CONFORMANCE This function is an extension to the UNIX 98 specification. Interfaces documented on this reference page conform to the following industry standards: — IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
stat(2) OSS System Calls Reference Manual NAME stat - Provides information about a file LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ int stat( const char *path, struct stat *buffer); PARAMETERS path Points to the pathname identifying the file.
System Functions (s and S) stat(2) file and sets the st_mode field to indicate the file type. For a symbolic link, the stat( ) function returns information about the file at the end of the link; no information about the link is returned. (For information about the link, use the lstat( ) function.) The stat( ) function updates any time-related fields associated with the file before writing into the stat structure, unless it is a read-only fileset.
stat(2) OSS System Calls Reference Manual st_mode File mode. These bits are ORed into the st_mode field: S_IFMT File type. This field can contain one of these values: S_IFCHR Character special file. S_IFDIR Directory. S_IFIFO FIFO. S_IFREG Regular file. S_IFSOCK Socket. For an AF_UNIX socket, the user permissions from the inode for the socket are returned for the permission bits. The access flags are also returned from the inode.
System Functions (s and S) st_nlink stat(2) Number of links. Values for OSS objects are listed next. Values for Guardian objects are described in Use on Guardian Objects, later in this reference page.
stat(2) OSS System Calls Reference Manual st_basemode If the st_acl flag is set, contains the permissions for the file owner, owning group, and others. If the st_acl flag is not set, st_basemode is 0 (zero). st_rdev Remote device ID. Values for OSS objects are listed next. Values for Guardian objects are described in Use on Guardian Objects, later in this reference page.
System Functions (s and S) st_mtime stat(2) Modification time. Values for OSS objects are listed next. Values for Guardian objects are described in Use on Guardian Objects, later in this reference page.
stat(2) OSS System Calls Reference Manual modification time. The st_atime field indicates the last time the file was opened, and the st_ctime field is set equal to st_mtime. No other time-related fields are updated by OSS function calls. The st_ctime and st_atime fields for Guardian regular disk files (except for EDIT files) are updated by OSS function calls, not by Guardian procedure calls. The time fields for /G, /G/vol, and /G/vol/subvol always contain the current time.
System Functions (s and S) stat(2) Use on Remote Objects The content of the st_dev field of the stat structure is unique for each node in /E because each of these is a separate fileset. Values for directories within /E are the same as described for objects on the local HP NonStop node. The S_ISEXPANDOBJECT macro can indicate whether an object in the /E directory is on a remote HP NonStop node when the st_dev field is passed to the macro.
stat(2) OSS System Calls Reference Manual — A component of the pathname pointed to by the path parameter — The intermediate result of pathname resolution when a symbolic link is part of the path parameter The pathconf( ) function can be called to obtain the applicable limits. [ENOENT] One of these conditions exists: — The file specified by the path parameter does not exist. — The path parameter points to an empty string. — The specified pathname cannot be mapped to a valid Guardian filename.
System Functions (s and S) stat(2) [EOSSNOTRUNNING] The program attempted an operation on an object in the OSS environment while a required system process was not running. [EOVERFLOW] The file size (in bytes) or the file inode number (serial number) cannot be represented correctly in the structure pointed to by the buffer parameter. | | For all other error conditions, errno is set to the appropriate Guardian filesystem error number.
stat64(2) OSS System Calls Reference Manual NAME stat64 - Provides information about a file LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ int stat64( const char *path, struct stat64 *buffer); PARAMETERS path Points to the pathname identifying the file.
System Functions (s and S) stat64(2) The file information is written to the area specified by the buffer parameter, which is a pointer to a stat64 structure with this definition from the sys/stat.
stat64(2) OSS System Calls Reference Manual For Contains Regular file Directory FIFO AF_UNIX socket File serial number (unique) File serial number (unique) File serial number (unique) File serial number of the socket file (unique) File serial number (unique) File serial number (unique) /dev/null /dev/tty The st_ino value for all node entries in /E (including the entry for the logical link from the local node name to the root fileset on the local node) is the value for the root fileset on the correspo
System Functions (s and S) stat64(2) S_TRUST Indicates that the file does not contain code for an uncooperative process or code to examine or modify I/O buffers. This flag suppresses operating system protection of the buffers when the memory segment containing the buffers is not shared. This flag applies only to loadfiles for a process and only a user with appropriate privileges (the super ID) can set it.
stat64(2) OSS System Calls Reference Manual st_gid For Contains Regular file Directory FIFO AF_UNIX socket /dev/null /dev/tty User ID of the file owner User ID of the file owner User ID of the file owner User ID of the creator of the socket file User ID of the super ID User ID of the super ID Group ID. Values for OSS objects are listed next. Values for Guardian objects are described in Use on Guardian Objects, later in this reference page.
System Functions (s and S) st_atime stat64(2) For Contains Regular file Directory FIFO AF_UNIX socket /dev/null /dev/tty Size of the file in bytes 4096 0 (zero) 0 (zero) 0 (zero) 0 (zero) Access time. Values for OSS objects are listed next. Values for Guardian objects are described in Use on Guardian Objects, later in this reference page.
stat64(2) OSS System Calls Reference Manual For Contains Regular file Directory FIFO AF_UNIX socket /dev/null /dev/tty Time of the last file status change Time of the last file status change Time of the last file status change Value retrieved from the inode Current time Composite value of the times of all openers of the file For the /E entry of the local node, the value is the time of the most recent mounting of the root fileset.
System Functions (s and S) stat64(2) Guardian st_mode Example in /G File Type File Type Permissions ___________________________________________________________________ /G vol vol/subvol vol/subvol/fileid vol/#123 ztnt ztnt/#pty0001 vol1/zyq00001 N/A Disk volume Subvolume Disk file Temporary disk file Subtype 30 process Subtype 30 process with qualifier Subvolume Directory Directory Directory Regular file Regular file Directory Character special r-xr-xr-x rwxrwxrwx rwxrwxrwx See following text See follo
stat64(2) OSS System Calls Reference Manual Use From the Guardian Environment The stat64( ) function belongs to a set of functions that have these effects when the first of them is called from the Guardian environment: — Two Guardian file system file numbers (not necessarily the next two available) are allocated for the root directory and the current working directory. You cannot close these file numbers by calling the Guardian FILE_CLOSE_ procedure.
System Functions (s and S) [ENOENT] stat64(2) One of these conditions exists: — The file specified by the path parameter does not exist. — The path parameter points to an empty string. — The specified pathname cannot be mapped to a valid Guardian filename. — The specified pathname points to the name of a Guardian process that is not of subtype 30. — The path parameter specifies a file on a remote HP NonStop node, but communication with the remote node has been lost.
stat64(2) OSS System Calls Reference Manual RELATED INFORMATION Commands: getacl(1), setacl(1). | Functions: acl(2), chmod(2), chown(2), link(2), lstat(2), lstat64(2), mknod(2), open(2), open64(2), pipe(2), utime(2). | Miscellaneous Topics: acl(5). | STANDARDS CONFORMANCE This function is an HP extension to the XPG4 Version 2 specification.
System Functions (s and S) statvfs(2) NAME statvfs - Gets fileset information using a pathname LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int statvfs( const char *path, struct statvfs *buffer); PARAMETERS path Is a pathname that specifies any file within a mounted fileset. buffer Points to a statvfs structure that is to hold the returned information for the statvfs( ) call.
statvfs(2) OSS System Calls Reference Manual f_frsize f_blocks For Contains Regular file Directory FIFO AF_UNIX socket /dev/null Object in /G /G /G/ztnt/#ptynn /E 4096 4096 4096 4096 4096 4096 4096 4096 4096 Fundamental file system block size. For Contains Regular file Directory FIFO AF_UNIX socket /dev/null Object in /G /G /G/ztnt/#ptynn /E 4096 4096 4096 4096 4096 4096 4096 4096 4096 Total number of blocks in fileset, in units of f_frsize.
System Functions (s and S) f_bfree statvfs(2) Total number of free blocks in fileset. For Contains Regular file Number of free blocks on all volumes currently in the storage-pool file for the fileset. Number of free blocks on all volumes currently in the storage-pool file for the fileset. Number of free blocks on all volumes currently in the storage-pool file for the fileset. Number of free blocks on all volumes currently in the storage-pool file for the fileset.
statvfs(2) OSS System Calls Reference Manual /G/ztnt/#ptynn /E f_files f_ffree Total number of file serial numbers (inode numbers) in the fileset. For Contains Regular file Directory FIFO AF_UNIX socket /dev/null Object in /G /G /G/ztnt/#ptynn /E Number of inode numbers in the fileset. Number of inode numbers in the fileset. Number of inode numbers in the fileset. Number of inode numbers in the fileset. Number of inode numbers in the fileset. The value of ULONG_MAX.
System Functions (s and S) statvfs(2) For Contains Regular file Number of free inode numbers in the fileset. Number of free inode numbers in the fileset. Number of free inode numbers in the fileset. Number of free inode numbers in the fileset. Number of free inode numbers in the fileset. The value of ULONG_MAX. 0 0 0 Directory FIFO AF_UNIX socket /dev/null Object in /G /G /G/ztnt/#ptynn /E f_fsid Fileset identifier. For Contains Regular file Lower 32 bits of the st_dev field in the stat structure.
statvfs(2) OSS System Calls Reference Manual f_flag For Contains Regular file Directory FIFO AF_UNIX socket /dev/null Object in /G /G /G/ztnt/#ptynn /E OSS OSS OSS OSS OSS GUARDIAN GUARDIAN GUARDIAN EXPAND Bit mask indicating type of fileset access allowed. For Contains Regular file 4 if fileset is read/write, 5 if fileset is readonly. 4 if fileset is read/write, 5 if fileset is readonly. 4 if fileset is read/write, 5 if fileset is readonly. 4 if fileset is read/write, 5 if fileset is readonly.
System Functions (s and S) f_namemax f_fstr statvfs(2) Maximum number of character bytes in a filename within the fileset. For Contains Regular file Directory FIFO AF_UNIX socket /dev/null Object in /G /G /G/ztnt/#ptynn /E 248 248 248 248 248 8 7 7 7 Fileset pathname prefix string. For Contains Regular file /E/nodename/G/volume/ZXnnnnnn n, identifying the catalog file and version for the specified file.
statvfs(2) OSS System Calls Reference Manual f_bmaxavail For Contains Regular file Directory FIFO AF_UNIX socket /dev/null Object in /G /G /G/ztnt/#ptynn /E Number of blocks. Number of blocks. Number of blocks. Number of blocks. Number of blocks. Number of blocks. 0 0 0 Number of blocks free on the disk volume with the most space remaining. For Contains Regular file Directory FIFO AF_UNIX socket /dev/null Object in /G /G /G/ztnt/#ptynn /E Number of blocks. Number of blocks. Number of blocks.
System Functions (s and S) statvfs(2) ERRORS If any of these conditions occurs, the statvfs( ) function sets errno to the corresponding value: [EACCES] Search permission is denied for a component of the path prefix of the path parameter. [EFAULT] The buffer or path parameter points to a location outside of the allocated address space of the process. [EINTR] The function was interrupted by a signal before any data arrived.
statvfs64(2) OSS System Calls Reference Manual NAME statvfs64 - Gets fileset information using a pathname LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int statvfs64( const char *path, struct statvfs64 *buffer); PARAMETERS path Is a pathname that specifies any file within a mounted fileset. buffer Points to a statvfs64 structure that is to hold the returned information for the statvfs64( ) call.
System Functions (s and S) statvfs64(2) The fields in this structure have the following meanings and content: f_bsize f_frsize f_blocks Fileset block size. For Contains Regular file Directory FIFO AF_UNIX socket /dev/null Object in /G /G /G/ztnt/#ptynn /E 4096 4096 4096 4096 4096 4096 4096 4096 4096 Fundamental file system block size.
statvfs64(2) OSS System Calls Reference Manual /E f_bfree Total number of free blocks in fileset. For Contains Regular file Number of free blocks on all volumes currently in the storage-pool file for the fileset. Number of free blocks on all volumes currently in the storage-pool file for the fileset. Number of free blocks on all volumes currently in the storage-pool file for the fileset. Number of free blocks on all volumes currently in the storage-pool file for the fileset.
System Functions (s and S) statvfs64(2) /G /G/ztnt/#ptynn /E f_files f_ffree Total number of file serial numbers (inode numbers) in the fileset. For Contains Regular file Directory FIFO AF_UNIX socket /dev/null Object in /G /G /G/ztnt/#ptynn /E Number of inode numbers in the fileset. Number of inode numbers in the fileset. Number of inode numbers in the fileset. Number of inode numbers in the fileset. Number of inode numbers in the fileset. The value of ULONG_MAX.
statvfs64(2) OSS System Calls Reference Manual For Contains Regular file Number of free inode numbers in the fileset. Number of free inode numbers in the fileset. Number of free inode numbers in the fileset. Number of free inode numbers in the fileset. Number of free inode numbers in the fileset. The value of ULONG_MAX. 0 0 0 Directory FIFO AF_UNIX socket /dev/null Object in /G /G /G/ztnt/#ptynn /E f_fsid Fileset identifier.
System Functions (s and S) f_flag statvfs64(2) For Contains Regular file Directory FIFO AF_UNIX socket /dev/null Object in /G /G /G/ztnt/#ptynn /E OSS OSS OSS OSS OSS GUARDIAN GUARDIAN GUARDIAN EXPAND Bit mask indicating type of fileset access allowed. For Contains Regular file 4 if fileset is read/write, 5 if fileset is readonly. 4 if fileset is read/write, 5 if fileset is readonly. 4 if fileset is read/write, 5 if fileset is readonly. 4 if fileset is read/write, 5 if fileset is readonly.
statvfs64(2) OSS System Calls Reference Manual f_namemax f_fstr Maximum number of character bytes in a filename within the fileset. For Contains Regular file Directory FIFO AF_UNIX socket /dev/null Object in /G /G /G/ztnt/#ptynn /E 248 248 248 248 248 8 7 7 7 Fileset pathname prefix string. For Contains Regular file /E/nodename/G/volume/ZXnnnnnn n, identifying the catalog file and version for the specified file.
System Functions (s and S) statvfs64(2) f_bmaxavail For Contains Regular file Directory FIFO AF_UNIX socket /dev/null Object in /G /G /G/ztnt/#ptynn /E Number of blocks. Number of blocks. Number of blocks. Number of blocks. Number of blocks. Number of blocks. 0 0 0 Number of blocks free on the disk volume with the most space remaining. For Contains Regular file Directory FIFO AF_UNIX socket /dev/null Object in /G /G /G/ztnt/#ptynn /E Number of blocks. Number of blocks. Number of blocks.
statvfs64(2) OSS System Calls Reference Manual ERRORS If any of these conditions occurs, the statvfs64( ) function sets errno to the corresponding value: [EACCES] Search permission is denied for a component of the path prefix of the path parameter. [EFAULT] The buffer or path parameter points to a location outside of the allocated address space of the process. [EINTR] The function was interrupted by a signal before any data arrived.
System Functions (s and S) strtok_r(2) NAME strtok_r - Splits string into tokens (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include char *strtok_r ( char *s, const char *sep, char **lasts ); PARAMETERS s Contains a pointer to the string to be searched. sep Contains a pointer to the string of byte token delimiters.
strtok_r(2) OSS System Calls Reference Manual The use of the header file spthread.h is an HP exception to the POSIX standard.
System Functions (s and S) symlink(2) NAME symlink - Creates a symbolic link to a file LIBRARY G-series native Guardian processes: system library G-series native OSS processes: system library H-series native Guardian processes: implicit libraries H-series OSS processes: implicit libraries SYNOPSIS #include int symlink( const char *path1, const char *path2); PARAMETERS path1 Specifies the file for which the symbolic link must be created.
symlink(2) OSS System Calls Reference Manual mknod( ) An error is returned if a symbolic link is named as the path parameter. open( ) An error is returned when O_CREAT and O_EXCL are both specified and the path parameter specifies an existing symbolic link. readlink( ) This function applies only to symbolic links. remove( ) A symbolic link can be removed by invoking the remove( ) function. rename( ) If the file to be renamed is a symbolic link, the symbolic link is renamed.
System Functions (s and S) symlink(2) RETURN VALUES Upon successful completion, the symlink( ) function returns the value 0 (zero). Otherwise, the value -1 is returned and errno is set to indicate the error. ERRORS If any of the following conditions occurs, the symlink( ) function sets errno to the corresponding value: [EACCES] One of the following conditions exists: — The requested operation requires writing in a directory with a mode that denies write permission.
symlink(2) OSS System Calls Reference Manual [ENOROOT] One of the following conditions exists: — The root fileset of the local node (fileset 0) is not in the STARTED state. — The current root fileset for the specified file is unavailable. The OSS name server for the fileset might have failed. — The specified file is on a remote HP NonStop node and communication with the remote name server has been lost.
System Functions (s and S) SPT_ABORTTRANSACTION(3) NAME SPT_ABORTTRANSACTION - Aborts and backs out a transaction associated with the current process and current thread LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include signed16 SPT_ABORTTRANSACTION( void ); PARAMETERS None. DESCRIPTION This function aborts and backs out a transaction associated with the current process and the current thread.
SPT_BEGINTRANSACTION(3) OSS System Calls Reference Manual NAME SPT_BEGINTRANSACTION - Starts a new transaction associated with the current process and current thread LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
System Functions (s and S) SPT_ENDTRANSACTION(3) NAME SPT_ENDTRANSACTION - Ends the transaction associated with the current process and current thread LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include signed16 SPT_ENDTRANSACTION( void ); PARAMETERS None.
SPT_RESUMETRANSACTION(3) OSS System Calls Reference Manual NAME SPT_RESUMETRANSACTION - Restores a transaction associated with the current process and current thread LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
System Functions (s and S) SPT_SERVERCLASS_DIALOG_ABORT_(3) NAME SPT_SERVERCLASS_DIALOG_ABORT_ - Aborts the specified dialog LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include signed16 SPT_SERVERCLASS_DIALOG_ABORT_( signed32 dialogId, ); PARAMETERS Input dialogId Contains the identifier returned from SPT_SERVERCLASS_DIALOG_BEGIN_( ) that specifies the dialog for this abort operation.
SPT_SERVERCLASS_DIALOG_BEGIN_(3) OSS System Calls Reference Manual NAME SPT_SERVERCLASS_DIALOG_BEGIN_ - Initiates the dialog and also sends the first message of the dialog to the server instance in the Pathway serverclass LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
System Functions (s and S) SPT_SERVERCLASS_DIALOG_BEGIN_(3) flags (Optional) If specified, this parameter must contain 0 (zero) for a single TMF transaction per dialog or 2 for multiple TMF transactions per dialog. This flag value (0 or 2) also indicates that this operation is always waited. This parameter is provided for compatibility with the Guardian SERVERCLASS_DIALOG_BEGIN_ procedure. tag (Optional) If specified, this parameter is ignored.
SPT_SERVERCLASS_DIALOG_BEGIN_(3) OSS System Calls Reference Manual NOTES The message_buffer parameter should refer to static or heap-allocated storage. It should not be automatic storage and should not be stack-allocated storage for a TNS process. If stack-allocated storage for a TNS process is specified, an error value 233 (FEScError) is returned; SPT_SERVERCLASS_SEND_INFO_( ) reports Pathsend error 912 (FEScParameterBoundsError). The message buffer is modified by the server reply.
System Functions (s and S) SPT_SERVERCLASS_DIALOG_END_(3) NAME SPT_SERVERCLASS_DIALOG_END_ - Cleans up resources for the specified dialog after the server has ended it LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
SPT_SERVERCLASS_DIALOG_SEND_(3) OSS System Calls Reference Manual NAME SPT_SERVERCLASS_DIALOG_SEND_ - Initiates a send within the specified dialog to the server instance in the Pathway serverclass LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
System Functions (s and S) SPT_SERVERCLASS_DIALOG_SEND_(3) Output message_buffer On successful completion of the send, contains the reply returned by the server process. actual_reply_len (Optional) If provided, returns the number of bytes returned in the server process reply and stored in the area pointed to by message_buffer. scsend_op_num (Optional) If provided, returns the value -1. This parameter is provided only for compatibility with the Guardian SPT_SERVERCLASS_DIALOG_SEND_ procedure.
SPT_SERVERCLASS_DIALOG_SEND_(3) OSS System Calls Reference Manual RETURN VALUES Possible return values are the following Guardian file-system error numbers: 0 (zero) The SPT_SERVERCLASS_SEND_( ) operation completed successfully. 70 (FEContinue) The server is ready for the next message in the dialog. 233 (FEScError) You can call the SPT_SERVERCLASS_SEND_INFO_( ) function to get detailed information about this error. ERRORS This function does not set errno.
System Functions (s and S) SPT_SERVERCLASS_SEND_(3) NAME SPT_SERVERCLASS_SEND_ - Sends a message to and receives a reply from a server process in a Pathway server class LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include
SPT_SERVERCLASS_SEND_(3) OSS System Calls Reference Manual flags (Optional) If provided, must contain 0 (zero) to indicate a waited operation. This parameter is provided for compatibility with the Guardian SERVERCLASS_SEND_ procedure. tag (Optional) If provided, is ignored. This parameter is provided for compatibility with the Guardian SERVERCLASS_SEND_ procedure. Output message_buffer On successful completion of the send, contains the reply returned by the server process.
System Functions (s and S) SPT_SERVERCLASS_SEND_(3) If SPT_SERVERCLASS_SEND_( ) is called while the thread has a current transaction, the transaction identifier is propagated to the server class process. If the send is to a server class configured with the TMF parameter OFF, then the send finishes with return error 233 (FEScError) and SPT_SERVERCLASS_SEND_INFO_( ) will show Pathsend error 917 (FEScServerClassTmfViolation) and Guardian file-system error 0.
SPT_SERVERCLASS_SEND_INFO_(3) OSS System Calls Reference Manual NAME SPT_SERVERCLASS_SEND_INFO_ - Returns information about the last server-class send operation LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS #include signed16 SPT_SERVERCLASS_SEND_INFO_( [signed16 *Pathsend_error,] [signed16 *file_system_error] ); PARAMETERS Output Pathsend_error (Optional) Returns the Pathsend error number.
Section 8. System Functions (t) This section contains reference pages for Open System Services (OSS) system function calls with names that begin with t. These reference pages reside in the cat2 directory and are sorted alphabetically by U.S. English conventions in this section.
tdm_execve(2) OSS System Calls Reference Manual NAME tdm_execve - Executes a file with HP extensions LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include
System Functions (t) tdm_execve(2) macros and error codes, see the Guardian header file $SYSTEM.ZSPIDEF.ZGRDC or the summary of process-creation errors in the Guardian Procedure Calls Reference Manual (see the table entitled "Summary of Process Creation Errors"). DESCRIPTION The tdm_execve( ) function replaces the current process image with a new process image. The new image is constructed from a regular executable file, called a new process image file.
tdm_execve(2) OSS System Calls Reference Manual Executing a Binary File If the file specified as the new process image file is a binary executable file, the tdm_execve( ) function loads the file directly. Executing a Text File If the file specified as the new process image file is not a binary executable file, the tdm_execve( ) function examines the file to determine whether it is an executable text file.
System Functions (t) tdm_execve(2) Existing Sockets A socket associated with an open file descriptor in the calling process remains connected in the new process when the new process runs in the same processor as the calling process. When the new process runs in a different processor than the calling process, the processor that runs the new process must also be running a socket transport agent process.
tdm_execve(2) OSS System Calls Reference Manual OSS Attributes These OSS attributes of the calling process image are unchanged after successful completion of the tdm_execve( ) function: • OSS process ID (PID) • Parent OSS process ID • Process group ID • Session membership • Real user ID • Real group ID • Supplementary group IDs • The time left until an alarm clock signal is posted (see the alarm(3) reference page) • Current working directory • Root directory • File mode creation mask
System Functions (t) tdm_execve(2) • Security group list • Job ancestor or GMOM • Unread system message index (PCBMCNT) This attribute assignment is different from the assignment made when creating a new process with Guardian procedures. • Outstanding incoming and outgoing message limits This attribute assignment is different from the assignment made when creating a new process with Guardian procedures.
tdm_execve(2) OSS System Calls Reference Manual • The creator access ID (CAID) is set to the process access ID (PAID) of the calling process. • The PAID depends on whether the S_ISUID mode bit of the process image file is set. If that bit is set, the PAID is based on the file owner ID. If not, the PAID is the same as for the caller. (The S_ISUID mode bit of the image file has no effect on the security group list.) • The MOM field for the new process depends on whether the calling process is named.
System Functions (t) tdm_execve(2) In the current RVU, these fields are meaningful: typedef struct process_extension { long pe_len; char *pe_library_name; char *pe_swap_file_name; char *pe_extswap_file_name; short pe_priority; short pe_cpu; short pe_name_options; char filler_1[2]; char *pe_process_name; char *pe_hometerm; short pe_memory_pages; short pe_jobid; short pe_create_options; char filler_2[2]; char *pe_defines; short pe_defines_len; short pe_debug_options; long pe_pfs_size; short pe_OSS_options;
tdm_execve(2) OSS System Calls Reference Manual pe_extswap_file_name Points to a null-terminated string specifying the name of a disk file in the Guardian file system to be used as the swap file for the extended data segment. For example, if the Guardian filename is $A.B.D, the name used is /G/a/b/d. This file cannot have the same name as that of a file used in a preceding call to the tdm_fork( ) function. This field is used only for G-series TNS or accelerated new process image files.
System Functions (t) tdm_execve(2) _TPC_ENABLE_DEFINES Enables DEFINEs when set if _TPC_OVERRIDE_DEFMODE is also set. Disables DEFINEs when not set. _TPC_HIGHPIN_OFF Restricts the new process to a PIN in the range 0 through 254. This restriction is rarely useful for an OSS process; it allows obsolescent Guardian interfaces to interact with the process. By default, this restriction is inherited by any child or successor process. The default can be overridden by using the _TPC_IGNORE_FORCEPIN_ATTR field.
tdm_execve(2) OSS System Calls Reference Manual _TPC_DEBUG_SAVEABEND Uses the default debugger and creates a saveabend file. _TPC_ENTER_DEBUG Starts the new process in the default debugging utility. _TPC_INSPECT_NOSAVE Uses the symbolic debugger but does not create a saveabend file. _TPC_INSPECT_SAVEABEND Uses the symbolic debugger and creates a saveabend file. pe_pfs_size Specifies the size of the PFS for the new process (this field is ignored). pe_OSS_options Specifies OSS options.
System Functions (t) tdm_execve(2) new process is null. The MOM and ANCESTOR fields for the new process are the same as for a process created in the Guardian environment if the new process is unnamed (the pe_name_options field is set to _TPC_NO_NAME). If the caller is unnamed, the MOM field for the new process is set to the MOM field of the caller. If the caller is named, the MOM field for the new process is set to the ANCESTOR field of the calling process.
tdm_execve(2) OSS System Calls Reference Manual • The new process image file, any library file, or script file denies execution permission. • The new process image file is not a regular file. [EAGAIN] System resources such as disk space, process control block (PCB) space, MAPPOOL space, stack space, or PFS space are temporarily inadequate. [EFAULT] An address for a parameter in the process_extension structure pointed to by pe_parms is out of allowable bounds.
System Functions (t) [ENOENT] tdm_execve(2) One of these conditions exists: • One or more components of the new process image file’s pathname do not exist. • The path parameter points to an empty string. [ENOEXEC] The new process image file has the appropriate access permissions and is in the OSS name space, but it is neither in the correct binary executable format nor a valid executable text file. [ENOMEM] Required resources are not available.
tdm_execvep(2) OSS System Calls Reference Manual NAME tdm_execvep - Executes a file with HP extensions LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include
System Functions (t) tdm_execvep(2) error codes are defined for process creation functions. The list of _TPC_ macros described in that reference page is not complete; for a current description of error macros and error codes, see the Guardian header file $SYSTEM.ZSPIDEF.ZGRDC or the summary of process-creation errors in the Guardian Procedure Calls Reference Manual (see the table entitled "Summary of Process Creation Errors").
tdm_execvep(2) OSS System Calls Reference Manual Specifying the Environment The envp[ ] parameter is an array of character pointers to null-terminated strings. These strings constitute the environment for the new process image. The environment array is terminated with a null pointer. The number of bytes available for the new process’s combined argument and environment lists has a system-imposed limit.
System Functions (t) tdm_execvep(2) Open Files File descriptors open in the calling process image remain open in the new process image, except for those: • Whose close-on-exec flag FD_CLOEXEC is set (see the fcntl(2) reference page) • Opened using a Guardian function or procedure call For a G-series TNS process image or an accelerated processs image only, if the process file segment (PFS) of the new process image is smaller than the process file segment of the calling process image and if the calling
tdm_execvep(2) OSS System Calls Reference Manual • Be ignored (SIG_IGN) by the calling process image are set to be ignored by the new process image. • Cause abnormal termination (SIG_ABORT) in the calling process image are set to that action in the new process image. • Cause entry into the debugger (SIG_DEBUG) in the calling process image are set to that action in the new process image. • Be caught by the calling process image are set to the default action in the new process image.
System Functions (t) • tdm_execvep(2) File size limit (see the ulimit(2) reference page) Upon successful completion, the tdm_execvep( ) function marks the st_atime field of the file for update. The POSIX.1 standard does not specify the effect on the st_atime field when the tdm_execvep( ) function call fails but does find the file. Neither does the HP implementation guarantee the outcome. Under these circumstances, this field should not be used for further processing.
tdm_execvep(2) OSS System Calls Reference Manual • The process name for the new process is system-generated if the RUNNAMED option is set in the program file. Otherwise the process is unnamed. • The size of the data segment of the new process is set in the program file. • The remote login flag (PCBREMID) is set to zero (off) if the program file has its S_ISUID mode bit set. Otherwise, the remote login flag is set the same as for the caller.
System Functions (t) tdm_execvep(2) The input structure is defined in the tdmext.h header file. This structure can contain fields that vary from release version update (RVU) to RVU, including reserved and filler fields.
tdm_execvep(2) OSS System Calls Reference Manual pe_extswap_file_name Points to a null-terminated string specifying the name of a disk file in the Guardian file system to be used as the swap file for the extended data segment. For example, if the Guardian file name is $A.B.D, the name used is /G/a/b/d. This file cannot have the same name as that of a file used in a preceding call to the tdm_fork( ) function. This field is used only for G-series TNS or accelerated new process image files.
System Functions (t) tdm_execvep(2) _TPC_OVERRIDE_DEFMODE is also set. Disables DEFINEs when not set. _TPC_HIGHPIN_OFF Restricts the new process to a PIN in the range 0 through 254. This restriction is rarely useful for an OSS process; it allows obsolescent Guardian interfaces to interact with the process. By default, this restriction is inherited by any child or successor process. The default can be overridden by using the _TPC_IGNORE_FORCEPIN_ATTR field.
tdm_execvep(2) OSS System Calls Reference Manual _TPC_DEBUG_SAVEABEND Uses the default debugger and creates a saveabend file. _TPC_ENTER_DEBUG Starts the new process in the default debugger. _TPC_INSPECT_NOSAVE Uses the symbolic debugger but does not create a saveabend file. _TPC_INSPECT_SAVEABEND Uses the symbolic debugger and creates a saveabend file. pe_pfs_size Specifies the size of the process file segment (PFS) for the new process (this field is ignored). pe_OSS_options Specifies OSS options.
System Functions (t) tdm_execvep(2) the new process is set to the ANCESTOR field of the calling process, and the MOM field of the new process is null. The MOM and ANCESTOR fields for the new process are the same as for a process created in the Guardian environment if the new process is unnamed (the pe_name_options field is set to _TPC_NO_NAME). If the caller is unnamed, the MOM field for the new process is set to the MOM field of the caller.
tdm_execvep(2) OSS System Calls Reference Manual • The new process image file, any library file, or script file denies execution permission. • The new process image file is not a regular file. [EAGAIN] System resources such as disk space, process control block (PCB) space, MAPPOOL space, stack space, or PFS space are temporarily inadequate. [EFAULT] An address for a parameter in the process_extension structure pointed to by pe_parms is out of allowable bounds.
System Functions (t) [ENOENT] tdm_execvep(2) One of these conditions exists: • One or more components of the new process image file’s pathname do not exist. • The file parameter points to an empty string. [ENOEXEC] The command interpreter could not be invoked following failure to execute the process image file identified by the file parameter. [ENOMEM] Required resources are not available. Subsequent calls to the same function will not succeed for the same reason.
tdm_fork(2) OSS System Calls Reference Manual NAME tdm_fork - Creates a new process with HP extensions LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include pid_t tdm_fork( const struct process_extension *pe_parms, struct process_extension_results *pr_results); PARAMETERS pe_parms Points to the input structure containing Guardian process attributes to be assigned to the child process. The structure is defined in the tdmext.
System Functions (t) tdm_fork(2) Use From the Guardian Environment If called from a Guardian process, the actions of this function are undefined and errno is set to [ENOTOSS].
tdm_fork(2) OSS System Calls Reference Manual • The child process shares directory streams with the parent. They share the same block of directory entries. When reading an entry, the buffer pointer is advanced by one entry. From the perspective of either process, an entry might be skipped. If both processes call the readdir( ) function for a shared stream, the results are undefined. After such a call by both functions, another call to the readdir( ) function by either process has undefined results.
System Functions (t) tdm_fork(2) • Login, remote login, and saveabend flags • File creation mask • System debugger selection (based on Inspect mode and OSS read access rights on the program file) If the pe_parms parameter contains a null pointer, then the default Guardian attributes of the child process differ from those of the parent process in the following ways: • Segments created or shared using Guardian procedures such as SEGMENT_ALLOCATE_ are not inherited.
tdm_fork(2) OSS System Calls Reference Manual The following fields are meaningful: typedef struct process_extension { long pe_len; char *pe_library_name; char *pe_swap_file_name; char *pe_extswap_file_name; short pe_priority; short pe_cpu; short pe_name_options; char filler_1[2]; char *pe_process_name; char *pe_hometerm; short pe_memory_pages; short pe_jobid; short pe_create_options; char filler_2[2]; char *pe_defines; short pe_defines_len; short pe_debug_options; long pe_pfs_size; short pe_OSS_options; c
System Functions (t) tdm_fork(2) pe_priority Specifies the priority of the child process. pe_cpu Specifies the processor on which the child process will execute. The only valid values for the tdm_fork( ) function are -1 (the default value) and the current processor number. Each of these values has the effect of running the child process on the same processor as the parent. pe_name_options Specifies process naming as follows: _TPC_GENERATE_NAME The system generates the name.
tdm_fork(2) OSS System Calls Reference Manual _TPC_IGNORE_FORCEPIN_ATTR Ignores the _TPC_HIGHPIN_OFF restriction specified for or inherited by the parent process. When _TPC_IGNORE_FORCEPIN_ATTR is specified, the resulting process has a restricted PIN only if _TPC_HIGHPIN_OFF is also specified or if the object file for the program or a user library lacks the HIGHPIN attribute.
System Functions (t) tdm_fork(2) _TPC_INSPECT_SAVEABEND Uses the symbolic debugger and creates a saveabend file. pe_pfs_size Specifies the size of the process file segment (PFS) for the child process (this field is ignored). pe_OSS_options Specifies OSS options. No special action on signals is the default and only current OSS option. pe_mainstack_max Specifies the maximum size of the main stack in bytes for the child process.
tdm_fork(2) OSS System Calls Reference Manual Shared Memory Any attached shared memory segments are attached to both the child process and the parent process when both processes execute in the same processor. Any attached shared memory segments are detached from the child process by a successful call to the tdm_fork( ) function when the child process executes in a different processor than that used by the parent.
System Functions (t) tdm_fork(2) If the tdm_fork( ) function fails, the value -1 is returned to the parent process, no child process is created, and errno is set to indicate the error. If pr_results does not contain a null pointer, it returns additional error information including the PROCESS_LAUNCH_ procedure error and error detail.
tdm_spawn(2) OSS System Calls Reference Manual NAME tdm_spawn - Executes a new process with HP extensions LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include #include
System Functions (t) tdm_spawn(2) envp[ ] Specifies an array of character pointers to null-terminated strings that describe the environment for the new process. pe_parms Points to the input structure containing Guardian process attributes to be assigned to the new process. The structure is defined in the tdmext.h header file. When this parameter contains a null pointer, the tdm_spawn( ) function assumes default Guardian attributes.
tdm_spawn(2) OSS System Calls Reference Manual The arguments specified by a program using the tdm_spawn( ) function are passed on to the new process image in the corresponding arguments to the main( ) function. Use From the Guardian Environment If called from a Guardian process, the actions of this function are undefined, and errno is set to [ENOTOSS]. Identifying the Process Image File The tdm_spawn( ) function uses the path parameter to identify the process image file.
System Functions (t) tdm_spawn(2) When the File Is Invalid If the process image file is not a valid executable object, or if the text file does not contain the header line, the tdm_spawn( ) function returns and sets errno to [ENOEXEC]. Open Files The fd_count and fd_map[ ] parameters determine which file descriptors that were open in the calling process remain open in the new process. fd_count specifies the number of file descriptors to be designated by the fd_map[ ] parameter.
tdm_spawn(2) OSS System Calls Reference Manual Shared Memory Any attached shared memory segments are detached from the child process by a successful call to the tdm_spawn( ) function. See the shmat(2) reference page for additional information about shared memory segment use. Semaphores Semaphore set IDs attached to a parent process are also attached to the child process if the child process executes in the same processor as the parent.
System Functions (t) tdm_spawn(2) User ID and Group ID If the set-user-ID mode bit (S_ISUID) of the new process image file is set (see the chmod(2) reference page), the effective user ID of the new process image is set to the user ID of the owner of the new process image file. Similarly, if the set-group-ID mode bit (S_ISGID) of the new process image file is set, the effective group ID of the new process image is set to the group ID of the new process image file.
tdm_spawn(2) OSS System Calls Reference Manual • The set of signals for which default action is set and the set of signals to be ignored are the same in the child process as in the parent process unless modified by inherit->sigdefault. See Signals, earlier. • The child process does not share directory streams with the parent. All open directory streams are closed for the child process.
System Functions (t) tdm_spawn(2) • The process name for the new process is system-generated if the RUNNAMED option is set in the program file. Otherwise, the process is unnamed. • The size of the data segment of the new process is set in the program file. • The remote login flag (PCBREMID) is set to zero (off) if the program file has its S_ISUID mode bit set. Otherwise, the remote login flag is set the same as for the caller.
tdm_spawn(2) OSS System Calls Reference Manual In the current RVU, these fields are meaningful: typedef struct process_extension { long pe_len; char *pe_library_name; char *pe_swap_file_name; char *pe_extswap_file_name; short pe_priority; short pe_cpu; short pe_name_options; char filler_1[2]; char *pe_process_name; char *pe_hometerm; short pe_memory_pages; short pe_jobid; short pe_create_options; char filler_2[2]; char *pe_defines; short pe_defines_len; short pe_debug_options; long pe_pfs_size; short pe_O
System Functions (t) tdm_spawn(2) pe_extswap_file_name Points to a null-terminated string specifying the name of a disk file in the Guardian file system to be used as the swap file for the extended data segment. For example, if the Guardian filename is $A.B.D, the name used is /G/a/b/d. This field is used only for G-series TNS or accelerated new process image files. If a value is specified for this field for native object files, the specified value is validated but otherwise ignored.
tdm_spawn(2) OSS System Calls Reference Manual _TPC_HIGHPIN_OFF Restricts the new process to a PIN in the range 0 through 254. This restriction is rarely useful for an OSS process; it allows obsolescent Guardian interfaces to interact with the process. By default, this restriction is inherited by any child or successor process. The default can be overridden by using the _TPC_IGNORE_FORCEPIN_ATTR field.
System Functions (t) tdm_spawn(2) _TPC_DEBUG_SAVEABEND Uses the default debugger and creates a saveabend file. _TPC_ENTER_DEBUG Starts the new process in the default debugger. _TPC_INSPECT_NOSAVE Uses the symbolic debugger but does not create a saveabend file. _TPC_INSPECT_SAVEABEND Uses the symbolic debugger and creates a saveabend file. pe_pfs_size Specifies the size of the process file segment (PFS) for the new process (this field is ignored). pe_OSS_options Specifies OSS options.
tdm_spawn(2) OSS System Calls Reference Manual Output Structure Information If the pr_results parameter does not contain a null pointer, it points to an output structure defined in the tdmext.h header file. This structure can contain fields that vary from RVU to RVU, including reserved and filler fields. First, the output structure must be initialized by using the #define DEFAULT_PROCESS_EXTENSION_RESULTS. This initialization sets the value of the pr_len field to the correct value for the current RVU.
System Functions (t) tdm_spawn(2) • The pointers contained within the global variable environ • The elements pointed to by environ pointers • The effective user ID of the current process • The effective group ID of the current process [E2BIG] The number of bytes used by the new process image’s argument list and environment list is greater than the system-imposed limit. The limit can be obtained by calling the sysconf(_SC_ARG_MAX) function.
tdm_spawn(2) OSS System Calls Reference Manual [ELOOP] Too many symbolic links were encountered in pathname resolution. [EMFILE] The maximum number of files are open. The process attempted to open more than the maximum number of file descriptors allowed for the process. One of these conditions might exist: • The maximum value for fd_count has been exceeded. • The process file segment (PFS) of the child process is smaller than that of the parent process.
System Functions (t) tdm_spawn(2) [EUNKNOWN] Unknown error. An unrecognized or very obscure error occurred. If this error occurs, follow site-defined procedures for reporting software problems to HP. The structure pointed to by the pr_results parameter might contain additional Guardian PROCESS_LAUNCH_ procedure error and error detail information if any of these errors occur: [EACCES], [EAGAIN], [EFAULT], [EINVAL], [EIO], [ENOCPU], and [ENOEXEC]. RELATED INFORMATION Commands: eld(1), ld(1), nld(1).
tdm_spawnp(2) OSS System Calls Reference Manual NAME tdm_spawnp - Executes a new process with HP extensions LIBRARY G-series native OSS processes: /G/system/sysnn/zossksrl H-series OSS processes: /G/system/zdllnnn/zosskdll SYNOPSIS #include #include
System Functions (t) tdm_spawnp(2) inherit Points to a structure that allows the process group ID and signal mask of the new process to be specified in addition to a list of signals that the child process will take default action on. The structure is defined in the spawn.h header file. argv[ ] Specifies an array of character pointers to null-terminated strings containing arguments to be passed to the main function of the new program.
tdm_spawnp(2) OSS System Calls Reference Manual When a program is executed as a result of a tdm_spawnp( ) call, it is entered as a function call: int main( int argc, char ∗ argv[ ], char ∗ envp); Here, the argc parameter is the argument count, the argv[ ] parameter is an array of character pointers to the arguments themselves, and the envp parameter is a pointer to a character array listing the environment variables. The argv[ ] array is terminated by a null pointer.
System Functions (t) tdm_spawnp(2) • argv[0] is set to the name of the command interpreter. • If the optional_string portion is present, argv[1] is set to optional_string. • The next element of argv[ ] is set to the original value of file. • The remaining elements of argv[ ] are set to the original elements of argv[ ], starting with argv[1]. The original argv[0] is discarded. The S_ISUID and S_ISGID mode bits of an executable text file are ignored.
tdm_spawnp(2) OSS System Calls Reference Manual Existing Sockets A socket associated with an open file descriptor in the calling process remains connected in the new process when the new process runs in the same processor as the calling process. When the new process runs in a different processor than the calling process, the processor that runs the new process must also be running a socket transport agent process.
System Functions (t) • tdm_spawnp(2) Signals pending in the parent process are disregarded by the child process. The inheritance structure can modify the default signal information as follows: • If the SPAWN_SETSIGMASK bit is set in inherit->flags, inherit->sigmask contains the signal mask for the child process. • If the SPAWN_SETSIGDEF bit is set in inherit->flags, inherit->sigdefault specifies the signal set that is forced to the default action in the child process.
tdm_spawnp(2) OSS System Calls Reference Manual • The child process has its own copy of a subset of the parent process’s file descriptors. See Open Files, earlier in this reference page. However, each of the child’s file descriptors shares a common file pointer with the corresponding file descriptor of the parent process. • The child process does not inherit file opens created by Guardian function or procedure calls. • The child process does not inherit file locks.
System Functions (t) • tdm_spawnp(2) Outstanding incoming and outgoing message limits This attribute assignment is different from the assignment made when creating a new process with Guardian procedures.
tdm_spawnp(2) OSS System Calls Reference Manual • For unnamed processes, the MOM field of the child process is NULL. For named processes, the ancestor field identifies the parent. • System debugger selection for the new process is based on the INSPECT mode flag in the program file. • Code breakpoints and memory breakpoints are not inherited. For detailed information about Guardian process attributes, see the PROCESS_LAUNCH_ procedure in the Guardian Procedure Calls Reference Manual.
System Functions (t) tdm_spawnp(2) The input structure passes this information: pe_len Specifies the size of the structure in bytes. This value is set by the #define DEFAULT_PROCESS_EXTENSION and should not be changed. pe_library_name Points to the name of the user library to be bound to the new process. The string that is pointed to is null-terminated and in OSS name format. If the pointer points to a zero-length string (a NULL character), the new process is run with no user library file.
tdm_spawnp(2) OSS System Calls Reference Manual pe_process_name Points to the null-terminated Guardian process name if _TPC_NAME_SUPPLIED is specified in the pe_name_options field. For example, if the Guardian process name is $DELM, the name used is /G/delm. pe_hometerm Points to the null-terminated name in the Guardian file system for the home terminal. For example, if the Guardian name is $ztnt.#xyz, the name used is /G/ztnt/#xyz. pe_memory_pages Specifies the size of the data stack in 2K-byte units.
System Functions (t) tdm_spawnp(2) _TPC_SUPPLIED_DEFINES_ONLY Propagates only the DEFINEs indicated by the pe_defines field. pe_defines Points to a specified saved set of DEFINEs created by using the Guardian DEFINESAVE procedure. These DEFINEs are propagated to the new process if either _TPC_SUPPLIED_DEFINES_ONLY or _TPC_BOTH_DEFINES is specified in the pe_create_options field. Note: This string is not null-terminated. pe_defines_len Specifies the length of the string in the pe_defines field.
tdm_spawnp(2) OSS System Calls Reference Manual pe_heap_max Specifies the maximum size of the heap in bytes for the new process if it is a native process. See the C/C++ Programmer’s Guide description of the HEAP pragma for guidance on the use of nonzero values for this field. If a value is specified for this field for G-series TNS or accelerated object files, the specified value is ignored. pe_space_guarantee Specifies the minimum available swap space to guarantee for the new process.
System Functions (t) tdm_spawnp(2) This example creates a new process under a different user ID: save = getuid(); setuid(newid); tdm_spawnp(...); setuid(save); RETURN VALUES Upon successful completion, the tdm_spawnp( ) function returns the OSS process ID of the child process to the parent process. If the pr_results parameter does not contain a null pointer, it returns the Guardian process handle of the new process in addition to the OSS process ID.
tdm_spawnp(2) OSS System Calls Reference Manual [EAGAIN] System resources such as disk space, process control block (PCB) space, MAPPOOL space, stack space, or PFS space are temporarily inadequate. [EBADF] A file descriptor pointed to by the fd_map[ ] parameter is invalid. [EFAULT] An address for a parameter in the process_extension structure pointed to by pe_parms is out of allowable bounds.
System Functions (t) [ENOENT] tdm_spawnp(2) One of these conditions exists: • One or more components of the new process image file’s pathname do not exist. • The file parameter points to an empty string. [ENOEXEC] The command interpreter could not be invoked following failure to execute the process image file identified by the file parameter. [ENOMEM] Required resources are not available. Subsequent calls to the same function will not succeed for the same reason.
tmpnam_r(2) OSS System Calls Reference Manual NAME tmpnam_r - Constructs the name for a temporary file (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include char *tmpnam_r ( char *buf ); PARAMETERS buf Specifies the address of an array of at least the number of bytes specified by L_tmpnam, a constant defined in the stdio.h header file.
System Functions (t) ttyname_r(2) NAME ttyname_r - Gets the name of a terminal (reentrant) LIBRARY G-series native OSS processes: /G/system/sysnn/zsptsrl H-series OSS processes: /G/system/zdllnnn/zsptdll SYNOPSIS [#include ] #include int ttyname_r ( int filedes, char *name, size_t namesize ); PARAMETERS filedes Specifies an open file descriptor. name Points to the buffer to receive the pathname. namesize Specifies the length of name passed in bytes.
ttyname_r(2) OSS System Calls Reference Manual RELATED INFORMATION Functions: ttyname(3). Miscellaneous: filename(5). STANDARDS CONFORMANCE This function is an extension to the UNIX98 specification. Interfaces documented on this reference page conform to the following industry standards: • IEEE Std 1003.1c-1995, POSIX System Application Program Interface The use of the header file spthread.h is an HP exception to the POSIX standard.
Section 9. System Functions (u) This section contains reference pages for Open System Services (OSS) system function calls with names that begin with u. These reference pages reside in the cat2 directory and are sorted alphabetically by U.S. English conventions in this section.
ulimit(2) OSS System Calls Reference Manual NAME ulimit - Sets and gets file size limits LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include long int ulimit( int cmd [ , ... /* long int blk_size */ ] ); In this instance, the ellipsis ( . . . ) indicates that the function is variable. An additional, optional parameter can be specified. PARAMETERS cmd Specifies the operation to be performed.
System Functions (u) [EPERM] ulimit(2) • The value specified for the cmd parameter is not valid. • The value specified for the second parameter is too large. The process does not have the appropriate privileges to perform the requested operation. RELATED INFORMATION Functions: creat(2), open(2), write(2). STANDARDS CONFORMANCE The following are HP extensions to the XPG4 Version 2 specification: • 527186-007 The error [EINVAL] is returned when the second parameter is too large.
umask(2) OSS System Calls Reference Manual NAME umask - Sets and gets the value of the file mode creation mask LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ mode_t umask( mode_t cmask); PARAMETERS cmask Specifies the value of the file mode creation mask.
System Functions (u) uname(2) NAME uname - Gets information identifying the current system LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int uname( struct utsname *name); PARAMETERS name Points to the utsname structure, where information about the current system is stored. DESCRIPTION The uname( ) function stores information identifying the current system in the structure pointed to by the name parameter.
uname(2) OSS System Calls Reference Manual RETURN VALUES Upon successful completion, a nonnegative value is returned. If the function call is unsuccessful, one of the following might happen: • The value -1 is returned and errno is set to indicate the error. • A Guardian trap is set. ERRORS If the following condition occurs, the uname( ) function sets errno to the corresponding value: [EFAULT] The name parameter points outside of the process address space. RELATED INFORMATION Commands: uname(1).
System Functions (u) unlink(2) NAME unlink - Removes a directory entry from the OSS environment LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include int unlink( const char *path); PARAMETERS path Specifies the directory entry to be removed. DESCRIPTION The unlink( ) function removes the directory entry specified by the path parameter and decrements the link count of the file referenced by the link.
unlink(2) OSS System Calls Reference Manual ERRORS If any of the following conditions occurs, the function sets errno to the corresponding value and the named file is not unlinked: [EACCES] One of the following conditions is true: • Search permission is denied for a component of the pathname prefix, or write permission is denied on the directory containing the link to be removed. • The S_ISVTX flag is set on the directory containing the existing file referred to by the path parameter.
System Functions (u) [ENOENT] [ENOROOT] unlink(2) One of the following conditions exists: • The named file does not exist. • The path parameter points to an empty string. • The path parameter specifies a file on a remote HP NonStop node but communication with the remote node has been lost. One of the following conditions exists: • The root fileset of the local node (fileset 0) is not in the STARTED state. • The current root fileset for the specified file is unavailable.
unlink(2) OSS System Calls Reference Manual The following are HP extensions to the XPG4 Version 2 specification: • 9−10 The errno values [EFAULT], [EFSBAD], [EGUARDIANOPEN], [EINVAL], [ENOROOT], [ENOTSUP], [ENXIO], and [EOSSNOTRUNNING] can be returned.
System Functions (u) utime(2) NAME utime - Sets file access and modification times LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ int utime( const char *path, struct utimbuf *times); PARAMETERS path Points to the pathname for the file. If the final component of the path parameter names a symbolic link, the link is traversed and pathname resolution continues.
utime(2) OSS System Calls Reference Manual Use From the Guardian Environment The file access time is not updated by I/O operations that are performed on a file that was opened in the Guardian environment (that is, by the FILE_OPEN_ or OPEN Guardian procedures).
System Functions (u) [ENOENT] [ENOROOT] utime(2) One of the following conditions exists: • The named file does not exist. • The path parameter points to an empty string. • The path parameter specifies a file on a remote HP NonStop node but communication with the remote node has been lost. One of the following conditions exists: • The root fileset of the local node (fileset 0) is not in the STARTED state. • The current root fileset for the specified file is unavailable.
Section 10. System Functions (w) This section contains reference pages for Open System Services (OSS) system function calls with names that begin with w. These reference pages reside in the cat2 directory and are sorted alphabetically by U.S. English conventions in this section.
wait(2) OSS System Calls Reference Manual NAME wait - Waits for any child process to terminate LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ pid_t wait( int ∗ status_location); PARAMETERS status_location Points to a location that receives the child process termination status, as defined in the sys/wait.h header file.
System Functions (w) wait(2) Status Information If the wait( ) function returns because the status of a child process is available, it returns the OSS process ID of the child process. In this case, if the status_location parameter is not a null pointer, information is stored in the location pointed to by status_location.
wait(2) OSS System Calls Reference Manual WSTOPSIG(∗∗status_location) If the value of WIFSTOPPED(∗∗status_location) is nonzero, evaluates to the number of the signal that caused the child process to stop. This macro is normally only useful with the waitpid( ) function. WTERMSIG(∗∗status_location) If the value of WIFSIGNALED(∗∗status_location) is nonzero, evaluates to the number of the signal that caused the termination of the child process.
System Functions (w) wait(2) Abnormal Termination Abnormal termination can occur for several reasons, including the following: • The child process calls the Guardian ABEND procedure, or it calls the Guardian PROCESS_STOP_ procedure with the parameters set for abnormal termination. • The processor in which the process was running fails. • Some critical system resource is exhausted.
wait(2) OSS System Calls Reference Manual RETURN VALUES If the wait( ) function returns because the status of a child process is available, the OSS process ID of the child is returned to the calling process. If a signal is received via pthread_kill(2) that is not blocked,ignored, or handled, -1 is returned with an errno of EINTR. Upon any error, the value -1 is returned and errno is set to indicate the error.
System Functions (w) waitpid(2) NAME waitpid - Waits for a specific child process to stop or terminate LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.1 */ pid_t waitpid( pid_t process_id, int ∗ status_location, int options); PARAMETERS process_id Specifies the child process.
waitpid(2) OSS System Calls Reference Manual modified by the values of the process_id and options parameters. Use From the Guardian Environment If called from a Guardian process, the actions of this function are undefined and errno is set to [ENOTOSS]. Specifying the Child Process The waitpid( ) function allows the calling process to gather status from a specific set of child processes. The waitpid( ) function returns the status of a child process from this set.
System Functions (w) waitpid(2) • The lower 8 bits of the completion code for a process that terminated itself by calling the Guardian STOP or PROCESS_STOP_ procedure • The lower 8 bits of the value that the child process returned from the main( ) function WIFABENDED(∗∗status_location) Evaluates to a nonzero value if the child process terminated abnormally. A SIGABEND signal was received.
waitpid(2) OSS System Calls Reference Manual • Calling the _exit( ) or exit( ) function. The exit status is placed in ∗ status_location. • Calling the Guardian STOP or PROCESS_STOP_ procedure with parameters set for self-termination. The completion code is placed in ∗ status_location. The parent process can use the WIFEXITED macro to detect a child process that terminates itself; WIFEXITED evaluates to a nonzero value.
System Functions (w) waitpid(2) Process Stopped If the WUNTRACED option is set in the waitpid( ) call, the call returns when the child process is temporarily suspended because it received a SIGTTIN, SIGTTOU, SIGSTOP, or SIGTSTOP signal. The WIFSTOPPED macro evaluates to a nonzero value. The WSTOPSIG macro evaluates to the number of the signal that caused the process to stop.
waitpid(2) OSS System Calls Reference Manual [EINTR] The function was terminated by receipt of a signal. The information pointed to by the status_location parameter is not meaningful when this error occurs and should not be used in further processing. [EINVAL] The value of the options parameter is invalid. [ENOTOSS] The calling process was not an OSS process. The waitpid( ) function cannot be used in the Guardian environment.
System Functions (w) write(2) NAME write - Writes to a file LIBRARY G-series native OSS processes: system library H-series OSS processes: implicit libraries SYNOPSIS #include #include /* optional except for POSIX.
write(2) OSS System Calls Reference Manual • If the size of the write( ) request is less than or equal to the value of the PIPE_BUF system variable, the write( ) function is guaranteed to be atomic. The data is not interleaved with data from other processes doing writes on the same pipe. • If the size of the write( ) request is greater than the value of the PIPE_BUF system variable, the file system attempts to resize the pipe buffer from 2 * PIPE_BUF to 65,536 bytes.
System Functions (w) write(2) Use on Guardian Objects Attempting to write to a Guardian file (that is, a file in /G) that is locked causes the write( ) function to return -1 and set errno to [EGUARDIANLOCKED]. RETURN VALUES Upon successful completion, the write( ) function returns the number of bytes that were actually written. Otherwise, the value -1 is returned, and errno is set to indicate the error.
write(2) OSS System Calls Reference Manual • A physical I/O error occurred. Data might have been lost during a transfer. [EISGUARDIAN] The value used for the filedes parameter is appropriate only in the Guardian environment. [ENETDOWN] The filedes parameter specifies a file on a remote HP NonStop node, but communication with the remote node has been lost. [ENOSPC] No free space is left on the fileset containing the file.
System Functions (w) write(2) RELATED INFORMATION Functions: creat(2), creat64(2), fcntl(2), lseek(2), lseek64(2), open(2), open64(2), pipe(2), socket(2), ulimit(3). STANDARDS CONFORMANCE The HP implementation does not generate the SIGXFSZ signal. The POSIX standards leave some features to the implementing vendor to define. These features are affected in the HP implementation: • Calls to the write( ) function with the nbytes parameter equal to 0 are supported for all regular and nonregular files.
writev(2) OSS System Calls Reference Manual NAME writev - Writes to a file from scattered buffers LIBRARY G-series native OSS processes: /G/system/sysnn/zossesrl H-series OSS processes: /G/system/zdllnnn/zossedll SYNOPSIS #include #include
System Functions (w) writev(2) Upon successful completion, the writev( ) function returns the number of bytes actually written to the file associated with filedes. If the O_APPEND status flag of the file is set, the file offset is set to the end of the file prior to each write. Write requests to a pipe or FIFO file are handled the same as writes to a regular file with these exceptions: • No file offset is associated with a pipe; therfore, each writev( ) request appends to the end of the pipe.
writev(2) OSS System Calls Reference Manual When attempting to write to a socket with no space available for data: • If the O_NONBLOCK flag is not set, the writev( ) function blocks until space becomes available or an error occurs. • If the O_NONBLOCK flag is set, the writev( ) function returns the value -1 and sets errno to [EWOULDBLOCK].
System Functions (w) writev(2) [EGUARDIANLOCKED] A writev( ) operation was attempted to a file in the Guardian file system (that is, a file in /G) that is locked. [EINTR] A writev( ) operation was interrupted by a signal before any data was written. [EINVAL] One of these conditions occurred: [EIO] • The file position pointer associated with the file specified by the filedes parameter was negative. • The value of the iov_count parameter was less than or equal to 0 (zero), or greater than IOV_MAX.
writev(2) OSS System Calls Reference Manual • An attempt was made to write to a socket that is shut down or closed. [ETIMEDOUT] Data transmission on the socket timed out. [EWOULDBLOCK] The process attempted an operation on a socket for which O_NONBLOCK is set, there is no space available, and no error has occurred.
Section 11. Files This section contains reference pages for some Open System Services (OSS) header files and special files. These reference pages reside in the cat4 and cat7 directories and are sorted alphabetically by U.S. English conventions in this section.
ar(4) OSS System Calls Reference Manual NAME ar - Describes the archive (library) file format SYNOPSIS #include DESCRIPTION The ar archive command combines several files into one. Archives are used mainly as libraries to be searched by the Binder utility for TNS or accelerated programs and by the nld utility for TSN/R native programs. A file produced by the ar command has a magic number at the start, followed by the constituent files, each preceded by a file header.
Files core(4) NAME core, saveabend - Is a file containing a memory image DESCRIPTION In the OSS implementation, the equivalent of a core file is a saveabend file. A saveabend file is a type of process snapshot file and can be used with a system debugger when necessary. A saveabend file is created whenever a process terminates abnormally and it is possible to create a saveabend file. The location of a saveabend file is displayed on the home terminal of the terminated process.
cpio(4) OSS System Calls Reference Manual NAME cpio - Describes the extended cpio archive file format SYNOPSIS #include DESCRIPTION The byte-oriented cpio archive file format is a series of entries, each entry made up of a header that describes the file and the name of the file, followed by the contents of the file. The format of the cpio header is described below. Table 11−1.
Files cpio(4) The archive entry for the name of a file has the following format: Table 11−2. cpio Archive File Filename Entry Format Field Name Length (in octets) Interpretation ____________________________________________ c_name c_namesize Pathname string The c_name field contains the pathname of the file as a string with the length given by the c_namesize field in the file header. This string length includes the null character that terminates the name.
cpio(4) OSS System Calls Reference Manual The cpio.h header file contains the following macro definitions: Table 11−4. cpio.
Files dir(4) NAME dir - Describes the format of directories SYNOPSIS #include #include DESCRIPTION A directory is a file that contains directory entries. The fact that a file is a directory is indicated by a bit in the flag word of the inode entry for the file. Users cannot write a directory. Users can read directory entries by making calls to the readdir( ) function after opening the directory file by calling the opendir( ) function.
float(4) OSS System Calls Reference Manual NAME float - Specifies the system limits for floating-point operations SYNOPSIS #include DESCRIPTION The float.h header file defines symbolic names. These symbolic names represent floating-point values for the two possible floating-point formats that a program can use. The floating-point format is chosen at compilation time. See the float.h header file for the actual values of these limits in the HP implementation.
Files float(4) Table 11−5. Values for Floating-Point Constants Symbolic Constant Tandem-Format Value IEEE-Format Value ______________________________________________________________________ DBL_DIG DBL_EPSILON 16 15 2.2204460492503131E-16 5.551115123125782720e17 DBL_MANT_DIG 55 53 DBL_MAX 1.15792089237316192e77 1.7976931348623157E+308 DBL_MAX_EXP 256 1024 DBL_MAX_10_EXP 77 308 DBL_MIN 1.7272337110188889e-77 2.2250738585072014E-308 DBL_MIN_EXP -254 -1021 DBL_MIN_10_EXP -77 -307 FLT_EPSILON 2.
limits(4) OSS System Calls Reference Manual NAME limits - Specifies the system limits SYNOPSIS #include DESCRIPTION The limits.h header file defines symbolic names. These symbolic names represent: • Implementation-dependent constants whose values set limits on system resources used by applications in the OSS environment. These values are all at least as large as minimum acceptable values set by the POSIX.1, POSIX.2, and XPG4 standards.
Files limits(4) CHAR_BIT Number of bits in an object of type char. This value is always 8. CHARCLASS_NAME_MAX Maximum number of bytes in a character class name. This value is always 255. CHAR_MAX Maximum value for a signed char. In the HP implementation, the type char is not considered a signed integer; CHAR_MAX is therefore treated like UCHAR_MAX. CHAR_MIN Minimum value for a signed char. In the HP implementation, the type char is not considered a signed integer; CHAR_MIN is therefore 0 (zero).
limits(4) OSS System Calls Reference Manual NL_ARGMAX Maximum value of the digit parameter in calls to the printf( ) and scanf( ) functions. NL_MSGMAX Maximum message number. NL_NMAX Maximum number of bytes in an N-to-1 collation mapping. NL_SETMAX Maximum number of filesets per catalog. NL_TEXTMAX Maximum number of bytes in a message string. PATH_MAX Maximum number of bytes in a pathname including the terminating null character.
Files limits(4) POSIX-Defined Minimum Values The symbolic constants in the following list are defined in the limits.h header file with values specified by the POSIX.1 and POSIX.2 standards or in the POSIX.12 draft standard. These symbolic names represent the most restrictive value for certain features. A portable application must not require a larger value for correct operation. The HP implementation defines some of the related symbolic constants to be less restrictive.
limits(4) OSS System Calls Reference Manual _POSIX_STREAM_MAX Maximum number of streams that one process can have open at one time. _POSIX_TZNAME_MAX Maximum number of bytes supported for the name of a time zone (not of the TZ variable). _POSIX2_BC_BASE_MAX Maximum obase values allowed by the bc utility. _POSIX2_BC_DIM_MAX Maximum number of elements permitted in an array by the bc utility. _POSIX2_BC_SCALE_MAX Maximum scale value allowed by the bc utility.
Files limits(4) MAX_CANON Maximum number of bytes in a terminal canonical input line. Use the pathconf( ) function to obtain this value at run time. MAX_INPUT Minimum number of bytes for which space is available in a terminal input queue; therefore, the maximum number of bytes a portable application can require to be entered as input before it reads them. Use the pathconf( ) function to obtain this value at run time. NAME_MAX Maximum number of bytes in a filename (excluding the terminating null).
limits(4) OSS System Calls Reference Manual Table 11−7.
Files math(4) NAME math - Specifies the mathematical constants SYNOPSIS #include DESCRIPTION The math.h header file defines symbolic names and constant values of type double. The symbolic names are: HUGE_VAL Specifies a positive double expression that cannot necessarily be represented as a type float value. Used as an error indicator when returned as a value for mathematics library functions. For Tandem-format floating-point data, the value of HUGE_VAL is DBL_MAX.
named.conf(4) OSS System Calls Reference Manual NAME named.conf - configuration file for BIND 9 domain name server named DESCRIPTION named.conf is the configuration file for the named server. Within the file, directive statements are enclosed in braces and terminated with a semi-colon. Clauses in the statements are also terminated with a semi-colon.
Files named.conf(4) controls controls { inet ( ipv4_address | ipv6_address | * ) [ port ( integer | * ) ] allow { address_match_element; ... } [ keys { string; ... } ]; unix unsupported; // not implemented }; logging logging { channel string { file log_file; syslog optional_facility; null; stderr; severity log_severity; print-time boolean; print-severity boolean; print-category boolean; }; category string { string; ...
named.
Files named.conf(4) ipv6_address [port integer] ); ... } edns-udp-size integer; root-delegation-only [ exclude { quoted_string; ... } ]; disable-algorithms string { string; ... }; dnssec-enable boolean; dnssec-lookaside string trust-anchor string; dnssec-must-be-secure string boolean; dialup dialuptype; ixfr-from-differences ixfrdiff; allow-query { address_match_element; ... }; allow-transfer { address_match_element; ... }; allow-update-forwarding { address_match_element; ...
named.conf(4) OSS System Calls Reference Manual allow-v6-synthesis { address_match_element; ...
Files named.conf(4) min-roots integer; // not implemented lame-ttl integer; max-ncache-ttl integer; max-cache-ttl integer; transfer-format ( many-answers | one-answer ); max-cache-size size_no_default; check-names ( master | slave | response ) ( fail | warn | ignore ); cache-file quoted_string; suppress-initial-notify boolean; // not yet implemented preferred-glue string; dual-stack-servers [ port integer ] { ( quoted_string [port integer] | ipv4_address [port integer] | ipv6_address [port integer] ); ...
named.conf(4) OSS System Calls Reference Manual transfer-source ( ipv4_address | * ) [ port ( integer | * ) ]; transfer-source-v6 ( ipv6_address | * ) [ port ( integer | * ) ]; alt-transfer-source ( ipv4_address | * ) [ port ( integer | * ) ]; alt-transfer-source-v6 ( ipv6_address | * ) [ port ( integer | * ) ]; use-alt-transfer-source boolean; zone-statistics boolean; key-directory quoted_string; allow-v6-synthesis { address_match_element; ...
Files named.conf(4) allow-notify { address_match_element; ... }; forward ( first | only ); forwarders [ port integer ] { ( ipv4_address | ipv6_address ) [ port integer ]; ...
null(7) OSS System Calls Reference Manual NAME null - Is a data sink file SYNOPSIS /dev/null DESCRIPTION Data written on a null special file is discarded. Reads from a null special file always return 0 (zero) bytes.
Files saveabend(4) NAME saveabend - Is a file containing a memory image DESCRIPTION See the core(4) reference page.
signal(4) OSS System Calls Reference Manual NAME signal - Contains definitions and variables used by signal functions SYNOPSIS #include DESCRIPTION The signal.h header file contains: • Declarations of symbolic constants used to refer to the signals that occur in the OSS environment. • Declarations for the sigset_t type and the sigaction structure.
Files signal(4) A process can elect to ignore the delivery of some signals, while allowing the system to perform default actions upon the delivery of other signals. The system also allows processes to install process-specific signal-catching functions. During the time between the generation of a signal and its delivery, the signal is said to be pending. Usually, this interval cannot be detected by an application. However, a signal can be blocked from delivery to a process.
signal(4) OSS System Calls Reference Manual The Signals The following table lists each signal name and corresponding signal number and default action. On receipt of one of these signals, the application can elect to: • Accept the default action; see Default Action, later in this reference page. • Ignore the signal; see Ignoring a Signal, later. • Catch the signal by invoking a signal-specific function; see Catching a Signal, later.
Files signal(4) SIGURG SIGUSR1 SIGUSR2 SIGWINCH 5 16 17 12 Discard signal Terminate process Terminate process Discard signal Urgent condition on I/O channel User-defined signal 1 User-defined signal 2 Terminal device window size changed For details of the process loop timer, see the SETLOOPTIMER procedure in the Guardian Procedure Calls Reference Manual.
signal(4) OSS System Calls Reference Manual — A file group ID that is the same as the effective group ID of the receiving process Note that the location of the saveabend file is different in the OSS environment than in the Guardian environment. In the Guardian environment, the file is created on the same subvolume as the program file. In the OSS environment, the file is created in the current working directory. Saveabend files are known on most UNIX systems as core files.
Files signal(4) The signal-catching function can cause the process to resume in a different context by calling the longjmp( ) function. When the longjmp( ) function is called, the process reverts to the state saved by a corresponding call to the setjmp( ) function.
signal(4) OSS System Calls Reference Manual STANDARDS CONFORMANCE The HP implementation does not provide the following signals defined in the XPG4 Version 2 specification: • SIGBUS, SIGPOLL, SIGPROF, SIGSYS, SIGTRAP, SIGVTALRM, SIGXCPU, and SIGXFSZ. The POSIX standards leave some features to the implementing vendor to define. The following features are affected in the HP implementation: • HP-specific signals are supported; see the extensions listed later.
Files spthread.h(4) NAME spthread.h - Thread-aware header file SYNOPSIS #include DESCRIPTION The header file contains the standard POSIX threads library API definitions. For reference, this reference page also documents the nonstandard POSIX extensions, thread-aware functions, thread-aware toolkit APIs, and thread-aware $RECEIVE APIs that are implemented in T1248 POSIX threads.
spthread.
Files spthread.
spthread.
Files spthread.h(4) int spt_sigaction( int, const struct sigaction *, struct sigaction * ); unsigned int spt_sleep( unsigned int ); int spt_usleep( unsigned int ); int spt_pause( ); int spt_sigpending( sigset_t * ); int spt_sigsuspend( const sigset_t * ); int spt_sigwait( sigset_t *, int * ); Thread-Aware Function Definitions If invoking a thread-aware function using the corresponding native UNIX function, first define SPT_THREAD_AWARE.
spthread.h(4) OSS System Calls Reference Manual int spt_gets( FILE *stream ); int spt_getw( FILE *stream ); wint_t spt_getwc( FILE *stream ); wint_t spt_getwchar( void ); int spt_printf( const char *format, ...
Files spthread.
spthread.
Files tar(4) NAME tar - Describes the extended tar archive file format SYNOPSIS #include DESCRIPTION tar archives are created by the tar command. These archives are standardized and suitable for porting between different systems. An extended tar archive or file consists of a series of blocks. Each block is a fixed size of 512 bytes. Each file within the archive is represented by a header block and zero or more data blocks that contain the contents of the file.
tar(4) OSS System Calls Reference Manual Symbolic constants used in the header block are defined in the header file /usr/include/tar.h.
Files tar(4) of the error and does not attempt to store the link in the archive. The mode field contains 9 bits specifying file permissions and 3 bits specifying the set user ID (TSUID), set group ID (TSGID), and unused TSVTX modes. When the user restoring the files from the archive does not have appropriate permission to set these bits, the bits for which the user does not have permission are ignored. The uid and gid fields are the user and group ID of the file’s owner and group, respectively.
termcap(4) OSS System Calls Reference Manual NAME termcap - Describes the terminal capability database SYNOPSIS /etc/termcap DESCRIPTION The termcap database describes terminals. It is used, for example, by the libtermcap library. Terminals are described in termcap by giving a set of capabilities that they have and by describing how operations are performed. Padding requirements and initialization sequences are also included in termcap. Entries in termcap consist of fields separated by colons (:).
Files termcap(4) str String capabilities, which give character sequences that can be used to perform particular terminal operations. The following table describes the capabilities used to describe terminals. Notes to the table: N Indicates numeric parameter(s). P Indicates that padding can be specified. * Indicates that padding can be based on the number of lines affected. o Indicates that the capability is obsolete. New software should not rely on this capability at all. Table 11−11.
termcap(4) dm dN DO do ds dT dV ec ed ei eo EP es ff fs gn hc HD hd ho hs hu hz i1-i3 IC ic if im in iP ip is it K1 K2 K3 K4 K5 k0-k9 kA ka kb kC kD kd kE ke kF 11−48 OSS System Calls Reference Manual L str L num L str L str L L str L num L num L str L str L str L bool L bool L L bool L str L str L bool L bool L bool L str L str L bool L L str L bool L str L str L str L str L str L bool L L str L str L str L num L str L L str L str L str L str L str L str L str L str L str L str L str L str L L str L st
Files termcap(4) kH kh kI kL kl kM km kN kn ko kP kR kr kS ks kT kt ku l0-l9 LC LE le li ll lm ma mb md me mh mi mk ml mm mo mp mr ms mu nc nd NL nl ns nw OP os 527186-007 L str L str L str L L str L str L str L bool L str L num L L str L str L str L str L str L str L str L str L L str L str L bool L str L str L num L L str L num L str L str L str L L str L str L bool L str L str L str L str L str L str L bool L L str L bool L str L bool L str L L bool L str L bool L bool L L L L L L L L L L (o) L L (o
termcap(4) pb pc pf pk pl pO po ps pt px r1-r3 rc rf RI rp rs sa sc se SF sf sg so SR sr st ta tc te ti ts UC uc ue ug ul UP up us vb ve vi vs vt wi ws xb 11−50 OSS System Calls Reference Manual L num L str L L str L str L str L str L str L str L L bool L str L str L str L L str L str L str L str L str L str L str L str L str L L num L str L str L str L str L str L str L L str L str L str L bool L str L str L L num L bool L str L str L str L str L str L L str L str L num L str L num L bool L L L L L L
Files termcap(4) xn xo xr xs xt xx L bool L bool L L bool L bool L bool L L bool L L L L (o) L L L L (o) L Newline ignored after 80 columns (Concept) L Terminal uses xoff/xon (DC3/2DC1) handshaking L L Return acts like ce cr nl (Delta Data) L Standout not erased by overwriting (Hewlett-Packard terminals) L Tabs ruin magic so character (Teleray 1061 terminal) L L Tektronix 4025 terminal insert-line A Sample Entry The following entry, which describes the Concept-100, is among the more complex entries i
termcap(4) OSS System Calls Reference Manual string capability, it must be encoded as \200. (The routines that deal with termcap use C strings and strip the high bits off the output very late, so that \200 has the same result as \000.) In the termcap file, individual capabilities must sometimes be commented out. To do this, put a . (dot) before the capability name. For example, see the first cr and ta capabilities in the preceding example.
Files termcap(4) :am:bl=ˆG:cl=ˆZ:co#80:cr=ˆM:do=ˆJ:le=ˆH:li#24:sf=ˆJ: Parameterized Strings Cursor addressing and other strings requiring parameters are described by a parameterized string capability, with escape encodings like those of the printf( ) function (%x) in it, while other characters are passed through unchanged. For example, to address the cursor, the cm capability is given, using two parameters: the row and column to move to.
termcap(4) OSS System Calls Reference Manual Cursor Motions If the terminal has a fast way to home the cursor (to the upper left-hand corner of the screen), this can be given as the ho capability.
Files termcap(4) Keypad Support If the terminal has a keypad that transmits codes when the keys are pressed, this information can be provided in termcap. Note that it is not possible to handle terminals where the keypad works only in local mode (this applies, for example, to the unshifted Hewlett-Packard 2621 terminal’s keys). If the keypad can be set to transmit or not transmit, specify the ks and ke capabilities. Otherwise, the keypad is assumed to always transmit.
termcap(4) OSS System Calls Reference Manual terminal.) Tabs and Initialization If the terminal needs to be in a special mode when running a program that uses these capabilities, the codes to enter and exit this mode can be specified by the ti and te capabilities. This need arises, for example, from terminals like the Concept terminal with more than one page of memory.
Files termcap(4) Special strings to go to a position in the status line and to return from the status line can be given as the ts and fs capabilities. (Note that fs must leave the cursor position in the same place that it was before ts. If necessary, the strings from the sc and rc capabilities can be included in ts and fs to get this effect.) The ts capability takes one parameter, which is the column number of the status line to which the cursor is to be moved.
termcap(4) OSS System Calls Reference Manual pf, is transparently passed to the printer while pO is in effect. Similar Terminals If there are two very similar terminals, one can be defined as being just like the other with certain exceptions. The tc string capability can be given with the name of the similar terminal. This capability must be specified last, and the combined length of the entries must not exceed 1024. The capabilities given before tc override those in the terminal type invoked by tc.
Files termios(4) NAME termios - Describes the terminal interface for POSIX compatibility SYNOPSIS #include DESCRIPTION The /usr/include/termios.h header file contains information used by system calls that apply to terminal files. The definitions, values, and structure in this file are required for compatibility with the Institute of Electrical and Electronics Engineers (IEEE) P1003.1 Portable Operating System Interface for Computer Environments (POSIX) standard.
termios(4) c_oflag OSS System Calls Reference Manual IXON Enables start and stop output control. If set, a received STOP character suspends output and a received START character restarts output. The START and STOP characters perform flow control functions, but they are not read. This flag is initially set by default. PARMRK Marks parity errors.
Files termios(4) CSTOPB Specifies the number of stop bits. If set, two stop bits are sent; if not set, only one stop bit is sent. Higher baud rates require two stop bits. (At 110 baud, for example, 2 stop bits are required.) CS5 Specifies a data byte of 5 bits. This value is ignored in the current release. CS6 Specifies a data byte of 6 bits. This value is ignored in the current release. CS7 Specifies a data byte of 7 bits. CS8 Specifies a data byte of 8 bits. HUPCL Hangs up on last close.
termios(4) OSS System Calls Reference Manual characters, respectively. The time value represents tenths of a second. IEXTEN Enable extended (implementation-defined) functions. Not supported in the current release. ISIG Enables signals. If set, each input character is checked against the INTR and QUIT special control characters. If a character matches one of these control characters, the function associated with that character is performed. If ISIG is not set, checking is not done.
Files termios(4) VSTART Indexes the START control character (), which resumes output that has been suspended by a STOP character. START characters are ignored if the output is not suspended. VSTOP Indexes the STOP control character (), which can be used to temporarily suspend output. This character is recognized during both input and output if IXOFF (input control) or IXON (output control) is set.
termios(4) OSS System Calls Reference Manual RELATED INFORMATION Commands: sh(1). Functions: tcflow(3), tcflush(3), tcsetattr(3). STANDARDS CONFORMANCE The HP implementation does not support the following symbolic values for the c_oflag field in the XPG4 Version 2 specification: • 11−64 BSDLY, CRDLY, FFDLY, NLDLY, OFILL, TABDLY, and VTDLY.
Files tty(7) NAME tty - Is the general terminal interface SYNOPSIS #include DESCRIPTION The tty interface is the general interface for terminal devices. This interface supplies all the functions needed for I/O over console serial lines, workstation screens, keyboards, and other terminal devices. It consists of the special file /dev/tty and terminal drivers used for conversational computing.
tty(7) OSS System Calls Reference Manual process group. With the setpgid( ) function, other processes can be added to a process group. A controlling terminal can have a process group associated with it that is known as the foreground process group. The terminal’s foreground process group is the one that receives signals generated by the VINTR, VQUIT, and VSUSP special control characters.
Files tty(7) VMIN=0, VTIME=0 In this case, either the number of requested bytes or the number of currently available bytes is returned, depending on which is less. The read( ) function call returns 0 (zero) if no data was read. Canonical mode is entered by setting the ICANON flag of the c_lflag field in the terminal’s termios structure. Other input processing is performed according to the other flags set in the c_iflag and c_lflag fields. Input Editing A terminal ordinarily operates in full-duplex mode.
tty(7) OSS System Calls Reference Manual echoed as a return and does not terminate canonical mode input. Input Modes The termios structure has an input mode field c_iflag, which controls basic terminal input characteristics. These characteristics are masks that can be bitwise inclusive ORed. The masks include: BRKINT An interrupt is signaled on a break condition. ICRNL All carriage returns are mapped to newline characters when input. IGNBRK Break conditions are ignored.
Files tty(7) Input Echoing and Redisplay The terminal driver has several modes for handling the echoing of terminal input, controlled by bits in the c_lflag field of the termios structure. Erasing Characters From a CRT When a CRT terminal is in use, the ECHOE bit of the c_lflag field of the termios structure can be set to cause input to be erased from the screen with a backspace-space-backspace sequence when character-deleting or word-deleting sequences are used.
tty(7) OSS System Calls Reference Manual SIGTTOU signal, the writes to the terminal are allowed and the SIGTTOU signal is not sent. If TOSTOP is set, if the writing process’s process group is orphaned, and if SIGTTOU is not blocked by the writing process, the write operation returns the value -1 with errno set to [EIO] and does not a send a signal.
Files tty(7) RELATED INFORMATION Functions: tcdrain(3), tcflush(3), tcgetattr(3), tcgetpgrp(3), tcsendbreak(3), tcsetattr(3), tcsetpgrp(3). Commands: sh(1). Files: termios(4).
Section 12. Miscellaneous This section contains reference pages for some miscellaneous Open System Services (OSS) topics. These reference pages reside in the cat5 directory and are sorted alphabetically by U.S. English conventions in this section.
acl(5) OSS System Calls Reference Manual NAME acl - Introduction to OSS access control lists (ACLs) DESCRIPTION Access control lists (ACLs) are a key enforcement mechanism of discretionary access control (see "Definitions" later in this reference page). ACLs specify access to files by users and groups more selectively than traditional UNIX mechanisms.
Miscellaneous acl(5) access control list (ACL) entry An entry in an ACL that specifies access rights for a file owner, owning group, group class, additional user, additional group, or all others. change permission The right to alter DAC information (permission bits or ACL entries). Change permission is granted to object (file) owners and to privileged users. discretionary access control (DAC) A means of restricting access to objects based on the identity of subjects, groups to which they belong, or both.
acl(5) OSS System Calls Reference Manual An ACL entry prefixed with d: or default: can only occur in ACLs for directories. The prefix indicates that the remainder of the entry is not to be used in determining the access rights to the directory but is instead to be applied to any files or subdirectories created in the directory (see "ACL Inheritance" later in this reference page).
Miscellaneous acl(5) ________________________________________________________________ L Notation L Entry Type Description ________________________________________________________________ L user:uid:perm USER Permissions for the user specified by uid L L________________________________________________________________ GROUP Permissions for the group specified by gid LL L group:gid:perm Examples of nondefault optional ACL entries: u:mary:rwx Grant read, write, and execute access to the user mary.
acl(5) OSS System Calls Reference Manual ACL Uniqueness Entries are unique in each ACL. An ACL can contain only one of each type of base entry, and one entry for any given user or group ID. Likewise, an ACL can contain only one of each type of default base entry, and one default entry for any given user or group ID.
Miscellaneous acl(5) If both the fileset for the created file and the system in which the process is running support OSS ACLs, and the parent directory for the created file does not have default ACL entries, the permissions of the created file are the mode bitwise-ANDed with the complement of the umask.
acl(5) OSS System Calls Reference Manual other:rwx default:user:beta:r-default:user:gamma:r-default:group:dos:--default:group:tres:--In this example, the ACL for a new file created in the directory /a includes the default ACL entries for directory /a as actual (nondefault) ACL entries: # file: /a/newfile # owner: creator_uid # group: creator_gid user::rwuser:beta:r-user:gamma:r-group::r-group:dos:--group:tres:--class:r-other:r-In this example, a new directory, dir is created in the /a directory.
Miscellaneous acl(5) permissions specified in the class entry bitwise-ANDed with the result of bitwise-ORing together all of the permissions in all matching group entries. Otherwise, continue to the next check. 4. Grant the permissions specified in the other: ACL entry. Because the checks are performed in this order and the ID match checking stops when a match is found, you can use optional user or group ACL entries with restrictive permissions to deny access to certain users or groups.
acl(5) OSS System Calls Reference Manual granted by any additional user:uid: or group:gid: entries. If the chmod( ) function is used on an object that does not have optional ACL entries, both the class ACL entry and the owning group ACL entry permission bits are changed to the new group permissions value.
Miscellaneous acl(5) #include #include #include #include #define READPERM 4 #define CALCCLASS 1 typedef struct acl acl_t; void printAcl( char *header, acl_t *aclEnt, int count ) { int i; printf("%s\n",header); for (i= 0; i < count; i++) { printf("acl entry %d ", i); printf("\ta_type = %d ", aclEnt[i].a_type ); printf("\ta_id = %d ", aclEnt[i].a_id ); printf("\ta_perm = %o\n", aclEnt[i].
acl(5) OSS System Calls Reference Manual aclEnt[ newCount-1 ].
Miscellaneous ascii(5) NAME ascii - Describes the octal, hexadecimal, and decimal ASCII character sets DESCRIPTION The octal character set is as follows: Table 12−1.
ascii(5) OSS System Calls Reference Manual The decimal character set is as follows: Table 12−3.
Miscellaneous environ(5) NAME environ - Contains the user environment SYNOPSIS extern char **environ; DESCRIPTION An array of strings called the environment is made available by the execl( ), execle( ), execlp( ), execv( ), execve( ), execvp( ), tdm_execve( ), or tdm_execvep( ) function when a process begins. The same array is optionally made available by the tdm_spawn( ) or tdm_spawnp( ) function when a process begins.
environ(5) OSS System Calls Reference Manual CELL_ADMIN_PW Specifies the default password assigned to the accounts created when the registry database is created, including the account for the registry creator. Used by the dce_config command. The default is -dce-. CELL_NAME Specifies the name of the cell (without the /.../) on which the configuration is being performed. Used during security server configuration by the dce_config command.
Miscellaneous environ(5) COPY_CONFIG_INFO Specifies whether the configuration should be copied from another virtual host. Used by the dce_config command. Copying implies that an additional CDS or security server is being configured to be a replica of the virtual host named by the COPY_CONFIG_HOST environment variable. Valid values are: y Indicates that copying should occur n Indicates that copying should not occur The default is n.
environ(5) OSS System Calls Reference Manual start or do not respond until the specified process is running. DCE_SOCKET_REUSE Specifies whether the IP address for the dced process is reused when the process is restarted. Valid values are: 0 (zero) The address is not reused. 1 The socket SO_REUSEADDR option is used at the time of binding port 135 so that even if the port is used by another process, dced restarts sucessfully. The default is 0 (zero). Used by the dce_config command.
Miscellaneous environ(5) DISPLAY_THRESHOLD Specifies the messages to write to the standard output file. Valid values are: DEBUG DETAIL ERROR WARNING SUMMARY VERBOSE The default is SUMMARY. Used by the dce_config command. DO_CHECKS Controls whether the prompt Press to continue, CTRL-C to exit: is returned when dce_config encounters a nonfatal error. This prompt forces the user to acknowledge the error and offers a way to exit dce_config.
environ(5) OSS System Calls Reference Manual ENV Specifies the path used to find the script to be executed when the shell is invoked. EXINIT Provides a start-up list of commands read by the vi utility. EXIT_ON_ERROR Indicates whether dce_config exits in the event of a fatal error. Valid values are: y Indicates that dce_config exits when it encounters a fatal error n Indicates that dce_config does not exit when it encounters a fatal error The default is n.
Miscellaneous environ(5) ll_TT.CODESET ll Is a 2-letter, lowercase abbreviation for the language name. The abbreviations come from ISO 639. For example: en English fr French ja Japanese de German (from Deutsch) TT Is a 2-letter, uppercase abbreviation for the territory name. The abbreviations come from ISO 3166. For example: US United States of America JP Japan NL The Netherlands ES Spain (from España) CODESET Is the name of the code set or encoding method.
environ(5) OSS System Calls Reference Manual LC_MONETARY Sets the locale to be used for formatting monetary values. See the description of LANG for locale name syntax. LC_NUMERIC Sets the locale to be used for formatting and parsing numeric values. See the description of LANG for locale name syntax. LC_TIME Sets the locale to be used for formatting and parsing date and time values. See the description of LANG for locale name syntax.
Miscellaneous MXCMP environ(5) Determines the pathname of the NonStop SQL/MX release 1 compiler. /G/system/system/mxcmp is the default. Used by the compiler utilities. MXCMPUM Determines the pathname of the NonStop SQL/MX release 2 compiler. /usr/tandem/sqlmx/bin/mxCompileUserModule is the default. Used by the compiler utilities. MXSQLC Determines the pathname of the NonStop SQL/MX preprocessor, mxsqlc. /usr/tandem/sqlmx/bin/mxsqlc is the default. Used by the c89 command.
environ(5) OSS System Calls Reference Manual PS1 Specifies the primary prompt string used by the shell. PS2 Specifies the secondary prompt string used by the shell. PS3 Specifies the selection prompt string used by the shell within a loop. PS4 Specifies the prompt string used by the shell during an execution trace. PWD Specifies the user’s initial working directory, as known to the osh command. The value is converted from the Guardian PARAM PWD.
Miscellaneous environ(5) REPLICATE_ALL_DIRS Specifies whether to replicate all directories from the master CDS server database to the additional CDS server database during additional CDS server configuration. Used by the dce_config command. The value y indicates that all directories should be replicated. The value n indicates that no directories should be replicated. The default is n. REPLICATE_DIR_LIST Specifies a list of directories to be replicated. Used by the dce_config command.
environ(5) OSS System Calls Reference Manual SQLMX_PREPROCESSOR_VERSION Indicates the preprocessor rules and features to be used. Specifying the value 800 causes rules and features associated with release 1.8 to be used; the mxcmp compiler is used and only MDF files and annotated source files are produced, while rules and features associated with release 2.0 and later are ignored. Specifying a value of 1200 or larger or not specifying a value causes rules and features associated with release 2.
Miscellaneous environ(5) process is used. TCPIP_RESOLVER_NAME Specifies the OSS pathname to be used instead of /etc/resolv.conf to identify the dynamic name server to be used when resolving Internet addresses. Equivalent to the Guardian environment DEFINE =TCPIPˆRESOLVERˆNAME. TCPIP_RESOLVER_ORDER Controls the search order for TCP/IPv6 when OSS socket calls require access to addresses for a given host.
environ(5) OSS System Calls Reference Manual TIME_SERVER Specifies the virtual host that the security client will try to synchronize its clock against. This host must have a DTS server (dtsd) running on it. The recommended choice for the host is the one running the master security server (the name specified in the SEC_SERVER variable). Used by the dce_config command. TMOUT Specifies the number of seconds the shell waits for a response to a prompt before timing out.
Miscellaneous environ(5) alternative time is assumed to be one hour ahead of standard time. One or more digits can be used; the value is always interpreted as a decimal number. The hour is between 0 (zero) and 24, and the minutes (and seconds) are between 0 (zero) and 59. Use of values outside these ranges causes undefined behavior.
environ(5) OSS System Calls Reference Manual Valid values are: y Indicates that clones should be updated n Indicates that clones should not be updated The default is n. Used by the dce_config command. USE_DEF_MSG_PATH Specifies whether to use the default pathname when installing DCE message catalogs. Used by the dce_config command. The value y indicates that message catalogs should be installed in the default directory /usr/lib/nls/msg/en_US.ISO8859-1.
Miscellaneous environ(5) frequently exported by .profile files, such as PS1, PS2, and IFS. RELATED INFORMATION Commands: c89(1), dce_config(8) if installed, gtacl(1), osh(1), sh(1). Functions: catopen(3), exec(2), getenv(3), iconv_open(3), putenv(3), syslog(3), tdm_execve(2), tdm_execvep(2). Files: termcap(4).
errno(5) OSS System Calls Reference Manual NAME errno - Returns the error condition value SYNOPSIS #include DESCRIPTION The errno external variable contains the most recent error condition set by a function. The symbolic error names returned by a function and descriptions of each error condition are shown in the ERRORS section in the individual function reference pages. The errno.h header file contains a list of all symbolic error names and a one-line description of each.
Miscellaneous errno(5) [EBIGDIR] The positioning within an OSS directory failed because there were more than 65535 file names beginning with the same two characters in the directory. [EBUSY] Mount device busy. The program attempted to use a system resource that is not currently available, because it is being used by another process in a manner that would conflict with the request being made by this process. [ECHILD] No child process.
errno(5) OSS System Calls Reference Manual [EFILEBAD] Corrupt Guardian file or bad EDIT file structure. The program used the open( ) or read( ) function for an EDIT file (Guardian file code 101) in /G (the Guardian file system) that has an internal structure problem. [EFSBAD] Fileset catalog internal consistency error. The program attempted an operation involving a fileset with a corrupted fileset catalog. [EFSERR] File system internal error.
Miscellaneous [EINVAL] errno(5) Invalid function parameter. One of the following conditions exists: • The program supplied an invalid parameter value. • The system does not support execution of a new program file in the binary format used by a specified program file. [EIO] I/O error. Some physical input or output error has occurred. Either a file cannot be opened because of an input or output error or data has been lost during an input or output transfer.
errno(5) OSS System Calls Reference Manual [ENETUNREACH] Network unreachable. No path exists between the node and the network. [ENFILE] File table overflow. Too many files are currently open in the system. The system has reached its predefined limit for simultaneously open files and temporarily cannot accept requests to open another one. [ENOBUFS] Buffer space unavailable. No buffer space is available. [ENOCPU] CPU unavailable.
Miscellaneous errno(5) [ENOSPC] No space left on device. During the write( ) function on a regular file or when extending a directory, there is no free space left on the device. [ENOSYS] Function not implemented. An attempt was made to use a function that is not available in this implementation. [ENOTCONN] Socket not connected. The socket is not connected. [ENOTDIR] Not a directory. The program attempted a directory operation on an object that is not a directory. [ENOTEMPTY] Directory not empty.
errno(5) OSS System Calls Reference Manual [EPFNOSUPPORT] Protocol family not supported. The program specified a protocol family that is not supported. [EPIPE] Broken pipe or no reader on socket. The program attempted to write on a pipe, FIFO, or socket for which there is no process to read the data. [EPROTONOSUPPORT] Protocol not supported. The program specified a protocol that is not supported. [EPROTOTYPE] Wrong protocol type. The program specified the wrong protocol for the type of socket.
Miscellaneous errno(5) [EVERSION] A version number mismatch exists. [EWOULDBLOCK] The operation requested by the program would block. [EWRONGID] One of the following conditions occurred: [EXDEV] • The process attempted an operation through an operating system input/output process (such as a terminal server process) that has failed or is in the down state. • The processor for the disk process of the specified file failed during an input or output operation and takeover by the backup process occurred.
filename(5) OSS System Calls Reference Manual NAME filename, pathname - Explains OSS file system file naming SYNOPSIS For OSS files: filename pathname For local Guardian disk files used from the OSS environment: /G/volume_name/subvolume_name/file_id For local Guardian temporary disk files used from the OSS environment: /G/volume_name/temp_file_id For local Guardian nondisk devices used from the OSS environment: /G/device_name/qualifier For remote Guardian disk files used from the OSS environment: /E/nod
Miscellaneous filename(5) a single slash. An absolute pathname begins with a slash character. An absolute pathname identifies an OSS file with respect to the current root directory. A relative pathname does not begin with a slash character. A relative pathname identifies an OSS file with respect to the current working directory. The filename_1 parameter specifies a directory. If filename_1 is a single period character (. , called dot), then filename_1 indicates the OSS current working directory.
filename(5) OSS System Calls Reference Manual qualifier Specifies a unique identifier significant to the device. A qualifier is a character string of two to eight valid characters. The first character must be a number sign (#). Valid characters for the rest of the string are the letters a through z, and the digits 0 through 9. (Uppercase letters A through Z are accepted but converted to lowercase letters.) The second character must be a letter.
Miscellaneous • filename(5) Unnamed processes The type of object determines the syntax for the Guardian filename and which subset of the permitted characters is allowed in the parts of that filename. For a disk file, the Guardian filename consists of the following four parts, separated by periods: node name A character string of two to eight valid characters, specifying the node within the NonStop server Expand network. The first character must be a backslash (\).
filename(5) OSS System Calls Reference Manual qualifier A character string of two to eight valid characters, specifying a unique identifier significant to the device. The first character must be a number sign (#). Valid characters for the rest of the string are the letters A through Z and the digits 0 through 9. The second character must be a letter. For a named process, Guardian filename rules are complex.
Miscellaneous filename(5) • Lowercase letters are not translated to uppercase for filename pattern matching. Pattern matching is case-insensitive in the Guardian file system. • Slashes between OSS filenames are translated to periods. EXAMPLES 1. The following is an example of an absolute OSS pathname: /usr/ccomp/prog1.c 2. The following is an example of an absolute OSS pathname: /usr/ccomp/prog1.c 3.
filename(5) OSS System Calls Reference Manual 12. The following is an example of translating a Guardian filename to an OSS pathname. If \LOCAL.$ZTNT.#PTY0001 is a nondisk device that needs to be passed to an OSS function, it can be referred to by specifying /G/ztnt/#pty0001. NOTES Guardian subvolume names and file identifiers beginning with the letter Z are reserved. Do not use such names for files in the /G directory.
Miscellaneous hier(5) NAME hier - Explains the OSS file system hierarchy DESCRIPTION This reference page describes the file system hierarchy. Subdirectories (and some files) are listed indented after the directory that they appear in. / Root directory of the local OSS file system. /bin/ Utility program files, including system and internationalization utilities.
hier(5) OSS System Calls Reference Manual usr/ G-series TNS or accelerated files corresponding to the native files found in /usr/. share/man/ Reference page files for use with the apropos, man, and whatis commands when the corresponding G-series TNS or accelerated function or utility cannot be described in the reference page files found in /usr/share/man/. Use the command man -M /nonnative/usr/share/man topic to read these reference pages.
Miscellaneous pathname(5) NAME pathname - Explains OSS file system path naming DESCRIPTION See the filename(5) reference page.
process_extension_results(5) OSS System Calls Reference Manual NAME process_extension_results - Contains the status of a process creation attempt SYNOPSIS #include struct process_extension_results ∗ pr_results; PARAMETERS pr_results Points to the output structure containing optional process identification and error information. In case of error, this structure provides additional information including the PROCESS_LAUNCH_ procedure error and error detail.
Miscellaneous process_extension_results(5) RETURN VALUES Upon successful completion of the function call, this structure returns the following information: pr_len Specifies the size in bytes of the structure. This value is the one specified as input. pr_phandle Contains the Guardian process handle of the new process. pr_pid Contains the OSS process ID of the new process. pr_errno Contains the OSS error number normally returned in errno. pr_TPCerror Identifies the process creation error.
process_extension_results(5) OSS System Calls Reference Manual _TPC_BAD_ENVIRON One of the pointers in the environ array is invalid. Issued for: tdm_execve( ), tdm_execvep( ), tdm_spawn( ), tdm_spawnp( ). _TPC_BAD_ENVP The pointer to the envp[ ] array parameter of the calling function or one of the entries in the array is invalid. Issued for: tdm_execve( ), tdm_execvep( ), tdm_spawn( ), tdm_spawnp( ). _TPC_BAD_ERROR_DETAIL An internal OSS software error occurred.
Miscellaneous process_extension_results(5) _TPC_BAD_OUTPUT An internal OSS software error occurred. If the problem persists, follow site-defined procedures for reporting software problems to HP. Issued for: tdm_execve( ), tdm_execvep( ), tdm_fork( ), tdm_spawn( ). _TPC_BAD_OUTPUT_LEN An internal OSS software error occurred. If the problem persists, follow site-defined procedures for reporting software problems to HP. Issued for: tdm_execve( ), tdm_execvep( ), tdm_fork( ), tdm_spawn( ).
process_extension_results(5) OSS System Calls Reference Manual _TPC_BAD_SWAP The pointer to the pe_swap_file_name field in the structure pointed to by the pe_parms parameter of the calling function is invalid. Issued for: tdm_execve( ), tdm_execvep( ), tdm_fork( ), tdm_spawn( ), tdm_spawnp( ). _TPC_BAD_UC The file parameter pointer of the calling function is invalid. Issued for: tdm_execve( ), tdm_execvep( ), tdm_spawn( ), tdm_spawnp( ).
Miscellaneous process_extension_results(5) _TPC_BAD_DEFINES The pe_defines field in the structure pointed to by the pe_parms parameter of the calling function is invalid. Issued for: tdm_execvep( ), tdm_fork( ), tdm_spawn( ), tdm_spawnp( ). _TPC_BAD_EXTENSION The structure pointed to by the pe_parms parameter of the calling function and used in the function call is invalid. Issued for: tdm_execve( ), tdm_execvep( ), tdm_fork( ), tdm_spawn( ), tdm_spawnp( ).
process_extension_results(5) OSS System Calls Reference Manual _TPC_BAD_JOB The pe_jobid field in the structure pointed to by the pe_parms parameter of the calling function contains an invalid value. Issued for: tdm_execve( ), tdm_execvep( ), tdm_fork( ), tdm_spawn( ), tdm_spawnp( ). _TPC_BAD_MEM The pe_memory_pages field in the structure pointed to by the pe_parms parameter of the calling function contains an invalid value.
Miscellaneous process_extension_results(5) _TPC_BAD_PIMFILE An internal OSS software error occurred. If the problem persists, follow site-defined procedures for reporting software problems to HP. Issued for: tdm_execve( ), tdm_execvep( ), tdm_fork( ), tdm_spawn( ), tdm_spawnp( ). _TPC_BAD_PRIO The pe_priority field in the structure pointed to by the pe_parms parameter of the calling function contains an invalid value. Issued for: tdm_execve( ), tdm_execvep( ), tdm_fork( ), tdm_spawn( ), tdm_spawnp( ).
process_extension_results(5) OSS System Calls Reference Manual For information about specific Guardian file-system errors, see the discussion of file-system errors in the Guardian Procedure Errors and Messages Manual. RELATED INFORMATION Functions: tdm_execve(2), tdm_execvep(2), tdm_fork(2), tdm_spawn(2), tdm_spawnp(2). STANDARDS CONFORMANCE This structure is an extension to the XPG4 Version 2 specification.
Miscellaneous resolv.conf(5) NAME resolv.conf - BIND 9 Domain Name System resolver configuration file DESCRIPTION The default configuration file /etc/resolv.conf provides an explicit default domain name for the Domain Name System (DNS) to use, and identifies name servers on other processors. The BIND 9 resolver system can be used with other, nondefault versions of resolv.conf. Each entry in a resolv.
resolv.conf(5) OSS System Calls Reference Manual might be slow and generates a lot of network traffic if the servers for the listed domains are not local. Queries time out if no server is available for one of the domains. The domain and search keywords are mutually exclusive. If more than one instance of these keywords is present, the last instance takes precedence. sortlist addresslist Allows addresses returned by internal function calls to be sorted.
Miscellaneous resolv.conf(5) RELATED INFORMATION Commands: dnssec_named(8), named(8). Functions: gethostbyaddr(3), gethostbyname(3), gethostbyname2(3), setnetent(3). Files: hosts(4), networks(4), protocols(4), resolv.conf(4), services(4).
Permuted Index _____________________________ spt_fputwc: Thread-aware fputwc( required by spt_regFileIOHandler( spt_fputc: Thread-aware fputc( required by spt_regTimerHandler( /Initiates thread-aware select( /Initiates thread-aware select( Renames a file (Guardian rename( a file or directory (OSS rename( Initiates thread-aware accept( Initiates thread-aware close( Initiates thread-aware connect( Initiates thread-aware fclose( Initiates thread-aware fflush( Initiates thread-aware fgetc( Initiates thread-awa
OSS System Calls Reference Manual socket accept: socket/ spt_acceptx: utime: Sets file information for a file acl: Sets acl: Introduction to OSS accessibility of a file access: Determines the /Excludes other users from disk/ /Excludes other users from acl: Sets access control list control lists (ACLs) (ACL) information for a file to OSS access control lists signal sigaction: Specifies the spt_sigaction: Specifies the existing file/ link: Creates an /Gets a network host entry by specified/ /Obtains the stack
Permuted Index pthread_getattr_np: Gets the object /Obtains the mutex type object /Sets the mutex type object /Obtains the detachstate object /Obtains the guardsize /Obtains the inherit scheduling object /of the scheduling policy /Obtains the scheduling policy object /Obtains the stacksize object /Sets the detachstate object /Sets the guardsize /Sets the inherit scheduling object /of the scheduling policy /Sets the scheduling policy object /Sets the stacksize /Obtains the stackbase address /Destroys a threa
OSS System Calls Reference Manual thread-aware REPLYX procedure the specified condition variable; /Registers a user-supplied timer descriptor to manage through a spt_FileIOHandler_p: Executes spt_TimerHandler_p: Executes spt_OSSFileIOHandler_p: Executes /fork-handler routines to be setgid: Sets the group ID of the setuid: Sets the user ID of the Gets the process group ID of the to the address space of the the scheduling priority of the pthread_exit: Terminates the the thread identifier of the cancelation re
Permuted Index permissions group IDs of a file root directory process in a Pathway server SPT_SERVERCLASS_DIALOG_END_: calling/ /(Macro) Removes the executed/ /(Macro) Establishes a /routine from the calling thread’s spt_close: Initiates thread-aware close: (thread-aware/ spt_closex: version) spt_fclosex: SPT_ FILE_CLOSE_: pipe: Creates an interprocess SPT_FILE_OPEN_: Establishes a socket: Creates an endpoint for pthread_equal: the terminal interface for POSIX gamma function/ gamma_r: gamma function/ lgamma
OSS System Calls Reference Manual dup2: Duplicates and spt_dup2x: Duplicates and ioctl: fcntl: (thread-aware/ spt_fcntlx: date and time string/ asctime_r: into a date and time/ ctime_r: broken-down/ gmtime_r: broken-down local/ localtime_r: since the Epoch to broken-down memory image cpio: Describes the extended archive file format the OSS environment or rewrites/ in the OSS environment or/ mkdir: pathname to a character/ mknod: fork: extensions tdm_fork: returns the ID of an/ semget: the process group ID s
Permuted Index Deletes a thread-specific null: Is a array and/ SPT_WRITEREADX: Writes /file from an array and waits for information from the user information from the user information from the user group information from the group group information from the group group information from the group the next entry in the network next entry in the network host entry from the network services Describes the terminal capability gettimeofday: Gets /Converts broken-down time into a /time since the Epoch into a /the o
OSS System Calls Reference Manual the/ /a send within the specified /sends the first message of the directories dir: Describes the format of mkdir: Creates a rename: Renames a file or rmdir: Removes a Changes the current working Changes the effective root file/ link: Creates an additional environment unlink: Removes a rename_oss: Renames a file or readdir_r: Reads a file/ SPT_UNLOCKFILE: Unlocks a users from accessing a Guardian accessing a record in a Guardian random processing of records in a of records i
Permuted Index gmtime_r: Converts time since the /Converts time since the condition value errno: Returns the pthread_cleanup_push: (Macro) between an/ SPT_FILE_OPEN_: thread’s signal/ pthread_sigmask: sigpending: and pending spt_sigpending: sigprocmask: Changes or accessing a/ SPT_LOCKFILE: accessing a record/ SPT_LOCKREC: functions that execute a file pathname, a set of argument/ pathname, a set of argument/ filename, a set of argument/ Specifies a set of functions that /Calls a routine to be /a cleanup-ha
OSS System Calls Reference Manual spt_fgets: Initiates thread-aware Initiates thread-aware null: Is a data sink /directory entry for an existing read: Reads from a spt_awaitio: Awaits a tagged I/O spthread.
Permuted Index spt_readvx: Reads from a the owner and group IDs of a ftruncate: Changes ftruncate64: Changes about a symbolic link or any Sets and gets the value of the Explains OSS file system spt_regFile: Registers the /Registers the manages /Unregisters a Guardian Registers the Pathsend operation lseek: Sets operation lseek64: Sets /operation on a Guardian character/ mknod: Creates a rename: Renames a function) rename_oss: Renames a a record in a Guardian disk processing of records in a disk about a symb
OSS System Calls Reference Manual the extended cpio archive file dir: Describes the the extended tar archive file parameters for/ spt_vfprintfx: parameters for/ spt_vprintfx: stream/ spt_fprintfx: Prints output/ spt_printfx: Prints Initiates thread-aware spt_fputc: Thread-aware spt_fputs: Initiates thread-aware spt_fputwc: Thread-aware to a specified stream /Initiates thread-aware spt_fread: Initiates thread-aware an open file about an open file information for an open file information for an open file file
Permuted Index Initiates thread-aware sendto( ) Initiates thread-aware system( ) thread-aware vfprintf( ) Initiates thread-aware vprintf( ) Initiates thread-aware waitpid( ) Initiates thread-aware write( ) Initiate thread-aware writev( ) to manage through a callback and variables used by signal Guardian file-system exec: Specifies a set of Initiates thread-aware /Computes the logarithm of the /Computes the logarithm of the of the gamma function/ tty: Is the pthread_key_create: controlling terminal/ ctermid_
OSS System Calls Reference Manual (thread-aware/ spt_getwx: gettimeofday: ulimit: Sets and open file fstatvfs: open file fstatvfs64: pathname statvfs: pathname statvfs64: group database/ getgrent_r: group database/ getgrgid_r: group database/ getgrnam_r: current system uname: pthread_getconcurrency: getlogin: getlogin_r: getsockopt: thread pthread_getattr_np: handle SPT_TMF_GetTxHandle: getegid: current process geteuid: current process getgroups: socket getsockname: (reentrant) ttyname_r: socket_transport_n
Permuted Index setgid: Sets the getsid: Gets the process new session and sets the process chown: Changes the owner and fchown: Changes the owner and lchown: Changes the owner and Sets the real and effective database/ getgrent_r: Gets database/ getgrgid_r: Gets database/ getgrnam_r: Gets getgroups: Gets the Sends a signal to a process or random processing of records in a other users from accessing a from accessing a record in a locks and reads records in a anticipation/ /Reads data from a SPT_ FILE_CLOSE_: C
OSS System Calls Reference Manual uname: Gets information Changes the owner and group Changes the owner and group Changes the owner and group Sets the real and effective group Sets the real and effective user Is a file containing a memory Is a file containing a memory and limits the backlog of SPT_CANCEL: Cancels the oldest long tag spt_generateTag: stat: Provides stat64: Provides or any file lstat: Provides or any file lstat64: Provides fstat: Provides fstat64: Provides server-class send/ /Returns Sets acc
Permuted Index function spt_putw: function spt_putwc: function spt_read: function spt_readv: function spt_recv: ) function spt_recvfrom: function spt_recvmsg: procedure call spt_REPLYX: function for/ spt_select: function/ spt_select_single_np: function spt_send: function spt_sendmsg: function spt_sendto: function spt_system: ) function spt_vfprintf: function spt_vprintf: function spt_waitpid: function spt_write: version) spt_freadx: Reads Interrupts all threads awaiting /Gets a character from a specified /G
OSS System Calls Reference Manual float: Specifies the system limits /for socket connections and directory entry for an existing/ information about a symbolic information about a symbolic Reads the value of a symbolic symlink: Creates a symbolic acl: Sets access control getgroups: Gets the group connections and limits the/ and limits the backlog/ listen: to OSS access control gethostname: Gets the name of the since the Epoch to broken-down getsockname: Gets the the Epoch to broken-down local/ not wait if th
Permuted Index message/ sendmsg: Sends a message/ spt_sendmsgx: Sends a msgrcv: Receives a message from a msgsnd: Sends a message to a or returns the identifier for a a message from a socket using a a message on a socket using a /a message from a socket using a /a message on a socket using a msgsnd: Sends a SPT_SERVERCLASS_SEND_: Sends a thread for a specified number of policy /Returns the a pathname to a character/ and gets the value of the file utime: Sets file access and to permanent/ fsync: Writes opera
OSS System Calls Reference Manual /Gets the next entry from the services/ getservent_r: Gets the database/ getnetent_r: Gets the database/ gethostent_r: Gets the getprotoent_r: Gets the priority of the calling process on a Guardian file opened for spt_regFile: Registers the file /Unregisters a Guardian file transactions being used /Gets the transactions /Sets the of the thread for a specified spt_vfprintfx: Formats a variable spt_vprintfx: Formats a variable /Gets a protocol entry by a network service entry
Permuted Index spt_fcntlx: Controls Provides information about an Provides information about an Gets fileset information for an Gets fileset information for an SPT_ FILE_CLOSE_: Closes an in the application program to an SPT_READX: Returns data from an or writing; creates a regular/ operation on a Guardian file writing; creates a regular/ open: writing; creates a/ open64: file offset for read or write file offset for read or write /Cancels the oldest incomplete about the last server-class send Initiates a t
OSS System Calls Reference Manual policy/ /Sets the scheduling getppid: Gets the /Establishes a communication Explains OSS file system execl: Executes a file using a execle: Executes a file using a execv: Executes a file using a execve: Executes a file using a system path naming ctermid_r: Generates the Gets fileset information using a Gets fileset information using a file /Creates a file or assigns a /Registers the /Registers the user-supplied /Unregisters the user-supplied reply from a server process in a
Permuted Index effective user ID of the current the group list of the current process group ID of the calling group ID for a specified OSS name of the transport-provider the real user ID of the current setpgrp: Sets the OSS process getpgid: Gets the setpgid: Sets the process getpgrp: Gets the leader getsid: Gets the a new session and sets the getpid: Gets the OSS getppid: Gets the parent OSS /receives a reply from a server kill: Sends a signal to a getpriority: Gets the OSS Sets the group ID of the calling
OSS System Calls Reference Manual Initializes a condition variable/ all threads that are waiting on/ condition variable condition variable least one thread that is waiting/ Unblocks one thread that is/ thread to wait either for a/ thread to wait for the specified/ execution of a thread object for deletion thread identifiers calling thread attribute object for a thread level of concurrency Calculates an absolute/ the current scheduling policy/ thread-specific data associated/ thread to wait for the/ unique t
Permuted Index or process file/ SPT_READUPDATEX: read: buffers readv: buffers/ spt_readvx: version) spt_readx: (thread-aware/ spt_freadx: file /Sequentially locks and link readlink: spt_readv: Initiates thread-aware scattered buffers setregid: Sets the setreuid: Sets the getgid: Gets the process getuid: Gets the the spt_INITRECEIVE: Registers thread-aware function for reading Shuts down socket send and a thread until a signal is connected socket recv: connected socket/ spt_recvx: queue msgrcv: recvfrom: usi
OSS System Calls Reference Manual Epoch into a date and time string Epoch to broken-down local time the name for a temporary file Gets the name of a terminal callback/ spt_regTimerHandler: spt_INITRECEIVE: manage/ spt_regOSSFileIOHandler: spt_regFile: spt_regFileIOHandler: number spt_regPathsendFile: spt_regPathsendTagHandler: environment or/ creat: Creates a environment/ creat64: Creates a for reading or writing; creates a for reading or writing; creates a rmdir: the OSS environment unlink: pthread_cleanup
Permuted Index attributes/ /Obtains the inherit attributes/ /Sets the inherit /the current scheduling policy and /Sets the scheduling policy and scheduling policy/ /Obtains the scheduling policy/ /Sets the parameters/ /Obtains the current pthread_setschedparam: Sets the /the scheduling parameters of the thread attributes/ /Obtains the /the scheduling parameters of the thread attributes/ /Sets the the maximum priority for a the minimum priority for a getpriority: Gets the OSS process calling/ nice: Changes t
OSS System Calls Reference Manual group ID setsid: Creates a new Gets the process group ID of the semget: Creates a new semaphore /a file using a pathname, a /a file using a filename, a /a file using a pathname, a for a/ sigsuspend: Changes the for/ spt_sigsuspend: Changes the file exec: Specifies a the ID of an existing semaphore calling process ID for job control ID effective group IDs effective user IDs information for a file acl: ulimit: file mode creation mask umask: file-system/ SPT_SETMODE: times uti
Permuted Index spt_alarm: Schedules an alarm definitions and variables used by spt_signal: Installs a new Suspends a thread until a or changes the calling thread’s Changes or examines the action to take upon delivery of a the calling thread to wait for a /action to take upon delivery of a processes kill: Sends a pthread_kill: Sends a /for a condition variable to be condition variable to be sigpending: Examines pending the processor to/ sched_yield: /Changes the set of blocked /Changes the set of blocked pen
OSS System Calls Reference Manual /Initiates a send within the /Gets a character from a /Gets a wide character from a a /Gets a character from a /Gets a wide character from a if the mutex/ /Attempts to lock a /execution of the thread for a Gets the process group ID for a spt_fputcx: Writes a byte to a spt_putcx: Writes a byte to a Writes a wide character to a /Writes a wide character to a /Writes a wide character to a object /address attribute of the execution of the thread for a execute a file exec: delive
Permuted Index returns a static long tag getc( ) function thread-aware getchar( ) function from the standard input stream/ a specified input stream/ gets( ) function standard input stream/ Gets the number of concurrent/ getw( ) function getwc( ) function thread-aware getwchar( )/ character from the standard/ from a specified input stream/ input stream (thread-aware/ file $RECEIVE filename threads awaiting input or output thread awaiting tagged I/O users from accessing a Guardian/ from accessing a record in
OSS System Calls Reference Manual thread-aware sendmsg( ) function a socket using a message/ thread-aware sendto( ) function socket (thread-aware version) connected socket (thread-aware/ Aborts the specified dialog Initiates the dialog and also/ Cleans up resources for the/ Initiates a send within the/ message to and receives a reply/ Returns information about the/ device-dependent Guardian/ interest in file descriptor Sets the number of concurrent/ action to take upon delivery of/ handler that are blocked
Permuted Index a wide character to a specified readdir_r: Reads a directory character to the standard output /output to the standard output spt_fclosex: Closes a spt_fflushx: Flushes a spt_fgetsx: Gets a string from a /from a a specified input /formatted output to an output /a byte to a specified output spt_fputsx: Writes a string to a /a wide character to a specified spt_freadx: Reads input from a spt_fwritex: Writes to an output /a string from the standard input /character from the standard input /charact
OSS System Calls Reference Manual tar: Describes the extended archive file format HP extensions HP extensions with HP extensions with HP extensions process with HP extensions /Constructs the name for a capability database termcap: Describes the tty: Is the general termios: Describes the ttyname_r: Gets the name of a the pathname for the controlling /Requests that a thread Waits for any child process to specific child process to stop or _exit: to be executed when the thread pthread_exit: calling thread to wa
Permuted Index pthread_cond_timedwait: Causes a spt_sigwait: Causes the calling pthread_join: Causes the calling pthread_cond_wait: Causes a received.
OSS System Calls Reference Manual from the standard input stream to the standard output stream character to a specified stream character to a specified stream a new connection on a socket to take upon delivery of a signal signal for delivery to a process controls an open file descriptor from a specified input stream from a a specified input stream from the standard input stream from a specified input stream from the standard input stream from a specified input stream output to an output stream socket using
Permuted Index attributes/ /Obtains the mutex attributes object /Sets the mutex /Executes callback /Executes callback /Executes callback calling thread’s cancelability limits the file mode creation mask identifying the current system waiting/ pthread_cond_broadcast: is waiting/ pthread_cond_signal: pthread_cond_signal_int_np: a set of argument strings, and an pthread_key_create: Generates a Epoch to broken-down Coordinated from the OSS environment pthread_mutex_lock: Locks an records in that/ SPT_UNLOCKFILE
OSS System Calls Reference Manual output/ spt_vfprintfx: Formats a output/ spt_vprintfx: Formats a Destroys a condition Initializes a condition on the specified condition on the specified condition /to wait either for a condition wait for the specified condition signal: Contains definitions and output stream (thread-aware output stream (thread-aware output stream (thread-aware on a socket (thread-aware a specified stream (thread-aware a specified stream (thread-aware file descriptor (thread-aware file descr
Permuted Index process to stop or/ waitpid: terminate wait: /a Guardian file from an array and descriptor spt_fd_read_ready: descriptor spt_fd_write_ready: I/O spt_wakeup: sockatmark: Determines input stream/ spt_fgetwcx: Gets a input stream/ spt_getwcx: Gets a input/ spt_getwcharx: Gets a stream fputwc: Writes a stream/ spt_fputwcx: Writes a stream/ spt_putwcx: Writes a output/ spt_putwcharx: Writes a processor/ sched_yield: Signals a the server/ /Initiates a send (thread-aware/ spt_getwx: Gets a version)
Index _____________________________ Symbols B /etc/named.
OSS System Calls Reference Manual file, 8-72 control operations on a device file, 3-131 on a file, 1-55, 1-57, 3-10, 7-109, 7-115 on a message queue, 4-58 on semaphores, 7-11 on shared memory, 7-54 controlling terminal, generating pathname for, 1-52 core file, 11-3 core memory image, 11-3 cpio archive file, 11-4 to 11-6 cpio file format, 11-4 to 11-6 creat function, 1-38 to 1-44 creat64 function, 1-45 to 1-51 ctermid_r function, 1-52 to 1-53 ctime_r function, 1-54 current working directory, changing, 1-17
Index DCE_PRIVUSER, 12-17 DCE_PROCESS_PREFIX, 12-17 DCE_SCP_PROCESS_NAME, 12-17 DCE_SOCKET_REUSE, 12-18 DIR_REPLICATE, 12-18 DISPLAY_THRESHOLD, 12-19 DO_CHECKS, 12-19 DTS_CONFIG, 12-19 ECOBFE, 12-19 EDITOR, 12-19 ELD, 12-19 EMS_COLLECTOR, 12-19 ENV, 12-20 EXINIT, 12-20 EXIT_ON_ERROR, 12-20 FCEDIT, 12-20 FPATH, 12-20 Guardian PARAMs, 12-20 HISTFILE, 12-20 HISTSIZE, 12-20 HOME, 12-20 HOST_NAME_IP, 12-20 IFS, 12-20, 12-31 JAVA_HOME, 12-20 KEYSEED, 12-20 LANG, 12-20 LAN_NAME, 12-21 LC_ALL, 12-21 LC_COLLATE, 12-
OSS System Calls Reference Manual TOLERANCE_SEC, 12-28 TOTAL_CLERKS, 12-28 TZ, 12-28 UGEN, 12-29 UNCONFIG_HOST_PRESET, 12-29 UOPT, 12-29 UPDATE_ALL_CLONES, 12-29 UPDATE_DEFAULT_LIBDCESO, 12-30 USER, 12-30 USE_DEF_MSG_PATH, 12-30 UTILSGE, 12-30 VISUAL, 12-30 ZCPU, 12-30 _RLD_FIRST_LIB_PATH, 12-25 _RLD_LIB_PATH, 12-25 errno external variable, 12-32 to 12-39 errno value [E2BIG], 2-8, 2-16, 2-24, 2-32, 2-40, 2-48, 4-66, 7-21, 8-13, 8-27, 8-53, 8-69, 12-32 [EACCES], 1-6, 1-11, 1-14, 1-18, 1-22, 1-26, 1-30, 1-35,
Index 7-343, 7-366, 7-379, 8-53, 8-70, 8-73, 10-15, 10-20, 12-32 [EBADMSG], 12-32 [EBADSYS], 12-32 [EBIGDIR], 12-33 [EBUSY], 6-31, 6-36, 9-8, 12-33 [ECHILD], 10-6, 10-11, 12-33 [ECONNABORTED], 1-3, 7-91, 12-33 [ECONNREFUSED], 1-35, 7-105, 12-33 [ECONNRESET], 1-3, 1-15, 1-35, 3-14, 3-89, 3-119, 3-124, 4-20, 6-5, 6-14, 6-17, 6-20, 6-24, 7-24, 7-27, 7-31, 7-48, 7-64, 7-75, 7-91, 7-105, 7-119, 7-254, 7-265, 7-272, 7-277, 7-280, 7-298, 7-304, 7-307, 7-366, 7-379, 10-15, 10-20, 12-33 [ECWDTOOLONG], 12-33 [EDEADLK
OSS System Calls Reference Manual [EHOSTDOWN], 12-34 [EHOSTUNREACH], 1-36, 7-31, 7-105, 7-304, 12-34 [EIDRM], 4-66, 4-68, 7-21, 12-34 [EILSEQ], 7-159, 7-172, 7-218, 7-235, 7-237, 7-339, 7-343, 12-34 [EINPROGRESS], 1-36, 7-105, 12-34 [EINTR], 1-3, 1-6, 1-36, 1-42, 1-49, 3-4, 3-7, 3-14, 3-46, 3-54, 3-56, 3-58, 3-61, 3-133, 4-66, 4-68, 5-10, 5-21, 6-5, 6-14, 6-17, 6-20, 6-24, 7-9, 7-21, 7-24, 7-28, 7-32, 7-73, 7-91, 7-105, 7-114, 7-119, 7-126, 7-128, 7-132, 7-134, 7-159, 7-165, 7-169, 7-172, 7-175, 7-178, 7-18
Index [EISGUARDIAN], 1-32, 1-56, 1-58, 3-15, 3-29, 3-38, 3-47, 3-55, 3-56, 3-59, 3-61, 4-25, 4-28, 6-5, 6-14, 7-101, 7-110, 7-120, 7-255, 7-266, 7-367, 7-379, 8-73, 10-16, 10-21, 12-35 [ELOOP], 1-6, 1-15, 1-18, 1-22, 1-27, 1-30, 1-36, 1-42, 1-49, 2-8, 2-17, 2-25, 2-32, 2-41, 2-49, 4-8, 4-12, 4-17, 4-36, 4-46, 4-51, 4-56, 5-11, 5-21, 6-10, 6-32, 6-37, 7-28, 7-32, 7-105, 7-299, 7-304, 7-389, 7-400, 7-411, 7-420, 7-425, 8-14, 8-28, 8-54, 8-70, 9-8, 9-12, 12-35 [EMFILE], 1-3, 1-42, 1-49, 1-56, 2-8, 2-17, 2-25,
OSS System Calls Reference Manual 7-420, 7-425, 8-15, 8-29, 8-54, 8-71, 9-9, 9-13, 12-36 [ENOERR], 12-36 [ENOEXEC], 2-9, 2-17, 2-25, 2-33, 2-41, 2-49, 8-15, 8-29, 8-54, 8-71, 12-36 [ENOIMEM], 12-36 [ENOLCK], 3-15, 7-120, 12-36 [ENOMEM], 1-3, 1-16, 1-37, 1-43, 1-50, 1-52, 2-9, 2-17, 2-25, 2-33, 2-41, 2-49, 3-20, 3-90, 3-104, 3-106, 3-109, 3-119, 3-124, 4-21, 5-12, 5-22, 5-26, 6-8, 6-17, 6-20, 6-24, 6-33, 7-24, 7-29, 7-32, 7-49, 7-53, 7-62, 7-65, 7-75, 7-80, 7-83, 7-92, 7-106, 7-129, 7-132, 7-159, 7-165, 7-16
Index [ENOTSOCK], 1-3, 1-16, 1-37, 3-90, 3-119, 3-124, 4-21, 6-17, 6-21, 6-24, 7-24, 7-29, 7-32, 7-49, 7-65, 7-92, 7-106, 7-273, 7-278, 7-281, 7-299, 7-305, 7-308, 12-37 [ENOTSUP], 1-7, 1-11, 1-27, 1-43, 1-50, 3-134, 4-37, 4-47, 5-12, 5-22, 7-9, 7-390, 7-401, 7-426, 9-9, 9-13, 12-37 [ENOTTY], 3-134, 7-75, 8-73, 12-37 [ENXIO], 1-7, 1-19, 1-23, 1-27, 1-31, 1-43, 1-50, 3-29, 3-38, 3-57, 3-134, 4-8, 4-13, 4-18, 4-37, 4-47, 4-52, 4-57, 5-12, 5-22, 6-8, 6-10, 6-33, 6-37, 7-114, 7-129, 7-132, 7-159, 7-165, 7-169,
OSS System Calls Reference Manual [ESHUTDOWN], 12-38 [ESOCKTNOSUPPORT], 12-38 [ESPIERR], 12-38 [ESPIPE], 4-25, 4-28, 12-38 [ESRCH], 3-91, 3-96, 3-117, 4-4, 7-36, 12-38 [ETANOTRUNNING], 7-80, 7-83, 12-38 [ETHNOTRUNNING], 7-9, 12-38 [ETIMEDOUT], 1-37, 6-6, 6-15, 6-17, 6-21, 6-24, 7-106, 7-255, 7-266, 7-273, 7-278, 7-281, 7-367, 7-380, 10-16, 10-22, 12-38 [ETXTBSY], 1-7, 1-44, 1-51, 2-9, 2-17, 2-25, 2-33, 2-41, 2-49, 5-13, 5-23, 6-33, 8-15, 8-29, 8-54, 8-71, 9-9, 9-13, 12-38 [EUNKNOWN], 2-9, 2-17, 2-25, 2-33,
Index sets for checking I/O status, 7-5 file format archive library, 11-2 cpio, 11-4 tar, 11-43 file mode creation mask, setting and getting, 9-4 file status flags and dup function, 1-55 and dup2 function, 1-57 and spt_dup2x function, 7-109 O_APPEND, 5-7, 5-17 O_CREAT, 5-5, 5-16 O_EXCL, 5-6, 5-16 O_NOCTTY, 5-6, 5-16 O_NONBLOCK, 5-7, 5-17, 5-25 O_SYNC, 5-7, 5-17 O_TRUNC, 5-6, 5-16 file system hierarchy, 12-47 renaming files and directories, 6-27, 6-29 file type flags S_IFCHR, 3-23, 3-32, 4-31, 4-40, 7-384, 7
OSS System Calls Reference Manual executing, 2-2, 2-3, 2-11, 2-19, 2-27, 2-35, 2-43, 8-2, 8-16, 8-40, 8-56, 12-50 floating-point specifications, 11-8 group ID, 1-25, 3-6, 4-10 limits specifications, 11-10 locks, 3-10, 7-115 modification time, 9-11 modifications, saving, 3-56 name for temporary, 8-72 names for, 12-40 null, 11-26 open, 8-38 opening for reading or writing, 1-38, 1-45, 5-4, 5-14 owner ID, 1-25, 3-6, 4-10 pathnames for, 12-40 permission, changing, 1-20, 3-2, 4-5 process snapshot, 11-3 propagatin
Index gethostent_r function, 3-78 to 3-79 gethostname function, 3-80 getlogin function, 3-81 getlogin_r function, 3-82 getnetbyaddr_r function, 3-83 to 3-84 getnetbyname_r function, 3-85 to 3-86 getnetent_r function, 3-87 to 3-88 getpeername function, 3-89 to 3-90 getpgid function, 3-91 getpgrp function, 3-92 getpid function, 3-93 getppid function, 3-94 getpriority function, 3-95 to 3-96 getprotobyname_r function, 3-97 to 3-98 getprotobynumber_r function, 3-99 to 3-100 getprotoent_r function, 3-101 to 3-102
OSS System Calls Reference Manual rename function, 6-27, 6-30 rename_oss function, 6-27, 6-30 rmdir function, 6-36 select function, 7-7 semaphores, 7-17 semctl function, 7-13 semget function, 7-17 semop function, 7-21 setpgid function, 7-35 setpgrp function, 7-37 setsid function, 7-42 shared memory, 7-61 shmat function, 7-52 shmctl function, 7-55 shmdt function, 7-57 shmget function, 7-62 sigaction function, 7-66 sigpending function, 7-70 sigprocmask function, 7-72 sigsuspend function, 7-73 socket function,
Index I I/O status, checking file descriptor sets for, 7-5 implementation-dependent constants, 11-10 input stream getting character from, 7-128, 7-134, 7-183, 7-185, 7-194, 7-196 getting word from, 7-134, 7-194, 7-196, 7-198 interface for terminals, 11-59, 11-65 IO functions, standard, 7-161, 7-164, 7-168, 7-171, 7-222, 7-225, 7-229, 7-234, 7-236 ioctl function, 3-131 to 3-134 K kill function, 4-2 to 4-4 L lchmod function, 4-5 to 4-9 lchown function, 4-10 to 4-13 lgamma_r function, 4-14 to 4-15 limits he
OSS System Calls Reference Manual removing, 4-58 returning the identifier for, 4-61 sending a message to, 4-67 uniqueness of identifiers, 4-62 use between environments, 4-59, 4-62, 4-65, 4-68 messages receiving from a message queue, 4-64 receiving from connected sockets, 6-16, 7-279 receiving from unconnected sockets, 6-19, 7-271 receiving using a message structure, 6-22, 7-275 sending to a message queue, 4-67 sending to connected sockets, 7-23, 7-306 sending to unconnected sockets, 7-30, 7-302 sending usin
Index P parameters, formatting for output, 7-338, 7-342 parent OSS process ID, returning, 3-94 pathname, 12-40 to 12-46 peer address, returning for a socket, 3-89 peer name, returning for a socket, 3-89 permission, changing for a file, 1-20, 3-2, 4-5 pipe function, 5-25 to 5-26 pipes creating, 5-25 propagating open, 8-4, 8-19, 8-38, 8-43, 8-59 POSIX-defined minimum values, 11-13 printing output, 7-154, 7-213 process attaching shared memory segment, 7-51 changing scheduling priority, 5-2 changing signal mas
OSS System Calls Reference Manual Guardian, 2-6, 2-14, 2-22, 2-30, 2-38, 2-46, 3-18 OSS, 2-5, 2-14, 2-22, 2-29, 2-38, 2-46, 3-17, 8-6, 8-20, 8-31, 8-45, 8-61 setting Guardian, 8-8, 8-22, 8-33, 8-47, 8-64 process deletion message, Guardian, 4-3 process group getting scheduling priority, 3-95 specifying, 8-44, 8-61 process ID, OSS, returning, 3-93, 3-94 process image identifying file, 2-3, 2-11, 2-19, 2-27, 2-35, 2-43, 8-3, 8-17, 8-42, 8-58 replacing current, 2-2, 2-3, 2-11, 2-19, 2-27, 2-35, 2-43, 8-2, 8-16,
Index pthread_getschedparam function, 5-76 pthread_getspecific function, 5-78 pthread_get_expiration_np function, 5-73 pthread_join function, 5-79 pthread_key_create function, 5-81 pthread_key_delete function, 5-83 pthread_kill function, 5-84 pthread_lock_global_np function, 5-86 pthread_mutexattr_destroy function, 5-93 pthread_mutexattr_getkind_np function, 5-94 pthread_mutexattr_init function, 5-95 pthread_mutexattr_setkind_np function, 5-97 pthread_mutex_destroy function, 5-87 pthread_mutex_init function
OSS System Calls Reference Manual sched_yield function, 7-4 select function, 7-5 to 7-10 semaphore sets creating new ID, 7-16 obtaining key for, 7-17 performing control operations on, 7-11 performing operations on, 7-19 propagating to child process, 7-17, 8-38, 8-44, 8-60 propagating to new process, 2-5, 2-13, 2-21, 2-29, 2-37, 2-45, 8-5, 8-19 returning ID, 7-16 semaphores performing control operations on, 7-11 performing operations on, 7-19 semctl function, 7-11 to 7-15 semget function, 7-16 to 7-18 semop
Index NLSPATH, 12-23 PATH, 12-23 PRINTER, 12-23 PS1, 12-24, 12-31 PS2, 12-24, 12-31 PS3, 12-24 PS4, 12-24 SHELL, 12-25 SWAPVOL, 12-26 TERM, 12-27 TERMCAP, 12-27 TERMINFO, 12-27 TERMPATH, 12-27 TMOUT, 12-28 TMPDIR, 12-28 TZ, 12-28 USER, 12-30 UTILSGE, 12-30 VISUAL, 12-30 ZCPU, 12-30 shmat function, 7-51 to 7-53 shmctl function, 7-54 to 7-56 shmdt function, 7-57 to 7-58 shmget function, 7-59 to 7-63 shutdown function, 7-64 to 7-65 sigaction function, 7-66 to 7-69 signal action, 7-66 to 7-69, 7-314 to 7-315 si
OSS System Calls Reference Manual returning options for, 3-120 returning peer address, 3-89 returning peer name, 3-89 returning transport-provider process name, 7-85 send and receive operations, 7-64 sending messages to connected, 7-23, 7-306 sending messages to unconnected, 7-30, 7-302 sending messages using a message structure, 7-26, 7-296 setting options, 7-43 setting transport-provider process name, 7-87 socket function, 7-77 to 7-80 socket pair, creating, 7-81 socketpair function, 7-81 to 7-84 socket_t
Index spt_interrupt function, 7-201 spt_interruptTag function, 7-202 SPT_LOCKFILE function, 7-203 to 7-205 SPT_LOCKREC function, 7-206 to 7-209 spt_OSSFileIOHandler_p function, 7-210 spt_pause function, 7-211 spt_printf function, 7-212 spt_printfx function, 7-213 to 7-219 spt_putc function, 7-220 spt_putchar function, 7-221 spt_putcharx function, 7-222 to 7-224 spt_putcx function, 7-225 to 7-227 spt_puts function, 7-228 spt_putsx function, 7-229 to 7-230 spt_putw function, 7-231 spt_putwc function, 7-232 sp
OSS System Calls Reference Manual spt_TimerHandler_p function, 7-324 SPT_TMF_GetTxHandle function, 7-325 SPT_TMF_Init function, 7-326 SPT_TMF_SetTxHandle function, 7-327 SPT_UNLOCKFILE function, 7-328 to 7-329 SPT_UNLOCKREC function, 7-330 to 7-332 spt_unregFile function, 7-333 spt_unregOSSFileIOHandler function, 7-334 spt_unregPathsendTagHandler function, 7-335 spt_usleep function, 7-336 spt_vfprintf function, 7-337 spt_vfprintfx function, 7-338 to 7-340 spt_vprintf function, 7-341 spt_vprintfx function, 7
Index getservbyport_r function, 3-113 getservent_r function, 3-115 gmtime_r function, 3-129 initializing a condition variable, 5-55, 5-64 initializing a thread attributes object, 5-37 lgamma_r function, 4-14 localtime_r fundtion, 4-22 locking a mutex, 5-90 locking a mutex without waiting, 5-91 obtaining the guardsize attribute, 5-31 obtaining the mutex attribute type, 5-94 obtaining the thread identifier, 5-100 Pathsend file use, 7-285 Pathsend tags, 7-286, 7-335 rand_r function, 6-2 readdir_r function, 6-7
OSS System Calls Reference Manual SPT_UNLOCKREC function, 7-330 spt_vfprintfx function, 7-338 spt_vprintfx function, 7-342 spt_waitpid function, 7-344 SPT_WRITEREADX function, 7-348 SPT_WRITEUPDATEUNLOCKX function, 7-352 SPT_WRITEUPDATEX function, 7-356 spt_writevx function, 7-363 spt_writex function, 7-376 SPT_WRITEX function, 7-369 strtok_r function, 7-421 suspension, 7-322, 7-336 thread attributes object, 5-35 thread-aware fork, 7-152 TMF use, 7-190, 7-313, 7-325, 7-326, 7-327 tmpnam_r function, 8-72 unb
Index ARG_MAX, 11-14 BC_BASE_MAX, 11-10 BC_DIM_MAX, 11-10 BC_SCALE_MAX, 11-10 BC_STRING_MAX, 11-10 BRKINT, 11-59 CHARCLASS_NAME_MAX, 11-11 CHAR_BIT, 11-11 CHAR_MAX, 11-11 CHAR_MIN, 11-11 CHILD_MAX, 11-14 CLOCAL, 11-60 COLL_WEIGHTS_MAX, 11-11 CREAD, 11-60 CS5, 11-61 CS6, 11-61 CS7, 11-61 CS8, 11-61 CSIZE, 11-60 CSTOPB, 11-61 DBL_EPSILON, 11-8 DBL_MANT_DIG, 11-8 DBL_MAX, 11-8 DBL_MAX_10_EXP, 11-8 DBL_MAX_EXP, 11-8 DBL_MIN, 11-8 DBL_MIN_10_EXP, 11-8 DBL_MIN_EXP, 11-8 ECHO, 11-61 ECHOE, 11-61 ECHOK, 11-61 ECHON
OSS System Calls Reference Manual IPC_STAT, 4-59, 7-11, 7-13, 7-54 IPPROTO_IP, 3-120, 7-43 IPPROTO_IPV6, 3-120, 7-43 IPPROTO_TCP, 3-120, 7-43 IPV6_JOIN_GROUP, 7-43 IPV6_LEAVE_GROUP, 7-44 IPV6_MULTICAST_HOPS, 3-120, 7-44 IPV6_MULTICAST_IF, 3-120, 7-44 IPV6_MULTICAST_LOOP, 3-121, 7-44 IPV6_UNICAST_HOPS, 3-121, 7-44 IPV6_V6ONLY, 3-121, 7-44 IP_ADD_MEMBERSHIP, 7-44 IP_DROP_MEMBERSHIP, 7-44 IP_MULTICAST_IF, 3-121, 7-44 IP_MULTICAST_LOOP, 3-121, 7-45 IP_MULTICAST_TTL, 3-121, 7-45 IP_OPTIONS, 3-121, 7-44 ISIG, 11-
Index PARMRK, 11-60 PARODD, 11-61 PATH_MAX, 11-12 PIPE_BUF, 7-364, 7-377, 10-14, 10-19, 11-12 PRIO_PGRP, 3-95 PRIO_PROCESS, 3-95 PRIO_USER, 3-95 RE_DUP_MAX, 11-12 SA_NOCLDSTOP, 7-68, 11-28 SCHAR_MAX, 11-12 SCHAR_MIN, 11-12 SEEK_CUR, 4-24, 4-27 SEEK_END, 4-24, 4-27 SEEK_SET, 4-24, 4-27 SEM_UNDO, 7-20 SETALL, 7-13 SETVAL, 7-12 SHM_RDONLY, 7-51 SHM_RND, 7-51 SHRT_MAX, 11-12 SHRT_MIN, 11-12 SHUT_RD, 7-64 SHUT_RDWR, 7-64 SHUT_WR, 7-64 SIG_ABORT, 11-28 SIG_BLOCK, 7-71, 11-28 SIG_DEBUG, 11-28 SIG_DFL, 11-28 SIG_ER
OSS System Calls Reference Manual S_IFIFO, 3-23, 3-33, 4-31, 4-40, 4-53, 7-384, 7-394 S_IFMT, 3-23, 3-32, 4-31, 4-40, 7-384, 7-394 S_IFREG, 1-40, 1-47, 3-23, 3-33, 4-31, 4-40, 4-53, 5-8, 5-18, 7-384, 7-394 S_IFSOCK, 3-24, 3-33, 4-31, 4-40, 7-384, 7-394 S_IRGRP, 1-21, 3-3, 4-6, 4-53, 7-59 S_IROTH, 1-21, 3-3, 4-6, 4-53, 7-59 S_IRUSR, 1-21, 3-3, 4-6, 4-53, 7-59 S_IRWXG, 1-21, 3-3, 3-24, 3-33, 4-6, 4-31, 4-41, 4-53, 7-59, 7-384, 7-394 S_IRWXO, 1-21, 3-3, 3-24, 3-33, 4-6, 4-31, 4-41, 4-53, 7-59, 7-384, 7-394 S_I
Index _POSIX_ARG_MAX, 11-13 _POSIX_CHILD_MAX, 11-13 _POSIX_FD_SETSIZE, 11-13 _POSIX_HIWAT, 11-13 _POSIX_LINK_MAX, 11-13 _POSIX_MAX_CANON, 11-13 _POSIX_MAX_INPUT, 11-13 _POSIX_NAME_MAX, 11-13 _POSIX_NGROUPS_MAX, 11-13 _POSIX_OPEN_MAX, 11-13 _POSIX_PATH_MAX, 11-13 _POSIX_PIPE_BUF, 11-13 _POSIX_QLIMIT, 11-13 _POSIX_SSIZE_MAX, 11-13 _POSIX_STREAM_MAX, 11-14 _POSIX_TZNAME_MAX, 11-14 _TPC_BAD_ARGV, 12-51 _TPC_BAD_CPU, 12-54 _TPC_BAD_CREATE_OPTIONS, 12-54 _TPC_BAD_DEBUG_OPTIONS, 12-54 _TPC_BAD_DEFINES, 12-51, 12-5
OSS System Calls Reference Manual _TPC_ENABLE_DEFINES, 8-11, 8-24, 8-35, 8-49, 8-66 _TPC_ENTER_DEBUG, 8-12, 8-26, 8-36, 8-51, 8-67 _TPC_GENERATE_NAME, 8-10, 8-24, 8-35, 8-49, 8-65 _TPC_HIGHPIN_OFF, 8-11, 8-25, 8-35, 8-50, 8-66 _TPC_IGNORE_FORCEPIN_ATTR, 8-11, 8-25, 8-36, 8-50, 8-66 _TPC_INSPECT_NOSAVE, 8-12, 8-26, 8-36, 8-51, 8-67 _TPC_INSPECT_SAVEABEND, 8-12, 8-26, 8-37, 8-51, 8-67 _TPC_NAME_SUPPLIED, 8-10, 8-24, 8-35, 8-49, 8-65 _TPC_NO_NAME, 8-10, 8-24, 8-35, 8-49, 8-65 _TPC_OVERRIDE_DEFMODE, 8-11, 8-25,
Index defined, 3-103, 3-105, 3-108 manipulating entry in, 3-103, 3-105, 3-108 user environment variables, 12-15 to 12-31 user ID returning effective, 3-65 returning real, 3-128 setting real and effective, 7-40, 7-50 user password, 3-103, 3-105, 3-108 utime function, 9-11 to 9-13 V virtual addresses, specifying for shared memory, 7-51, 7-57 virtual memory, and shared memory segments, 7-51, 7-57 W wait function, 10-2 to 10-6 waitpid function, 10-7 to 10-12 word getting from input stream, 7-134, 7-194, 7-196
