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

Technical Reference: Base Operating System and Extensions , 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 (trcstart Subroutine) 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 (trcgen or trcgent Subroutine) subroutine, trchook (trchook or utrchook Subroutine) subroutine, trcoff (trcoff Subroutine) subroutine, trcstart (trcstart Subroutine) subroutine, trcstop (trcstop Subroutine) subroutine.

The trace daemon.

The trcgenk kernel service, trcgenkt kernel service.


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