[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 1

fuword Kernel Service

Purpose

Retrieves a word of data from user memory.

Syntax

#include <sys/types.h>
#include <sys/errno.h>
int fuword (uaddr)
int *uaddr;

Parameter

uaddr Specifies the address of user data.

Description

The fuword kernel service retrieves a word of data from the specified address in user memory. It is provided so that system calls and device heads can safely access user data. The fuword service ensures that the user had the appropriate authority to:

The fuword service should be called only while executing in kernel mode in the user process.

Execution Environment

The fuword kernel service can be called from the process environment only.

Return Values

When successful, the fuword service returns the specified word of data.

-1 Indicates a uaddr parameter that is not valid.

The access is not valid under the following circumstances:

For the fuword service, a retrieved value of -1 and a return code of -1 are indistinguishable.

Implementation Specifics

The fuword kernel service is part of Base Operating System (BOS) Runtime.

Related Information

The fubyte kernel service, subyte kernel service, suword kernel service.

Accessing User-Mode Data while in Kernel Mode and Memory Kernel Services in AIX Version 4.3 Kernel Extensions and Device Support Programming Concepts.


[ Previous | Next | Contents | Home | Search ]