From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 12214 invoked by alias); 17 Oct 2008 03:18:39 -0000 Received: (qmail 12204 invoked by uid 22791); 17 Oct 2008 03:18:38 -0000 X-Spam-Check-By: sourceware.org Received: from ti-out-0910.google.com (HELO ti-out-0910.google.com) (209.85.142.185) by sourceware.org (qpsmtpd/0.31) with ESMTP; Fri, 17 Oct 2008 03:18:03 +0000 Received: by ti-out-0910.google.com with SMTP id d10so154006tib.12 for ; Thu, 16 Oct 2008 20:18:00 -0700 (PDT) Received: by 10.110.49.2 with SMTP id w2mr2567504tiw.48.1224213479984; Thu, 16 Oct 2008 20:17:59 -0700 (PDT) Received: by 10.110.42.9 with HTTP; Thu, 16 Oct 2008 20:17:59 -0700 (PDT) Message-ID: Date: Fri, 17 Oct 2008 03:18:00 -0000 From: teawater To: "Eli Zaretskii" Subject: Re: [reverse RFC] Add documentation for process record and replay Cc: msnyder@vmware.com, gdb-patches@sourceware.org In-Reply-To: MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="----=_Part_77117_26915973.1224213479962" References: <48F63B15.3070705@vmware.com> 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: 2008-10/txt/msg00421.txt.bz2 ------=_Part_77117_26915973.1224213479962 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline Content-length: 2504 Thanks Eli. I make a new one. 2008-10-17 Hui Zhu * gdb.texinfo: Add documentation for process record and replay. Thanks, Hui On Fri, Oct 17, 2008 at 02:40, Eli Zaretskii wrote: >> Date: Thu, 16 Oct 2008 15:35:01 +0800 >> From: teawater >> Cc: msnyder@vmware.com, gdb-patches@sourceware.org >> >> According to the suggestions. I make a new patch. >> >> 2008-10-16 Hui Zhu >> >> * gdb.texinfo: Add documentation for process record and replay. > > OK. This needs some rewording and rephrasing, but I can do that > later, after the patch is committed. (However, please fix the few > simple formatting errors I mention below.) > > I'm somewhat concerned about the fact that the functionality and > limitations of the ``record and replay'' target are not described at > all. If I were to debug using such an architecture, I'd like to know > what it can and cannot do. For example, if I replay, does the I/O > happen like it happened during the recorded session? What about > signals? crashes? etc. Are there things that simply cannot be > reproduced exactly, due to fundamental limitations of the replay > target? > > Shouldn't we give the reader some idea about these issues? > >> +running. Therefore you need to first start the process @code{run}, > ^^ > Please make sure you have 2 spaces after each period that ends a > sentence. > >> +earlier point), the inferior process will become "live" at that earlier state, >> +and it will then be possible to continue debugging the process "live" from >> +that state. > > ``live'', not "live". In Texinfo, please always use ``...'' quoting > rather than "..", because the former produces prettier results in the > printed manual. ".." should be reserved only for string constants in > code fragments. > >> +@kindex set record-insn-number-max @var{limit} > > Please don't put arguments in the index entries. Index entries should > name only the command name. > >> +@item set record-stop-at-limit >> +@item set record-stop-at-limit on > > Only the first item of several that share the same description can use > @item, the rest should use @itemx. > >> +@itemx set record-stop-at-limit off > > @itemx cannot be the first item. > >> +(see "Set values of variables", above); it means you will abandon the > > Is this a reference to another section? If so, please use @pxref, > which will produce a true hyperlink that can be followed in an Info > reader. > ------=_Part_77117_26915973.1224213479962 Content-Type: text/plain; name=rec_doc.txt Content-Transfer-Encoding: base64 X-Attachment-Id: f_fme97wup0 Content-Disposition: attachment; filename=rec_doc.txt Content-length: 6601 LS0tIGEvQ2hhbmdlTG9nCisrKyBiL0NoYW5nZUxvZwpAQCAtMSwzICsxLDcg QEAKKzIwMDgtMTAtMTcgIEh1aSBaaHUgIDx0ZWF3YXRlckBnbWFpbC5jb20+ CisKKwkqIGdkYi50ZXhpbmZvOiBBZGQgZG9jdW1lbnRhdGlvbiBmb3IgcHJv Y2VzcyByZWNvcmQgYW5kIHJlcGxheS4KKwogMjAwOC0wOS0zMCAgTWljaGFl bCBTbnlkZXIgIDxtc255ZGVyQHZtd2FyZS5jb20+CiAKIAkqIGdkYi50ZXhp bmZvOiBBZGQgZG9jdW1lbnRhdGlvbiBmb3IgcmV2ZXJzZSBleGVjdXRpb24u Ci0tLSBhL2dkYi50ZXhpbmZvCisrKyBiL2dkYi50ZXhpbmZvCkBAIC0xNDQs NiArMTQ0LDcgQEAgc29mdHdhcmUgaW4gZ2VuZXJhbC4gIFdlIHdpbGwgbWlz cyBoaW0uCiAqIFJ1bm5pbmc6OiAgICAgICAgICAgICAgICAgICAgIFJ1bm5p bmcgcHJvZ3JhbXMgdW5kZXIgQHZhbHVle0dEQk59CiAqIFN0b3BwaW5nOjog ICAgICAgICAgICAgICAgICAgIFN0b3BwaW5nIGFuZCBjb250aW51aW5nCiAq IFJldmVyc2UgRXhlY3V0aW9uOjogICAgICAgICAgIFJ1bm5pbmcgcHJvZ3Jh bXMgYmFja3dhcmQKKyogUHJvY2VzcyByZWNvcmQgYW5kIHJlcGxheTo6ICAg UmVjb3JkaW5nIHByb2dyYW1zIHJ1bm5pbmcgbWVzc2FnZSBhbmQgcmVwbGF5 IGl0CiAqIFN0YWNrOjogICAgICAgICAgICAgICAgICAgICAgIEV4YW1pbmlu ZyB0aGUgc3RhY2sKICogU291cmNlOjogICAgICAgICAgICAgICAgICAgICAg RXhhbWluaW5nIHNvdXJjZSBmaWxlcwogKiBEYXRhOjogICAgICAgICAgICAg ICAgICAgICAgICBFeGFtaW5pbmcgZGF0YQpAQCAtNDk2Myw2ICs0OTY0LDEw MiBAQCBUaGlzIGlzIHRoZSBkZWZhdWx0LgogQGVuZCB0YWJsZQogCiAKK0Bu b2RlIFByb2Nlc3MgcmVjb3JkIGFuZCByZXBsYXkKK0BjaGFwdGVyIFJlY29y ZGluZyBwcm9ncmFtcyBydW5uaW5nIG1lc3NhZ2UgYW5kIHJlcGxheSBpdAor QGNpbmRleCBwcm9jZXNzIHJlY29yZCBhbmQgcmVwbGF5CitAY2luZGV4IHJl Y29yZGluZyBwcm9ncmFtcyBydW5uaW5nIG1lc3NhZ2UgYW5kIHJlcGxheSBp dAorCitJbiBhIGFyY2hpdGVjdHVyZSBlbnZpcm9ubWVudCB0aGF0IHN1cHBv cnRzIHByb2Nlc3MgcmVjb3JkIGFuZCByZXBsYXksCitwcm9jZXNzIHJlY29y ZCBhbmQgcmVwbGF5IHRhcmdldCBjYW4gcmVjb3JkIGEgbG9nIG9mIHRoZSBw cm9jZXNzIGV4ZWN1dGlvbiwKK2FuZCByZXBsYXkgaXQgd2l0aCBib3RoIGZv cndhcmQgYW5kIHJldmVyc2UgZXhlY3V0ZSBjb21tYW5kcy4KKworV2hlbiB0 aGlzIHRhcmdldCBpcyBpbiB1c2UsIGlmIHRoZSBleGVjdXRpb24gbG9nIGlu Y2x1ZGVzIHRoZSByZWNvcmQgZm9yCit0aGUgbmV4dCBpbnN0cnVjdGlvbiwg QHZhbHVle0dEQk59IHdpbGwgZGVidWcgaW4gcmVwbGF5IG1vZGUuICBTbyBp bmZlcmlvcgord2lsbCBub3QgcmVhbGx5IGV4ZWN1dGUgYW5kIGFsbCB0aGUg ZXhlY3V0aW9uIGV2ZW50cyBhcmUgdGFrZW4gZnJvbSB0aGUKK2V4ZWN1dGlv biBsb2cuICBKdXN0IHRoZSB2YWx1ZXMgb2YgcmVnaXN0ZXJzIChpbmNsdWRl IHBjIHJlZ2lzdGVyKSBhbmQKK21lbW9yeSBvZiB0aGUgaW5mZXJpb3Igd2ls bCBiZSBjaGFuZ2VkLgorCitPdGhlcndpc2UsIEB2YWx1ZXtHREJOfSB3aWxs IGRlYnVnIGluIHJlY29yZCBtb2RlLiAgU28gaW5mZXJpb3Igd2lsbAorZXhl Y3V0ZSBub3JtYWxseSBhbmQgQHZhbHVle0dEQk59IHdpbGwgcmVjb3JkIHRo ZSBleGVjdXRpb24gbG9nLgorCitJZiB5b3UgYXJlIGRlYnVnZ2luZyBpbiBh IGFyY2hpdGVjdHVyZSBlbnZpcm9ubWVudCB0aGF0IHN1cHBvcnRzCitwcm9j ZXNzIHJlY29yZCBhbmQgcmVwbGF5LCBAdmFsdWV7R0RCTn0gcHJvdmlkZXMg dGhlIGZvbGxvd2luZyBjb21tYW5kcy4KKworQHRhYmxlIEBjb2RlCitAa2lu ZGV4IHRhcmdldCByZWNvcmQKK0BraW5kZXggcmVjb3JkCitAa2luZGV4IHJl YworQGl0ZW0gdGFyZ2V0IHJlY29yZAorVGhpcyBhIHN0YW5kYXJkIGNvbW1h bmQgdG8gc3RhcnQgcHJvY2VzcyByZWNvcmQgYW5kIHJlcGxheSB0YXJnZXQu CitQcm9jZXNzIHJlY29yZCBhbmQgcmVwbGF5IHRhcmdldCBjYW4gb25seSBk ZWJ1ZyBhIHByb2Nlc3MgdGhhdCBhbHJlYWR5CitydW5uaW5nLiAgVGhlcmVm b3JlIHlvdSBuZWVkIHRvIGZpcnN0IHN0YXJ0IHRoZSBwcm9jZXNzIEBjb2Rl e3J1bn0sCithbmQgdGhlbiBzdGFydCB0aGUgcmVjb3JkaW5nIEBjb2Rle3Jl Y29yZH0uCisKK0BraW5kZXggc3RvcHJlY29yZAorQGtpbmRleCBzcgorQGl0 ZW0gc3RvcHJlY29yZAorU3RvcCBwcm9jZXNzIHJlY29yZCBhbmQgcmVwbGF5 IHRhcmdldCBhdCBvbmNlLiBXaGVuIFByb2Nlc3MgcmVjb3JkIGFuZAorcmVw bGF5IHRhcmdldCBzdG9wcywgYWxsIHRoZSBleGVjdXRpb24gbG9nIHdpbGwg YmUgZGVsZXRlZCBhbmQgdGhlIGluZmVyaW9yCit3aWxsIGVpdGhlciBiZSB0 ZXJtaW5hdGVkLCBvciByZW1haW4gaW4gaXRzIGZpbmFsIHN0YXRlLgorCitX aGVuIHlvdSBzdG9wIHRoZSBwcm9jZXNzIHJlY29yZCBhbmQgcmVwbGF5IHRh cmdldCBpbiByZWNvcmQgbW9kZSAoYXQgdGhlCitlbmQgb2YgdGhlIGV4ZWN1 dGlvbiBsb2cpLCB0aGUgaW5mZXJpb3Igd2lsbCBiZSBzdG9wcGVkIGF0IHRo ZSBuZXh0CitpbnN0cnVjdGlvbiB0aGF0IHdvdWxkIGhhdmUgYmVlbiByZWNv cmRlZC4gIEluIG90aGVyIHdvcmRzLCBpZiB5b3UgcmVjb3JkCitmb3IgYSB3 aGlsZSBhbmQgdGhlbiBzdG9wIHJlY29yZGluZywgdGhlIGluZmVyaW9yIHBy b2Nlc3Mgd2lsbCBiZSBsZWZ0IGluCit0aGUgc2FtZSBzdGF0ZSBhcyBpZiBy ZWNvcmRpbmcgbmV2ZXIgaGFwcGVuZWQuCisKK09uIHRoZSBvdGhlciBoYW5k LCBpZiB0aGUgcHJvY2VzcyByZWNvcmQgYW5kIHJlcGxheSB0YXJnZXQgaXMg c3RvcHBlZCB3aGlsZQoraW4gcmVwbGF5IG1vZGUgKHRoYXQgaXMsIG5vdCBh dCB0aGUgZW5kIG9mIHRoZSBleGVjdXRpb24gbG9nIGJ1dCBhdCBzb21lCitl YXJsaWVyIHBvaW50KSwgdGhlIGluZmVyaW9yIHByb2Nlc3Mgd2lsbCBiZWNv bWUgYGBsaXZlIiBhdCB0aGF0IGVhcmxpZXIgc3RhdGUsCithbmQgaXQgd2ls bCB0aGVuIGJlIHBvc3NpYmxlIHRvIGNvbnRpbnVlIGRlYnVnZ2luZyB0aGUg cHJvY2VzcyBgYGxpdmUiIGZyb20KK3RoYXQgc3RhdGUuCisKK1doZW4gdGhl IGluZmVyaW9yIHByb2Nlc3MgZXhpdHMsIG9yIEB2YWx1ZXtHREJOfSBkZXRh Y2hlcyBmcm9tIGl0LCBwcm9jZXNzCityZWNvcmQgYW5kIHJlcGxheSB0YXJn ZXQgd2lsbCBhdXRvbWF0aWNhbGx5IHN0b3AgaXRzZWxmLgorCitAa2luZGV4 IHNldCByZWNvcmQtaW5zbi1udW1iZXItbWF4CitAaXRlbSBzZXQgcmVjb3Jk LWluc24tbnVtYmVyLW1heCBAdmFye2xpbWl0fQorU2V0IHRoZSBsaW1pdCBv ZiBpbnN0cnVjdGlvbnMgdG8gYmUgcmVjb3JkZWQuICBEZWZhdWx0IHZhbHVl IGlzIDIwMDAwMC4KKworSW4gdGhpcyBjYXNlLCBpZiByZWNvcmQgaW5zdHJ1 Y3Rpb25zIG51bWJlciBpcyBiaWdnZXIgdGhhbiBAdmFye2xpbWl0fSwKK0B2 YWx1ZXtHREJOfSB3aWxsIGF1dG8gZGVsZXRlIHRoZSBlYXJsaWVzdCByZWNv cmRlZCBpbnN0cnVjdGlvbiBleGVjdXRlCitsb2cuCisKK0lmIHNldCB0byAw LCBAdmFsdWV7R0RCTn0gd2lsbCBub3QgZGVsZXRlIHRoZSBlYXJsaWVzdCBy ZWNvcmRlZCBpbnN0cnVjdGlvbgorZXhlY3V0ZSBsb2cuICBSZWNvcmQgaW5z dHJ1Y3Rpb25zIG51bWJlciBsaW1pdCBmdW5jdGlvbiB3aWxsIGRpc2FibGUu CisKK0BraW5kZXggc2hvdyByZWNvcmQtaW5zbi1udW1iZXItbWF4CitAaXRl bSBzaG93IHJlY29yZC1pbnNuLW51bWJlci1tYXgKK1Nob3cgdGhlIHZhbHVl IG9mIHJlY29yZGVkIGluc3RydWN0aW9ucyBsaW1pdC4KKworQGtpbmRleCBz ZXQgcmVjb3JkLXN0b3AtYXQtbGltaXQKK0BpdGVtIHNldCByZWNvcmQtc3Rv cC1hdC1saW1pdCBvbgorU2V0IHRoZSBiZWhhdmlvciB3aGVuIHJlY29yZCBp bnN0cnVjdGlvbnMgbGltaXQgaXMgcmVhY2hlZC4KK1RoaXMgaXMgdGhlIGRl ZmF1bHQgbW9kZS4gIE1lYW5pbmcgdGhhdCBAdmFsdWV7R0RCTn0gd2lsbCBz dG9wIGFzayB1c2VyCit3YW50IGNsb3NlIEBjb2Rle3JlY29yZC1zdG9wLWF0 LWxpbWl0fSBvciBzdG9wIGluZmVyaW9yLgorCitAaXRlbSBzZXQgcmVjb3Jk LXN0b3AtYXQtbGltaXQgb2ZmCitUaGlzIG1lYW4gdGhhdCBAdmFsdWV7R0RC Tn0gd2lsbCBhdXRvIGRlbGV0ZSB0aGUgb2xkZXN0IHJlY29yZCB0byBtYWtl Cityb29tIGZvciBlYWNoIG5ldyBvbmUuCisKK0BraW5kZXggc2hvdyByZWNv cmQtc3RvcC1hdC1saW1pdAorQGl0ZW0gc2hvdyByZWNvcmQtc3RvcC1hdC1s aW1pdAorU2hvdyB0aGUgdmFsdWUgb2YgcmVjb3JkLXN0b3AtYXQtbGltaXQu CisKK0BraW5kZXggaW5mbyByZWNvcmQtaW5zbi1udW1iZXIKK0BpdGVtIGlu Zm8gcmVjb3JkLWluc24tbnVtYmVyCitTaG93IHRoZSBjdXJyZW50IG51bWJl ciBvZiByZWNvcmRlZCBpbnN0cnVjdGlvbnMuCisKK0BraW5kZXggZGVscmVj b3JkCitAa2luZGV4IGRyCitAaXRlbSBkZWxyZWNvcmQKK1doZW4gcmVjb3Jk IHRhcmdldCBydW5uaW5nIGluIHJlcGxheSBtb2RlIChgYGluIHRoZSBwYXN0 IiksIGRlbGV0ZSB0aGUKK3N1YnNlcXVlbnQgZXhlY3V0aW9uIGxvZyBhbmQg YmVnaW4gdG8gcmVjb3JkIGEgbmV3IGV4ZWN1dGlvbiBsb2cgc3RhcnRpbmcK K2Zyb20gdGhlIGN1cnJlbnQgYWRkcmVzcy4gIEl0IG1lYW5zIHlvdSB3aWxs IGFiYW5kb24gdGhlIHByZXZpb3VzbHkKK3JlY29yZGVkIGBgZnV0dXJlIiBh bmQgYmVnaW4gcmVjb3JkaW5nIGEgbmV3IGBgZnV0dXJlIi4KK0BlbmQgdGFi bGUKKworCiBAbm9kZSBTdGFjawogQGNoYXB0ZXIgRXhhbWluaW5nIHRoZSBT dGFjawogCg== ------=_Part_77117_26915973.1224213479962--