Technical Reference: Kernel and Subsystems, Volume 1

io_map_clear Kernel Service

Purpose

Removes an I/O mapping segment.

Syntax

#include <sys/adspace.h>

void io_map_clear (io_handle)
io_handle_t io_handle;

Description

This service destroys all mappings defined by the io_handle_t parameter.

There should be no active mappings (outstanding io_map calls) to this handle when io_map_clear is called. The segment previously created by an io_map_init call or multiple io_map_init calls, is deleted.

Parameters

io_handle

Received on a prior successful call to io_map_init. Describes the I/O space to be removed.

Execution Environment

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

Related Information

io_map_init Kernel Service, io_map Kernel Service, and io_unmap Kernel Service.

Programmed I/O (PIO) Kernel Services in AIX 5L Version 5.2 Kernel Extensions and Device Support Programming Concepts.