From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 3352 invoked by alias); 28 Nov 2012 05:52:05 -0000 Received: (qmail 3338 invoked by uid 22791); 28 Nov 2012 05:52:04 -0000 X-SWARE-Spam-Status: No, hits=-4.7 required=5.0 tests=AWL,BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FROM,KHOP_RCVD_TRUST,KHOP_THREADED,RCVD_IN_DNSWL_LOW,RCVD_IN_HOSTKARMA_YE X-Spam-Check-By: sourceware.org Received: from mail-bk0-f41.google.com (HELO mail-bk0-f41.google.com) (209.85.214.41) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Wed, 28 Nov 2012 05:51:58 +0000 Received: by mail-bk0-f41.google.com with SMTP id jg9so5883806bkc.0 for ; Tue, 27 Nov 2012 21:51:56 -0800 (PST) Received: by 10.204.148.12 with SMTP id n12mr5175482bkv.138.1354081916372; Tue, 27 Nov 2012 21:51:56 -0800 (PST) MIME-Version: 1.0 Received: by 10.205.32.12 with HTTP; Tue, 27 Nov 2012 21:51:15 -0800 (PST) In-Reply-To: <50B5A064.2010007@codesourcery.com> References: <50AC324D.7010703@mentor.com> <83r4nmvowo.fsf@gnu.org> <50AEDF18.6090707@mentor.com> <83sj80u5rs.fsf@gnu.org> <83vccqx6hf.fsf@gnu.org> <50B57A77.8090006@codesourcery.com> <50B59974.3070305@mentor.com> <50B5A064.2010007@codesourcery.com> From: Hui Zhu Date: Wed, 28 Nov 2012 05:52:00 -0000 Message-ID: Subject: Re: [PATCH] Add CTF support to GDB [4/4] doc To: Yao Qi Cc: Hui Zhu , Eli Zaretskii , gdb-patches@sourceware.org Content-Type: multipart/mixed; boundary=0015174c3b929f468104cf87c3eb X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2012-11/txt/msg00795.txt.bz2 --0015174c3b929f468104cf87c3eb Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-length: 1967 On Wed, Nov 28, 2012 at 1:25 PM, Yao Qi wrote: > On 11/28/2012 12:56 PM, Hui Zhu wrote: >> >> +By default, this command will save trace frame into tfile format. >> +You can supply the optional argument @code{-ctf} to save date in CTF > > ^^^^ typo. > >> @@ -12089,6 +12096,11 @@ the state of the trace run at the moment >> >> as the current trace frame you are examining. @var{filename} must be >> on a filesystem accessible to the host. >> >> +@kindex target ctf >> +@kindex ctf >> +@item target ctf @var{dirname} >> +Use the directory named @var{dirname} as a source of CTF trace data. >> + >> @end table > > > I am not good at documentation, but I feel that it might be better to > combine the doc for 'target tfile' and 'target ctf' together, because they > (should) behave almost the same to users, how about this? > > @kindex target tfile > @kindex tfile > @item target tfile @var{filename} > @kindex target ctf > @kindex ctf > @itemx target ctf @var{dirname} > Use the file named @var{filename} or directory named @var{dirname} as a > source of trace data. Commands > that examine data work as they do with a live target, but it is not > possible to run any new trace experiments. @code{tstatus} will report > the state of the trace run at the moment the data was saved, as well > as the current trace frame you are examining. @var{filename} or > @var{dirname} must be > > on a filesystem accessible to the host. > > I have no other comments. > > -- > Yao (=E9=BD=90=E5=B0=A7) I think that is better. Post a new version according to your comments. Thanks, Hui News: * GDB now has the ability to read and write trace buffer in common trace format (CTF). To create a CTF trace file, use "tsave -ctf ", and to use it, type "target ctf ". 2012-11-28 Hui Zhu * gdb.texinfo (Trace Files): Add "tsave -ctf" and target ctf. --0015174c3b929f468104cf87c3eb Content-Type: text/plain; charset=US-ASCII; name="ctf-doc.txt" Content-Disposition: attachment; filename="ctf-doc.txt" Content-Transfer-Encoding: base64 X-Attachment-Id: f_ha21d9q60 Content-length: 2802 LS0tIGEvZG9jL2dkYi50ZXhpbmZvCisrKyBiL2RvYy9nZGIudGV4aW5mbwpA QCAtMTIwNzAsNiArMTIwNzAsNyBAQCBvZiB0cmFjZSBkYXRhLCB2aWEgdGhl IEBjb2Rle3RhcmdldCB0ZmlsCiAKIEBraW5kZXggdHNhdmUKIEBpdGVtIHRz YXZlIFsgLXIgXSBAdmFye2ZpbGVuYW1lfQorQGl0ZW14IHRzYXZlIFstY3Rm XSBAdmFye2Rpcm5hbWV9CiBTYXZlIHRoZSB0cmFjZSBkYXRhIHRvIEB2YXJ7 ZmlsZW5hbWV9LiAgQnkgZGVmYXVsdCwgdGhpcyBjb21tYW5kCiBhc3N1bWVz IHRoYXQgQHZhcntmaWxlbmFtZX0gcmVmZXJzIHRvIHRoZSBob3N0IGZpbGVz eXN0ZW0sIHNvIGlmCiBuZWNlc3NhcnkgQHZhbHVle0dEQk59IHdpbGwgY29w eSByYXcgdHJhY2UgZGF0YSB1cCBmcm9tIHRoZSB0YXJnZXQgYW5kCkBAIC0x MjA3OCwxNiArMTIwNzksMjYgQEAgb3B0aW9uYWwgYXJndW1lbnQgQGNvZGV7 LXJ9IChgYHJlbW90ZScnKQogdGhlIGRhdGEgZGlyZWN0bHkgaW50byBAdmFy e2ZpbGVuYW1lfSBpbiBpdHMgb3duIGZpbGVzeXN0ZW0sIHdoaWNoIG1heSBi ZQogbW9yZSBlZmZpY2llbnQgaWYgdGhlIHRyYWNlIGJ1ZmZlciBpcyB2ZXJ5 IGxhcmdlLiAgKE5vdGUsIGhvd2V2ZXIsIHRoYXQKIEBjb2Rle3RhcmdldCB0 ZmlsZX0gY2FuIG9ubHkgcmVhZCBmcm9tIGZpbGVzIGFjY2Vzc2libGUgdG8g dGhlIGhvc3QuKQorQnkgZGVmYXVsdCwgdGhpcyBjb21tYW5kIHdpbGwgc2F2 ZSB0cmFjZSBmcmFtZSBpbnRvIHRmaWxlIGZvcm1hdC4KK1lvdSBjYW4gc3Vw cGx5IHRoZSBvcHRpb25hbCBhcmd1bWVudCBAY29kZXstY3RmfSB0byBzYXZl IGRhdGUgaW4gQ1RGCitmb3JtYXQuICBUaGUgQGRmbntDb21tb24gVHJhY2Ug Rm9ybWF0fSAoQ1RGKSBpcyBwcm9wb3NlZCBhcyBhIHRyYWNlIGZvcm1hdAor dGhhdCBzdWl0cyB0aGUgbmVlZHMgb2YgdGhlIGVtYmVkZGVkLCB0ZWxlY29t LCBoaWdoLXBlcmZvcm1hbmNlCithbmQga2VybmVsIGNvbW11bml0aWVzLiAg UGxlYXNlIGdvdG8gQGluZGljYXRldXJse2h0dHA6Ly93d3cuZWZmaWNpb3Mu Y29tL2N0Zn0KK3RvIGdldCBtb3JlIGluZm9ybWF0aW9uLgogCiBAa2luZGV4 IHRhcmdldCB0ZmlsZQogQGtpbmRleCB0ZmlsZQogQGl0ZW0gdGFyZ2V0IHRm aWxlIEB2YXJ7ZmlsZW5hbWV9Ci1Vc2UgdGhlIGZpbGUgbmFtZWQgQHZhcntm aWxlbmFtZX0gYXMgYSBzb3VyY2Ugb2YgdHJhY2UgZGF0YS4gIENvbW1hbmRz Ci10aGF0IGV4YW1pbmUgZGF0YSB3b3JrIGFzIHRoZXkgZG8gd2l0aCBhIGxp dmUgdGFyZ2V0LCBidXQgaXQgaXMgbm90Ci1wb3NzaWJsZSB0byBydW4gYW55 IG5ldyB0cmFjZSBleHBlcmltZW50cy4gIEBjb2Rle3RzdGF0dXN9IHdpbGwg cmVwb3J0Ci10aGUgc3RhdGUgb2YgdGhlIHRyYWNlIHJ1biBhdCB0aGUgbW9t ZW50IHRoZSBkYXRhIHdhcyBzYXZlZCwgYXMgd2VsbAotYXMgdGhlIGN1cnJl bnQgdHJhY2UgZnJhbWUgeW91IGFyZSBleGFtaW5pbmcuICBAdmFye2ZpbGVu YW1lfSBtdXN0IGJlCi1vbiBhIGZpbGVzeXN0ZW0gYWNjZXNzaWJsZSB0byB0 aGUgaG9zdC4KK0BraW5kZXggdGFyZ2V0IGN0ZgorQGtpbmRleCBjdGYKK0Bp dGVteCB0YXJnZXQgY3RmIEB2YXJ7ZGlybmFtZX0KK1VzZSB0aGUgZmlsZSBu YW1lZCBAdmFye2ZpbGVuYW1lfSBvciBkaXJlY3RvcnkgbmFtZWQgQHZhcntk aXJuYW1lfSBhcworYSBzb3VyY2Ugb2YgdHJhY2UgZGF0YS4gIENvbW1hbmRz IHRoYXQgZXhhbWluZSBkYXRhIHdvcmsgYXMgdGhleSBkbyB3aXRoCithIGxp dmUgdGFyZ2V0LCBidXQgaXQgaXMgbm90IHBvc3NpYmxlIHRvIHJ1biBhbnkg bmV3IHRyYWNlIGV4cGVyaW1lbnRzLgorQGNvZGV7dHN0YXR1c30gd2lsbCBy ZXBvcnQgdGhlIHN0YXRlIG9mIHRoZSB0cmFjZSBydW4gYXQgdGhlIG1vbWVu dAordGhlIGRhdGEgd2FzIHNhdmVkLCBhcyB3ZWxsIGFzIHRoZSBjdXJyZW50 IHRyYWNlIGZyYW1lIHlvdSBhcmUgZXhhbWluaW5nLgorQHZhcntmaWxlbmFt ZX0gb3IgQHZhcntkaXJuYW1lfSBtdXN0IGJlIG9uIGEgZmlsZXN5c3RlbSBh Y2Nlc3NpYmxlIHRvCit0aGUgaG9zdC4KIAogQGVuZCB0YWJsZQogCg== --0015174c3b929f468104cf87c3eb--