usr/src/cmd/dtrace/test/tst/common/dtraceUtil/man.TraceFunctions

   1 /*
   2  * CDDL HEADER START
   3  *
   4  * The contents of this file are subject to the terms of the
   5  * Common Development and Distribution License (the "License").
   6  * You may not use this file except in compliance with the License.
   7  *
   8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9  * or http://www.opensolaris.org/os/licensing.
  10  * See the License for the specific language governing permissions
  11  * and limitations under the License.
  12  *
  13  * When distributing Covered Code, include this CDDL HEADER in each
  14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15  * If applicable, add the following below this CDDL HEADER, with the
  16  * fields enclosed by brackets "[]" replaced with your own identifying
  17  * information: Portions Copyright [yyyy] [name of copyright owner]
  18  *
  19  * CDDL HEADER END
  20  */
  21
  22 /*
  23  * Copyright 2006 Sun Microsystems, Inc.  All rights reserved.
  24  * Use is subject to license terms.
  25  */
  26
  27 #pragma ident   "%Z%%M% %I%     %E% SMI"
  28
  29 /*
  30  * ASSERTION:
  31  * Using -f option.
  32  *
  33  * SECTION: dtrace Utility/-f Option
  34  *
  35  * NOTES: Manually check:
  36  *
  37  * 1) automated in tst.InvalidTraceFunc1.d.ksh
  38  * /usr/sbin/dtrace -f profile
  39  * RESULT: invalid probe specifier
  40  *
  41  * 2) automated in tst.InvalidTraceFunc2.d.ksh
  42  * /usr/sbin/dtrace -f genunix
  43  * RESULT: invalid probe specifier
  44  *
  45  * 3)
  46  * /usr/sbin/dtrace -f read
  47  * RESULT: tracing of matching list of probes with function read.
  48  *
  49  * 4) automated in tst.InvalidTraceFunc3.d.ksh
  50  * /usr/sbin/dtrace -f read:
  51  * RESULT: invalid probe specifier
  52  *
  53  * 5)
  54  * /usr/sbin/dtrace -f ::read
  55  * RESULT: tracing of matching list of probes with function read.
  56  *
  57  * 6) automated in tst.InvalidTraceFunc4.d.ksh
  58  * /usr/sbin/dtrace -f ::read:
  59  * RESULT: invalid probe specifier
  60  *
  61  * 7)
  62  * /usr/sbin/dtrace -f genunix:read
  63  * RESULT: tracing of probes with module genunix and function read.
  64  *
  65  * 8)
  66  * /usr/sbin/dtrace -f sysinfo:genunix:read
  67  * RESULT: tracing of probes with provider sysinfo, module genunix
  68  * and function read.
  69  *
  70  * 9)
  71  * /usr/sbin/dtrace -f sysinfo::read
  72  * RESULT: tracing of probes with provider sysinfo and function read.
  73  *
  74  * 10) automated in tst.InvalidTraceFunc5.d.ksh
  75  * /usr/sbin/dtrace -f :genunix::
  76  * RESULT: invalid probe specifier
  77  *
  78  * 11) automated in tst.InvalidTraceFunc6.d.ksh
  79  * /usr/sbin/dtrace -f profile:::profile-97
  80  * RESULT: invalid probe specifier.
  81  *
  82  * 12)
  83  * /usr/sbin/dtrace -f read -f write
  84  * RESULT: tracing of both read and write probes.
  85  *
  86  * 13)
  87  * /usr/sbin/dtrace -f read -f fight
  88  * RESULT: Count of matching read probes and invalid probe specifier
  89  * for fight
  90  *
  91  * 14) automated in tst.InvalidTraceFunc8.d.ksh
  92  * /usr/sbin/dtrace -f fight -f write
  93  * RESULT: invalid probe specifier.
  94  *
  95  * 15) automated in tst.InvalidTraceFunc7.d.ksh
  96  * /usr/sbin/dtrace -f fbt:des:des3_crunch_block:return
  97  * RESULT: invalid probe specifier.
  98  *
  99  * 16)
 100  * /usr/sbin/dtrace -f read'{printf("FOUND");}'
 101  * RESULT: tracing of probes with function read and with message FOUND
 102  *
 103  * 17)
 104  * /usr/sbin/dtrace -f ::read'{printf("FOUND");}'
 105  * RESULT: tracing of probes with function read and with message FOUND
 106  *
 107  * 18) automated in tst.InvalidTraceFunc9.d.ksh
 108  * /usr/sbin/dtrace -f read '{printf("FOUND");}'
 109  * RESULT: invalid probe specifier.
 110  *
 111  * 19)
 112  * /usr/sbin/dtrace -f read'/probename == "entry"/{printf("FOUND");}'
 113  * RESULT: tracing of probes with function read, name entry and with
 114  * message FOUND
 115  */