[ Previous |
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 1
uprintf Kernel Service
Submits a request to print a message to the controlling terminal of a process.
int uprintf (Format [,Value, ...])
|| Specifies a character string containing either or both of two types of objects:
- Plain characters, which are copied to the message output stream.
- Conversion specifications, each of which causes 0 or more items to be retrieved from the Value parameter list. Each conversion specification consists of a % (percent sign) followed by a character that indicates the type of conversion to be applied:
Field width or precision conversion specifications are not supported.
|| Performs no conversion. Prints %.|
|| Accepts an integer Value and converts it to signed decimal notation.|
|| Accepts an integer Value and converts it to unsigned decimal notation.|
|| Accepts an integer Value and converts it to unsigned octal notation.|
|| Accepts an integer Value and converts it to unsigned hexadecimal notation.|
|| Accepts a Value as a string (character pointer), and characters from the string are printed until a \ 0 (null character) is encountered. Value must be non-null and the maximum length of the string is limited to UP_MAXSTR characters.|
The following constants are defined in the /usr/include/sys/uprintf.h file:
The Format string may contain from 0 to the number of conversion specifications specified by the UP_MAXARGS constant. The maximum length of the Format string is the number of characters specified by the UP_MAXSTR constant. Format must be non-null.
The maximum length of the constructed kernel message is limited to the number of characters specified by the UP_MAXMSG constant. Messages larger then the number of characters specified by the UP_MAXMSG constant are discarded.
|| Specifies, as an array, the value to be converted. The number, type, and order of items in the Value parameter list should match the conversion specifications within the Format string. |
The uprintf kernel service submits a kernel message request. Once the request has been successfully submitted, the uprintfd daemon constructs the message based on the Format and Value parameters of the request. The uprintfd daemon then writes the message to the process' controlling terminal.
The uprintf kernel service can be called from the process environment only.
|| Indicates a successful operation.|
|| Indicates that memory is not available to buffer the request.|
|| Indicates that a controlling terminal does not exist for the process.|
|| Indicates that the uprintfd daemon is not active. No requests may be submitted.|
|| Indicates that a string Value string pointer is null or the string Value parameter is greater than the number of characters specified by the UP_MAXSTR constant.|
|| Indicates one of the following:
- Format string pointer is null.
- Number of characters in the Format string is greater than the number specified by the UP_MAXSTR constant.
- Number of conversion specifications contained within the Format string is greater than the number specified by the UP_MAXARGS constant.
The uprintf kernel service is part of the Base Operating System (BOS) Runtime.
The NLuprintf kernel service.
The uprintfd daemon.
Process and Exception Management Kernel Services in AIX Kernel Extensions and Device Support Programming Concepts.
[ Previous |