From: Daniel Vetter Subject: Re: [PATCH igt] lib/igt_aux: Improve documentation for igt_system_suspend_autoresume() Date: Mon, 17 Oct 2016 16:14:11 +0200 Message-ID: <20161017141411.GM20761@phenom.ffwll.local> References: <1476456674-17618-1-git-send-email-imre.deak@intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail-lf0-x243.google.com (mail-lf0-x243.google.com [IPv6:2a00:1450:4010:c07::243]) by gabe.freedesktop.org (Postfix) with ESMTPS id 0229B6E505 for ; Mon, 17 Oct 2016 14:14:16 +0000 (UTC) Received: by mail-lf0-x243.google.com with SMTP id b75so26756508lfg.3 for ; Mon, 17 Oct 2016 07:14:15 -0700 (PDT) Content-Disposition: inline In-Reply-To: <1476456674-17618-1-git-send-email-imre.deak@intel.com> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" To: Imre Deak Cc: Daniel Vetter , intel-gfx@lists.freedesktop.org List-Id: intel-gfx@lists.freedesktop.org T24gRnJpLCBPY3QgMTQsIDIwMTYgYXQgMDU6NTE6MTRQTSArMDMwMCwgSW1yZSBEZWFrIHdyb3Rl Ogo+IFdoaWxlIGF0IGl0IGZpeCB0aGUgb3JkZXIgb2Ygc3RhdGVzIGZvciBjb25zaXN0ZW5jeS4K PiAKPiBTdWdnZXN0ZWQgYnkgRGFuaWVsLgo+IAo+IENjOiBEYW5pZWwgVmV0dGVyIDxkYW5pZWwu dmV0dGVyQGZmd2xsLmNoPgo+IFNpZ25lZC1vZmYtYnk6IEltcmUgRGVhayA8aW1yZS5kZWFrQGlu dGVsLmNvbT4KCkdvaW5nIG9jZCB3aXRoIGRvY3MgbWFrZXMgbWUgcmVhbGx5IGhhcHB5IFxvLyBB bmQgSSB0aGluayBpdCBkb2VzIGhlbHAKZm9yIG5ldyBmb2xrcyB0byBnZXQgc3RhcnRlZCBpbiBv dXIgZHJhZ29uIGR1bmdlb24gb2YgYSBkcml2ZXIuIFRoYW5rcyBmb3IgZG9pbmcgdGhpcy4KClJl dmlld2VkLWJ5OiBEYW5pZWwgVmV0dGVyIDxkYW5pZWwudmV0dGVyQGZmd2xsLmNoPgoKPiAtLS0K PiAgbGliL2lndF9hdXguYyB8IDIxICsrKysrKysrKysrKysrKystLS0tLQo+ICBsaWIvaWd0X2F1 eC5oIHwgMzYgKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKystCj4gIDIgZmlsZXMg Y2hhbmdlZCwgNTEgaW5zZXJ0aW9ucygrKSwgNiBkZWxldGlvbnMoLSkKPiAKPiBkaWZmIC0tZ2l0 IGEvbGliL2lndF9hdXguYyBiL2xpYi9pZ3RfYXV4LmMKPiBpbmRleCBmMjI1YzJmLi40MjFmNmQ0 IDEwMDY0NAo+IC0tLSBhL2xpYi9pZ3RfYXV4LmMKPiArKysgYi9saWIvaWd0X2F1eC5jCj4gQEAg LTYyOCw4ICs2MjgsOCBAQCB2b2lkIGlndF9jbGVhbnVwX2FwZXJ0dXJlX3RyYXNoZXJzKHZvaWQp Cj4gIAo+ICBzdGF0aWMgY29uc3QgY2hhciAqc3VzcGVuZF9zdGF0ZV9uYW1lW10gPSB7Cj4gIAlb U1VTUEVORF9TVEFURV9GUkVFWkVdID0gImZyZWV6ZSIsCj4gLQlbU1VTUEVORF9TVEFURV9NRU1d ID0gIm1lbSIsCj4gIAlbU1VTUEVORF9TVEFURV9TVEFOREJZXSA9ICJzdGFuZGJ5IiwKPiArCVtT VVNQRU5EX1NUQVRFX01FTV0gPSAibWVtIiwKPiAgCVtTVVNQRU5EX1NUQVRFX0RJU0tdID0gImRp c2siLAo+ICB9Owo+ICAKPiBAQCAtNzQ0LDExICs3NDQsMjIgQEAgc3RhdGljIHVpbnQzMl90IGdl dF9zdXBwb3J0ZWRfc3VzcGVuZF9zdGF0ZXMoaW50IHBvd2VyX2RpcikKPiAgCj4gIC8qKgo+ICAg KiBpZ3Rfc3lzdGVtX3N1c3BlbmRfYXV0b3Jlc3VtZToKPiArICogQHN0YXRlOiBhbiAjaWd0X3N1 c3BlbmRfc3RhdGUsIHRoZSB0YXJnZXQgc3VzcGVuZCBzdGF0ZQo+ICsgKiBAdGVzdDogYW4gI2ln dF9zdXNwZW5kX3Rlc3QsIHRlc3QgcG9pbnQgYXQgd2hpY2ggdG8gY29tcGxldGUgdGhlIHN1c3Bl bmQKPiArICoJICBjeWNsZQo+ICAgKgo+IC0gKiBFeGVjdXRlIGEgc3lzdGVtIHN1c3BlbmQgKHRv IGlkbGUsIG1lbW9yeSwgZGlzaykgY3ljbGUgb3B0aW9uYWxseQo+IC0gKiBjb21wbGV0aW5nIHRo ZSBjeWNsZSBhdCBhIGdpdmVuIHRlc3QgcG9pbnQgYW5kIGF1dG9tYWljYWxseSB3YWtlIHVwIGFn YWluLgo+IC0gKiBXYWtpbmcgdXAgaXMgZWl0aGVyIGFjaGlldmVkIHVzaW5nIHRoZSBSVEMgd2Fr ZS11cCBhbGFybSBmb3IgYSBmdWxsIHN1c3BlbmQKPiAtICogY3ljbGUgb3IgYSBrZXJuZWwgdGlt ZXIgZm9yIGEgc3VzcGVuZCB0ZXN0IGN5Y2xlLgo+ICsgKiBFeGVjdXRlIGEgc3lzdGVtIHN1c3Bl bmQgY3ljbGUgdGFyZ2V0aW5nIHRoZSBnaXZlbiBAc3RhdGUgb3B0aW9uYWxseQo+ICsgKiBjb21w bGV0aW5nIHRoZSBjeWNsZSBhdCB0aGUgZ2l2ZW4gQHRlc3QgcG9pbnQgYW5kIGF1dG9tYWljYWxs eSB3YWtlIHVwCj4gKyAqIGFnYWluLiBXYWtpbmcgdXAgaXMgZWl0aGVyIGFjaGlldmVkIHVzaW5n IHRoZSBSVEMgd2FrZS11cCBhbGFybSBmb3IgYSBmdWxsCj4gKyAqIHN1c3BlbmQgY3ljbGUgb3Ig YSBrZXJuZWwgdGltZXIgZm9yIGEgc3VzcGVuZCB0ZXN0IGN5Y2xlLiBUaGUga2VybmVsIHRpbWVy Cj4gKyAqIGRlbGF5IGZvciBhIHRlc3QgY3ljbGUgY2FuIGJlIGNvbmZpZ3VyZWQgYnkgdGhlIHN1 c3BlbmQucG1fdGVzdF9kZWxheQo+ICsgKiBrZXJuZWwgcGFyYW1ldGVyICg1IHNlYyBieSBkZWZh dWx0KS4KPiArICoKPiArICogI1NVU1BFTkRfVEVTVF9OT05FIHNwZWNpZmllcyBhIGZ1bGwgc3Vz cGVuZCBjeWNsZS4KPiArICogVGhlICNTVVNQRU5EX1RFU1RfRlJFRVpFUi4uI1NVU1BFTkRfVEVT VF9DT1JFIHRlc3QgcG9pbnRzIGNhbiBtYWtlIGl0Cj4gKyAqIHBvc3NpYmxlIHRvIGNvbGxlY3Qg ZXJyb3IgbG9ncyBpbiBjYXNlIGEgZnVsbCBzdXNwZW5kIGN5Y2xlIHdvdWxkIHByZXZlbnQKPiAr ICogdGhpcyBieSBoYW5naW5nIHRoZSBtYWNoaW5lLCBvciB0aGV5IGNhbiBwcm92aWRlIGFuIGlk ZWEgb2YgdGhlIGZhdWx0eQo+ICsgKiBjb21wb25lbnQgYnkgY29tcGFyaW5nIGZhaWwvbm8tZmFp bCByZXN1bHRzIGF0IGRpZmZlcmVudCB0ZXN0IHBvaW50cy4KPiAgICoKPiAgICogVGhpcyBpcyB2 ZXJ5IGhhbmR5IGZvciBpbXBsZW1lbnRpbmcgYW55IGtpbmQgb2Ygc3VzcGVuZC9yZXN1bWUgdGVz dC4KPiAgICovCj4gZGlmZiAtLWdpdCBhL2xpYi9pZ3RfYXV4LmggYi9saWIvaWd0X2F1eC5oCj4g aW5kZXggMzlmZDhlYS4uZDMwMTk2YiAxMDA2NDQKPiAtLS0gYS9saWIvaWd0X2F1eC5oCj4gKysr IGIvbGliL2lndF9hdXguaAo+IEBAIC0xMTYsMTUgKzExNiw0OCBAQCB2b2lkIGlndF9jbGVhbnVw X2FwZXJ0dXJlX3RyYXNoZXJzKHZvaWQpOwo+ICAKPiAgLyogc3VzcGVuZC9oaWJlcm5hdGUgYW5k IGF1dG8tcmVzdW1lIHN5c3RlbSAqLwo+ICAKPiArLyoqCj4gKyAqICBpZ3Rfc3VzcGVuZF9zdGF0 ZToKPiArICogIEBTVVNQRU5EX1NUQVRFX0ZSRUVaRTogc3VzcGVuZC10by1pZGxlIHRhcmdldCBz dGF0ZSwgYWthIFMwaXggb3IgZnJlZXplLAo+ICsgKgkJCSAgIGZpcnN0IG5vbi1oaWJlcm5hdGlv biBzdGF0ZQo+ICsgKiAgQFNVU1BFTkRfU1RBVEVfU1RBTkRCWTogc3RhbmRieSB0YXJnZXQgc3Rh dGUsIGFrYSBTMSwgc2Vjb25kCj4gKyAqCQkJICAgIG5vbi1oaWJlcm5hdGlvbiBzdGF0ZQo+ICsg KiAgQFNVU1BFTkRfU1RBVEVfTUVNOiBzdXNwZW5kLXRvLW1lbSB0YXJnZXQgc3RhdGUgYWthIFMz LCB0aGlyZAo+ICsgKgkJCW5vbi1oaWJlcm5hdGlvbiBzdGF0ZQo+ICsgKiAgQFNVU1BFTkRfU1RB VEVfRElTSzogc3VzcGVuZC10by1kaXNrIHRhcmdldCBzdGF0ZSwgYWthIFM0IG9yIGhpYmVybmF0 aW9uCj4gKyAqCj4gKyAqICBUYXJnZXQgc3VzcGVuZCBzdGF0ZXMgdXNlZCB3aXRoIGlndF9zeXN0 ZW1fc3VzcGVuZF9hdXRvcmVzdW1lKCkuCj4gKyAqICBTZWUgL3N5cy9wb3dlci9zdGF0ZSBmb3Ig dGhlIGF2YWlsYWJsZSBzdGF0ZXMgb24gYSBnaXZlbiBtYWNoaW5lLgo+ICsgKi8KPiAgZW51bSBp Z3Rfc3VzcGVuZF9zdGF0ZSB7Cj4gIAlTVVNQRU5EX1NUQVRFX0ZSRUVaRSwKPiAtCVNVU1BFTkRf U1RBVEVfTUVNLAo+ICAJU1VTUEVORF9TVEFURV9TVEFOREJZLAo+ICsJU1VTUEVORF9TVEFURV9N RU0sCj4gIAlTVVNQRU5EX1NUQVRFX0RJU0ssCj4gIAo+ICsJLyo8IHByaXZhdGUgPiovCj4gIAlT VVNQRU5EX1NUQVRFX05VTSwKPiAgfTsKPiAgCj4gKy8qKgo+ICsgKiBpZ3Rfc3VzcGVuZF90ZXN0 Ogo+ICsgKiBAU1VTUEVORF9URVNUX05PTkU6IG5vIHRlc3RpbmcsIHBlcmZvcm0gYSBmdWxsIHN1 c3BlbmQvcmVzdW1lIGN5Y2xlCj4gKyAqIEBTVVNQRU5EX1RFU1RfRlJFRVpFUjogY29tcGxldGUg Y3ljbGUgYWZ0ZXIgZnJlZXppbmcgYWxsIGZyZWV6YWJsZSB0aHJlYWRzCj4gKyAqIEBTVVNQRU5E X1RFU1RfREVWSUNFUzogY29tcGxldGUgY3ljbGUgYWZ0ZXIgdGhlIGFib3ZlIHN0ZXAgYW5kIHN1 c3BlbmRpbmcKPiArICoJCQkgIGRldmljZXMgKGJlZm9yZSBjYWxsaW5nIHRoZSBkcml2ZXJzJyBz dXNwZW5kIGxhdGUgYW5kCj4gKyAqCQkJICBub19pcnEgaG9va3MpLiBQbGF0Zm9ybSBhbmQgc3lz dGVtIGRldmljZXMgYXJlIG5vdAo+ICsgKgkJCSAgc3VzcGVuZGVkIGhlcmUsIHNlZSAjU1VTUEVO RF9URVNUX0NPUkUuCj4gKyAqIEBTVVNQRU5EX1RFU1RfUExBVEZPUk06IGNvbXBsZXRlIGN5Y2xl IGFmdGVyIGFsbCB0aGUgYWJvdmUgc3RlcHMgYW5kIGNhbGxpbmcKPiArICoJCQkgICB0aGUgQUNQ SSBwbGF0Zm9ybSBnbG9iYWwgY29udHJvbCBtZXRob2RzIChhcHBsaWVzCj4gKyAqCQkJICAgb25s eSB3aXRoIC9zeXMvcG93ZXIvZGlzayBzZXQgdG8gcGxhdGZvcm0pCj4gKyAqIEBTVVNQRU5EX1RF U1RfUFJPQ0VTU09SUzogY29tcGxldGUgY3ljbGUgYWZ0ZXIgYWxsIHRoZSBhYm92ZSBzdGVwcyBh bmQKPiArICoJCQkgICAgIGRpc2FibGluZyBub24tYm9vdCBDUFVzCj4gKyAqIEBTVVNQRU5EX1RF U1RfQ09SRTogY29tcGxldGUgY3ljbGUgYWZ0ZXIgYWxsIHRoZSBhYm92ZSBzdGVwcyBhbmQgc3Vz cGVuZGluZwo+ICsgKgkJICAgICAgIHBsYXRmb3JtIGFuZCBzeXN0ZW0gZGV2aWNlcwo+ICsgKgo+ ICsgKiBUZXN0IHBvaW50cyB1c2VkIHdpdGggaWd0X3N5c3RlbV9zdXNwZW5kX2F1dG9yZXN1bWUo KS4gU3BlY2lmaWVzIGlmIGFuZCB3aGVyZQo+ICsgKiB0aGUgc3VzcGVuZCBzZXF1ZW5jZSBpcyB0 byBiZSB0ZXJtaW5hdGVkLgo+ICsgKi8KPiAgZW51bSBpZ3Rfc3VzcGVuZF90ZXN0IHsKPiAgCVNV U1BFTkRfVEVTVF9OT05FLAo+ICAJU1VTUEVORF9URVNUX0ZSRUVaRVIsCj4gQEAgLTEzMyw2ICsx NjYsNyBAQCBlbnVtIGlndF9zdXNwZW5kX3Rlc3Qgewo+ICAJU1VTUEVORF9URVNUX1BST0NFU1NP UlMsCj4gIAlTVVNQRU5EX1RFU1RfQ09SRSwKPiAgCj4gKwkvKjwgcHJpdmF0ZSA+Ki8KPiAgCVNV U1BFTkRfVEVTVF9OVU0sCj4gIH07Cj4gIAo+IC0tIAo+IDIuNS4wCj4gCgotLSAKRGFuaWVsIFZl dHRlcgpTb2Z0d2FyZSBFbmdpbmVlciwgSW50ZWwgQ29ycG9yYXRpb24KaHR0cDovL2Jsb2cuZmZ3 bGwuY2gKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KSW50 ZWwtZ2Z4IG1haWxpbmcgbGlzdApJbnRlbC1nZnhAbGlzdHMuZnJlZWRlc2t0b3Aub3JnCmh0dHBz Oi8vbGlzdHMuZnJlZWRlc2t0b3Aub3JnL21haWxtYW4vbGlzdGluZm8vaW50ZWwtZ2Z4Cg==