From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <igt-dev-bounces@lists.freedesktop.org>
Received: from mga07.intel.com (mga07.intel.com [134.134.136.100])
 by gabe.freedesktop.org (Postfix) with ESMTPS id 89D1F89E5A
 for <igt-dev@lists.freedesktop.org>; Thu, 23 May 2019 12:27:39 +0000 (UTC)
From: Petri Latvala <petri.latvala@intel.com>
Date: Thu, 23 May 2019 15:26:53 +0300
Message-Id: <20190523122727.6932-2-petri.latvala@intel.com>
In-Reply-To: <20190523122727.6932-1-petri.latvala@intel.com>
References: <20190523122727.6932-1-petri.latvala@intel.com>
MIME-Version: 1.0
Subject: [igt-dev] [PATCH i-g-t 02/36] lib: Document igt_opt_handler_t
 semantics
List-Unsubscribe: <https://lists.freedesktop.org/mailman/options/igt-dev>,
 <mailto:igt-dev-request@lists.freedesktop.org?subject=unsubscribe>
List-Archive: <https://lists.freedesktop.org/archives/igt-dev>
List-Post: <mailto:igt-dev@lists.freedesktop.org>
List-Help: <mailto:igt-dev-request@lists.freedesktop.org?subject=help>
List-Subscribe: <https://lists.freedesktop.org/mailman/listinfo/igt-dev>,
 <mailto:igt-dev-request@lists.freedesktop.org?subject=subscribe>
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
Errors-To: igt-dev-bounces@lists.freedesktop.org
Sender: "igt-dev" <igt-dev-bounces@lists.freedesktop.org>
To: igt-dev@lists.freedesktop.org
Cc: Petri Latvala <petri.latvala@intel.com>
List-ID: <igt-dev@lists.freedesktop.org>

QmVzdCBwcmFjdGljZXMgZm9yIHRoZSBoZWxwIHN0cmluZyBmb3JtYXR0aW5nLCBhbG9uZyB3aXRo
IGV4cGxpY2l0CnN5bWJvbHMgZm9yIHRoZSBwb3NzaWJsZSByZXR1cm4gdmFsdWVzIGZvciB0aGUg
Y2FsbGJhY2suCgpBbHNvIGRvY3VtZW50ZWQ6IERvIG5vdCBjYWxsIHRoZSBfcGFyc2Vfb3B0cyBm
dW5jdGlvbnMgeW91cnNlbGYsIHVzZQppZ3RfbWFpbl9hcmdzIG9yIGlndF9zaW1wbGVfbWFpbl9h
cmdzLgoKU2lnbmVkLW9mZi1ieTogUGV0cmkgTGF0dmFsYSA8cGV0cmkubGF0dmFsYUBpbnRlbC5j
b20+Ci0tLQogbGliL2lndF9jb3JlLmMgfCAzMSArKysrKysrKysrKysrKysrKysrKysrKysrKysr
LS0tCiBsaWIvaWd0X2NvcmUuaCB8ICAyICsrCiAyIGZpbGVzIGNoYW5nZWQsIDMwIGluc2VydGlv
bnMoKyksIDMgZGVsZXRpb25zKC0pCgpkaWZmIC0tZ2l0IGEvbGliL2lndF9jb3JlLmMgYi9saWIv
aWd0X2NvcmUuYwppbmRleCA5ZWYxOGViMS4uOWM4NmQ2NjQgMTAwNjQ0Ci0tLSBhL2xpYi9pZ3Rf
Y29yZS5jCisrKyBiL2xpYi9pZ3RfY29yZS5jCkBAIC04NTcsOCArODU3LDE4IEBAIG91dDoKICAq
IGFkZGl0aW9uYWwga25vYnMgdG8gdHVuZSB3aGVuIHJ1biBtYW51YWxseSBsaWtlIHRoZSBudW1i
ZXIgb2Ygcm91bmRzIGV4ZWN1dGUKICAqIG9yIHRoZSBzaXplIG9mIHRoZSBhbGxvY2F0ZWQgYnVm
ZmVyIG9iamVjdHMuCiAgKgotICogVGVzdHMgd2l0aG91dCBzcGVjaWFsIG5lZWRzIHNob3VsZCBq
dXN0IHVzZSBpZ3Rfc3VidGVzdF9pbml0KCkgb3IgdXNlCi0gKiAjaWd0X21haW4gZGlyZWN0bHkg
aW5zdGVhZCBvZiB0aGVpciBvd24gbWFpbigpIGZ1bmN0aW9uLgorICogVGVzdHMgc2hvdWxkIHVz
ZSAjaWd0X21haW5fYXJncyBpbnN0ZWFkIG9mIHRoZWlyIG93biBtYWluKCkKKyAqIGZ1bmN0aW9u
IGFuZCBjYWxsaW5nIHRoaXMgZnVuY3Rpb24uCisgKgorICogVGhlIEBoZWxwX3N0ciBwYXJhbWV0
ZXIgaXMgcHJpbnRlZCBkaXJlY3RseSBhZnRlciB0aGUgaGVscCB0ZXh0IG9mCisgKiBzdGFuZGFy
ZCBhcmd1bWVudHMuIFRoZSBmb3JtYXR0aW5nIG9mIHRoZSBzdHJpbmcgc2hvdWxkIGJlOgorICog
LSBPbmUgbGluZSBwZXIgb3B0aW9uCisgKiAtIFR3byBzcGFjZXMsIG9wdGlvbiBmbGFnLCB0YWIg
Y2hhcmFjdGVyLCBoZWxwIHRleHQsIG5ld2xpbmUgY2hhcmFjdGVyCisgKgorICogRXhhbXBsZTog
IiAgLXNcdEJ1ZmZlciBzaXplXG4iCisgKgorICogVGhlIG9wdCBoYW5kbGVyIGZ1bmN0aW9uIG11
c3QgcmV0dXJuICNJR1RfT1BUX0hBTkRMRVJfU1VDQ0VTUyBvbgorICogc3VjY2Vzc2Z1bCBoYW5k
bGluZywgI0lHVF9PUFRfSEFORExFUl9FUlJPUiBvbiBlcnJvcnMuCiAgKgogICogUmV0dXJuczog
Rm9yd2FyZHMgYW55IG9wdGlvbiBwYXJzaW5nIGVycm9ycyBmcm9tIGdldG9wdF9sb25nLgogICov
CkBAIC04OTEsNyArOTAxLDIyIEBAIGVudW0gaWd0X2xvZ19sZXZlbCBpZ3RfbG9nX2xldmVsID0g
SUdUX0xPR19JTkZPOwogICogQGhhbmRsZXJfZGF0YTogdXNlciBkYXRhIGdpdmVuIHRvIEBleHRy
YV9vcHRfaGFuZGxlciB3aGVuIGludm9rZWQKICAqCiAgKiBUaGlzIGluaXRpYWxpemVzIGEgc2lt
cGxlIHRlc3Qgd2l0aG91dCBhbnkgc3VwcG9ydCBmb3Igc3VidGVzdHMgYW5kIGFsbG93cwotICog
YW4gYXJiaXRyYXJ5IHNldCBvZiBhZGRpdGlvbmFsIG9wdGlvbnMuCisgKiBhbiBhcmJpdHJhcnkg
c2V0IG9mIGFkZGl0aW9uYWwgb3B0aW9ucy4gVGhpcyBpcyB1c2VmdWwgZm9yIHRlc3RzIHdoaWNo
IGhhdmUKKyAqIGFkZGl0aW9uYWwga25vYnMgdG8gdHVuZSB3aGVuIHJ1biBtYW51YWxseSBsaWtl
IHRoZSBudW1iZXIgb2Ygcm91bmRzIGV4ZWN1dGUKKyAqIG9yIHRoZSBzaXplIG9mIHRoZSBhbGxv
Y2F0ZWQgYnVmZmVyIG9iamVjdHMuCisgKgorICogVGVzdHMgc2hvdWxkIHVzZSAjaWd0X3NpbXBs
ZV9tYWluX2FyZ3MgaW5zdGVhZCBvZiB0aGVpciBvd24gbWFpbigpCisgKiBmdW5jdGlvbiBhbmQg
Y2FsbGluZyB0aGlzIGZ1bmN0aW9uLgorICoKKyAqIFRoZSBAaGVscF9zdHIgcGFyYW1ldGVyIGlz
IHByaW50ZWQgZGlyZWN0bHkgYWZ0ZXIgdGhlIGhlbHAgdGV4dCBvZgorICogc3RhbmRhcmQgYXJn
dW1lbnRzLiBUaGUgZm9ybWF0dGluZyBvZiB0aGUgc3RyaW5nIHNob3VsZCBiZToKKyAqIC0gT25l
IGxpbmUgcGVyIG9wdGlvbgorICogLSBUd28gc3BhY2VzLCBvcHRpb24gZmxhZywgdGFiIGNoYXJh
Y3RlciwgaGVscCB0ZXh0LCBuZXdsaW5lIGNoYXJhY3RlcgorICoKKyAqIEV4YW1wbGU6ICIgIC1z
XHRCdWZmZXIgc2l6ZVxuIgorICoKKyAqIFRoZSBvcHQgaGFuZGxlciBmdW5jdGlvbiBtdXN0IHJl
dHVybiAjSUdUX09QVF9IQU5ETEVSX1NVQ0NFU1Mgb24KKyAqIHN1Y2Nlc3NmdWwgaGFuZGxpbmcs
ICNJR1RfT1BUX0hBTkRMRVJfRVJST1Igb24gZXJyb3JzLgogICovCiB2b2lkIGlndF9zaW1wbGVf
aW5pdF9wYXJzZV9vcHRzKGludCAqYXJnYywgY2hhciAqKmFyZ3YsCiAJCQkJY29uc3QgY2hhciAq
ZXh0cmFfc2hvcnRfb3B0cywKZGlmZiAtLWdpdCBhL2xpYi9pZ3RfY29yZS5oIGIvbGliL2lndF9j
b3JlLmgKaW5kZXggY2Q4OTkyMWUuLjg4YTk1ZWMyIDEwMDY0NAotLS0gYS9saWIvaWd0X2NvcmUu
aAorKysgYi9saWIvaWd0X2NvcmUuaApAQCAtMTQ1LDYgKzE0NSw4IEBAIHZvaWQgX19pZ3RfZml4
dHVyZV9lbmQodm9pZCkgX19hdHRyaWJ1dGVfXygobm9yZXR1cm4pKTsKIC8qIHN1YnRlc3QgaW5m
cmFzdHJ1Y3R1cmUgKi8KIGptcF9idWYgaWd0X3N1YnRlc3Rfam1wYnVmOwogdHlwZWRlZiBpbnQg
KCppZ3Rfb3B0X2hhbmRsZXJfdCkoaW50IG9wdCwgaW50IG9wdF9pbmRleCwgdm9pZCAqZGF0YSk7
CisjZGVmaW5lIElHVF9PUFRfSEFORExFUl9TVUNDRVNTIDAKKyNkZWZpbmUgSUdUX09QVF9IQU5E
TEVSX0VSUk9SIC0yCiAjaWZuZGVmIF9fR1RLX0RPQ19JR05PUkVfXyAvKiBndGtkb2Mgd2FudHMg
dG8gZG9jdW1lbnQgdGhpcyBmb3J3YXJkIGRlY2wgKi8KIHN0cnVjdCBvcHRpb247CiAjZW5kaWYK
LS0gCjIuMTkuMQoKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f
X18KaWd0LWRldiBtYWlsaW5nIGxpc3QKaWd0LWRldkBsaXN0cy5mcmVlZGVza3RvcC5vcmcKaHR0
cHM6Ly9saXN0cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9pZ3QtZGV2