[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Base Operating System and Extensions Technical Reference, Volume 2

trcon Subroutine

Purpose

Starts the collection of trace data.

Library

Runtime Services Library (librts.a)

Syntax

int trcon(Channel)
int Channel;

Description

The trcon subroutine issues an ioctl subroutine to the trace device driver to start trace data collection for a particular trace channel. The trace session must have already been started using the trace command or the trcstart subroutine.

Parameters

Channel Specifies one of eight trace channels. Channel number 0 always refers to the Event/Performance trace. Channel numbers 1 through 7 specify generic trace channels.

Return Values

0 The ioctl subroutine was successful. Trace data collection starts.
-1 The ioctl subroutine was not successful.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The ioctl subroutine, trcgen subroutine, trchook subroutine, trcoff subroutine, trcstart subroutine, trcstop subroutine.

The trace daemon.

The trcgenk kernel service, trcgenkt kernel service.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]