fubyte(9r) [osf1 man page]

fubyte(9r)																fubyte(9r)

NAME

       fubyte - General: Returns a byte from user address space

SYNOPSIS

       int fubyte(
	       char *user_src );

ARGUMENTS

       Specifies the address in user space from which to read the byte.

DESCRIPTION

       The fubyte routine returns 1 byte from the unprotected user address space to the calling program.

NOTES

       If the size of the return value is larger than 1 byte, the byte actually used for the return value is implementation defined.

RETURN VALUES

       Upon successful completion, fubyte returns a value greater than 0 (zero). Otherwise, it returns -1, indicating that the user address speci-
       fied in user_src cannot be accessed.

SEE ALSO

       Routines: copyinstr(9r), fuword(9r), subyte(9r), suword(9r)

																	fubyte(9r)

FETCH(9)						   BSD Kernel Developer's Manual						  FETCH(9)

NAME

     fetch, fubyte, fuibyte, fusword, fuswintr, fuword, fuiword -- fetch data from user-space

SYNOPSIS

     #include <sys/types.h>
     #include <sys/systm.h>

     int
     fubyte(const void *base);

     int
     fusword(const void *base);

     int
     fuswintr(const void *base);

     long
     fuword(const void *base);

DESCRIPTION

     The fetch functions are designed to copy small amounts of data from user-space.

     The fetch routines provide the following functionality:

     fubyte()	 Fetches a byte of data from the user-space address base.

     fusword()	 Fetches a short word of data from the user-space address base.

     fuswintr()  Fetches a short word of data from the user-space address base.  This function is safe to call during an interrupt context.

     fuword()	 Fetches a word of data from the user-space address base.

RETURN VALUES

     The fetch functions return the data fetched or -1 on failure.  Note that these functions all do "unsigned" access, and therefore will never
     sign extend byte or short values.	This prevents ambiguity with the error return value for all functions except fuword().

SEE ALSO

     copy(9), store(9)

BUGS

     The function fuword() has no way to unambiguously signal an error, because the data it reads might legitimately be the same as the -1 used to
     indicate an error.  The other functions do not have this problem because the unsigned values returned by those can never match the -1 error
     return value.

BSD
								  January 7, 1996							       BSD