[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Communications, Volume 2


I_LOOK streamio Operation

Purpose

Retrieves the name of the module just below the stream head.

Syntax

#include <sys/conf.h>
#include <stropts.h>

int ioctl (fildes, command, arg)
int fildes, command;

Description

The I_LOOK operation retrieves the name of the module just below the stream head of the stream pointed to by the fildes parameter and places it in a null terminated character string pointed at by the arg parameter. The buffer pointed to by the arg parameter should be at least FMNAMESMZ + 1 bytes long.

Error Codes

If unsuccessful, the errno global variable is set to one of the following values:

EFAULT The arg parameter points outside the allocated address space.
EINVAL No module is present in stream.

Implementation Specifics

This operation is part of STREAMS Kernel Extensions.

Related Information

The scls command.

The streamio operations.

The I_FIND streamio operation, I_POP streamio operation, I_PUSH streamio operation.

Understanding STREAMS Drivers and Modules in AIX 5L Version 5.1 Communications Programming Concepts.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]