From owner-freebsd-dtrace@FreeBSD.ORG Tue Oct 15 22:43:49 2013 Return-Path: Delivered-To: dtrace@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 5B7D06FF for ; Tue, 15 Oct 2013 22:43:49 +0000 (UTC) (envelope-from brendan.gregg@joyent.com) Received: from mail-pb0-f53.google.com (mail-pb0-f53.google.com [209.85.160.53]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 357622DA7 for ; Tue, 15 Oct 2013 22:43:48 +0000 (UTC) Received: by mail-pb0-f53.google.com with SMTP id up15so9453861pbc.12 for ; Tue, 15 Oct 2013 15:43:48 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:in-reply-to:references:date :message-id:subject:from:to:cc:content-type; bh=8fLi/vcvfRFgHSu+G0G55wvffj37M0kjv0KQQKNnotU=; b=cIfDAafNveY57xwAkalJ4PS7BtJB+gM/C9uZ4GaMkaSfPoCTg1bOKJPrHf1X7j2tyo v2DaEYEfPBUiQO/8jM2FKwLkQpVw1rfXi7hk7BLAYNv0/Ek2H4zFwWy89x02V8msJbLG 4IPV2ju8ILMSVkZIHoVUeErl7bQs7aUCZKVXSPM77iEAYluXBv2WQwbUu/FnPPOmpXoC UG5gGDJdwimftj0qs7Zv7br7FNaHEXwHWIpVRh5k2oVR88SYVF5PHtoHbp2ZQLc5Cqhv ux1x3JoHN34wE9htUwA5jLJQtk5IzOR39+s/KDqfXK5sj3h30cNumUAd+naPxN5pR/sj ga/Q== X-Gm-Message-State: ALoCoQlv/DkWKfpf0750RYw4laa0f/3y4+ACriALvZlh5rbuNYpsq6Q5LSid0lHLYiXqCbZ95PQu MIME-Version: 1.0 X-Received: by 10.68.44.33 with SMTP id b1mr43558474pbm.53.1381877028377; Tue, 15 Oct 2013 15:43:48 -0700 (PDT) Received: by 10.70.55.34 with HTTP; Tue, 15 Oct 2013 15:43:48 -0700 (PDT) In-Reply-To: <20131010042544.GB65451@raichu> References: <52546385.2050203@FreeBSD.org> <20131010042544.GB65451@raichu> Date: Tue, 15 Oct 2013 15:43:48 -0700 Message-ID: Subject: Re: Dtrace providers wanted list From: Brendan Gregg To: Mark Johnston , Robert Mustacchi Content-Type: text/plain; charset=UTF-8 X-Content-Filtered-By: Mailman/MimeDel 2.1.14 Cc: dtrace@freebsd.org X-BeenThere: freebsd-dtrace@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "A discussion list for developers working on DTrace in FreeBSD." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 15 Oct 2013 22:43:49 -0000 On Wed, Oct 9, 2013 at 9:25 PM, Mark Johnston wrote: > On Tue, Oct 08, 2013 at 02:56:53PM -0500, Pedro Giffuni wrote: > [...] > > > > This is closely related to pmc(3) but obviously our implementation is > > completely different from the Solaris one. > > > > > > Well, just though I should share the above links in the hope of > > motivating more DTrace provider porting. At this time our base Dtrace > > port is pretty good but we have the chicken and egg problem where > > developers don't know how useful DTrace really is because there is no > > provider for their code. > > I think it's also important to have more and better documentation of > existing providers. More providers are nice, but they're not as useful > when their existence is not widely known or it's not clear how they > might be used. > > I don't really like having links to an Oracle wiki page at least partly > because none of the FreeBSD ports of those providers are 100% compatible. > I've started writing man pages for the network providers; an example is > here: > > http://people.freebsd.org/~markj/dtrace/dtrace-ip.4.txt > > But I'm open to other forms of documentation as well. > Man pages would be handy. These would be in addition to the other online docs I use: dtrace -lvn, and vi /usr/lib/dtrace/*.d! Robert Mustacchi has been getting an updated version of the original DTrace guide on http://dtrace.org/guide, from https://github.com/rmustacc/illumos-docbooks/tree/master/raw/dtrace. It's currently the "illumos Dynamic Tracing Guide", although we have talked about how to support other OSes in the same place (not sure how). Brendan -- Brendan Gregg, Joyent http://dtrace.org/blogs/brendan