From patchwork Tue Jan 28 14:33:33 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Will Newton X-Patchwork-Id: 23794 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-ve0-f200.google.com (mail-ve0-f200.google.com [209.85.128.200]) by ip-10-151-82-157.ec2.internal (Postfix) with ESMTPS id 580D1202B2 for ; Tue, 28 Jan 2014 14:33:44 +0000 (UTC) Received: by mail-ve0-f200.google.com with SMTP id c14sf1003186vea.3 for ; Tue, 28 Jan 2014 06:33:43 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:delivered-to:from:to:cc:subject :date:message-id:x-original-sender:x-original-authentication-results :precedence:mailing-list:list-id:list-post:list-help:list-archive :list-unsubscribe; bh=y5ZV0VovZh77M9Qv0bAlhMT1p9x21MYFwt5tbj1cQ6Q=; b=SLUVfsS2LakuVTG9UesyEqdD4XdepspOkuvJUcRWudwMpzWe8fi/vtr0ifRY2N3EGK bWR9XuXNgwDGkIoHe7eWS+JhSDthad6fUAzVNtesZ3okrjFyujX7kVk5XBtMzeBqgYbB cesA/e2xWKqfWVjX5jwGIMly4S3tV4FIG6EdheEpk34V3XjnNnGdc8goypEyugnsmnI7 hm4hie4S/Q6NmicDiJaqvIOmxoETe4uVgFkg6XR7VlNg65OZ2vIZQO+DiDykHqKi78Cs 0jOmQtJ802JK1JY3K968RABtFMIcZkURburfmEPR48O/KCJ/ukK7YzZh/u3LV6R27Ju3 qrow== X-Gm-Message-State: ALoCoQn3MCRqEz0No2pRcuVYRNXPRJc2awnXYOY7Ee/cYfPrIEEaL52zc1//SZJ/7RJCKvXrnzEJ X-Received: by 10.224.4.202 with SMTP id 10mr625378qas.7.1390919623349; Tue, 28 Jan 2014 06:33:43 -0800 (PST) MIME-Version: 1.0 X-BeenThere: patchwork-forward@linaro.org Received: by 10.140.82.166 with SMTP id h35ls2019880qgd.77.gmail; Tue, 28 Jan 2014 06:33:43 -0800 (PST) X-Received: by 10.58.169.7 with SMTP id aa7mr1416837vec.24.1390919623259; Tue, 28 Jan 2014 06:33:43 -0800 (PST) Received: from mail-ve0-f171.google.com (mail-ve0-f171.google.com [209.85.128.171]) by mx.google.com with ESMTPS id q10si6401212ves.58.2014.01.28.06.33.43 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Tue, 28 Jan 2014 06:33:43 -0800 (PST) Received-SPF: neutral (google.com: 209.85.128.171 is neither permitted nor denied by best guess record for domain of patch+caf_=patchwork-forward=linaro.org@linaro.org) client-ip=209.85.128.171; Received: by mail-ve0-f171.google.com with SMTP id pa12so289329veb.16 for ; Tue, 28 Jan 2014 06:33:43 -0800 (PST) X-Received: by 10.58.29.42 with SMTP id g10mr336383veh.28.1390919623185; Tue, 28 Jan 2014 06:33:43 -0800 (PST) X-Forwarded-To: patchwork-forward@linaro.org X-Forwarded-For: patch@linaro.org patchwork-forward@linaro.org Delivered-To: patches@linaro.org Received: by 10.220.174.196 with SMTP id u4csp34863vcz; Tue, 28 Jan 2014 06:33:42 -0800 (PST) X-Received: by 10.152.5.101 with SMTP id r5mr9388lar.56.1390919621983; Tue, 28 Jan 2014 06:33:41 -0800 (PST) Received: from mail-lb0-f179.google.com (mail-lb0-f179.google.com [209.85.217.179]) by mx.google.com with ESMTPS id yf5si7033530lab.77.2014.01.28.06.33.41 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Tue, 28 Jan 2014 06:33:41 -0800 (PST) Received-SPF: neutral (google.com: 209.85.217.179 is neither permitted nor denied by best guess record for domain of will.newton@linaro.org) client-ip=209.85.217.179; Received: by mail-lb0-f179.google.com with SMTP id l4so399027lbv.38 for ; Tue, 28 Jan 2014 06:33:41 -0800 (PST) X-Received: by 10.112.73.100 with SMTP id k4mr1166491lbv.25.1390919621371; Tue, 28 Jan 2014 06:33:41 -0800 (PST) Received: from localhost.localdomain (cpc6-seac21-2-0-cust453.7-2.cable.virginm.net. [82.1.113.198]) by mx.google.com with ESMTPSA id bo10sm16883708lbb.16.2014.01.28.06.33.39 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 28 Jan 2014 06:33:40 -0800 (PST) From: Will Newton To: libc-alpha@sourceware.org Cc: patches@linaro.org Subject: [PATCH 1/2] include/stap-probe.h: Add comment about SystemTap argument format Date: Tue, 28 Jan 2014 14:33:33 +0000 Message-Id: <1390919614-30727-1-git-send-email-will.newton@linaro.org> X-Mailer: git-send-email 1.8.1.4 X-Removed-Original-Auth: Dkim didn't pass. X-Original-Sender: will.newton@linaro.org X-Original-Authentication-Results: mx.google.com; spf=neutral (google.com: 209.85.128.171 is neither permitted nor denied by best guess record for domain of patch+caf_=patchwork-forward=linaro.org@linaro.org) smtp.mail=patch+caf_=patchwork-forward=linaro.org@linaro.org Precedence: list Mailing-list: list patchwork-forward@linaro.org; contact patchwork-forward+owners@linaro.org List-ID: X-Google-Group-Id: 836684582541 List-Post: , List-Help: , List-Archive: List-Unsubscribe: , Add a comment pointing to the SystemTap wiki page that documents the format of the arguments. Also add a pointer to the SystemTap and gdb sources which seem to be the best place to get the architecture specific details. ChangeLog: 2014-01-28 Will Newton * include/stap-probe.h: Add comment about probe argument format. --- include/stap-probe.h | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/include/stap-probe.h b/include/stap-probe.h index 73b88e6..688646c 100644 --- a/include/stap-probe.h +++ b/include/stap-probe.h @@ -30,7 +30,15 @@ Systemtap's header defines the macros STAP_PROBE (provider, name) and STAP_PROBEn (provider, name, arg1, ..., argn). For "provider" we paste - in the IN_LIB name (libc, libpthread, etc.) automagically. */ + in the IN_LIB name (libc, libpthread, etc.) automagically. + + The format of the arg parameters is discussed here: + + https://sourceware.org/systemtap/wiki/UserSpaceProbeImplementation + + The precise details of how register names are specified is + architecture specific and can be found in the gdb and SystemTap + source code. */ # ifndef NOT_IN_libc # define IN_LIB libc