[ Bottom of Page | Previous Page | Next Page | 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.

This operation is part of STREAMS Kernel Extensions.

Error Codes

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

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

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.2 Communications Programming Concepts.

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