From mboxrd@z Thu Jan 1 00:00:00 1970 From: Daniel Vetter Subject: [PATCH i-g-t 09/17] lib/ioctl: Document ctx param functions Date: Tue, 10 Feb 2015 19:05:52 +0100 Message-ID: <1423591560-9471-9-git-send-email-daniel.vetter@ffwll.ch> References: <1423591560-9471-1-git-send-email-daniel.vetter@ffwll.ch> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail-wg0-f49.google.com (mail-wg0-f49.google.com [74.125.82.49]) by gabe.freedesktop.org (Postfix) with ESMTP id DDAE96E6A8 for ; Tue, 10 Feb 2015 10:04:52 -0800 (PST) Received: by mail-wg0-f49.google.com with SMTP id l18so2185842wgh.8 for ; Tue, 10 Feb 2015 10:04:52 -0800 (PST) In-Reply-To: <1423591560-9471-1-git-send-email-daniel.vetter@ffwll.ch> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" To: Intel Graphics Development Cc: Daniel Vetter , Daniel Vetter List-Id: intel-gfx@lists.freedesktop.org QW5kIG1vdmUgdGhlbSBzbyB0aGF0IHRoZXkncmUgZ3JvdXBlZCB3aXRoIHRoZSBvdGhlciBjb250 ZXh0IHdyYXBwZXJzLgoKU2lnbmVkLW9mZi1ieTogRGFuaWVsIFZldHRlciA8ZGFuaWVsLnZldHRl ckBpbnRlbC5jb20+Ci0tLQogbGliL2lvY3RsX3dyYXBwZXJzLmMgfCA3OSArKysrKysrKysrKysr KysrKysrKysrKysrKysrKysrKysrKy0tLS0tLS0tLS0tLS0tLS0tCiBsaWIvaW9jdGxfd3JhcHBl cnMuaCB8IDIyICsrKysrKystLS0tLS0tLQogMiBmaWxlcyBjaGFuZ2VkLCA2MyBpbnNlcnRpb25z KCspLCAzOCBkZWxldGlvbnMoLSkKCmRpZmYgLS1naXQgYS9saWIvaW9jdGxfd3JhcHBlcnMuYyBi L2xpYi9pb2N0bF93cmFwcGVycy5jCmluZGV4IGU4NmIzYzJiZmE0Ni4uMjg4YWI4ZDdlMGUyIDEw MDY0NAotLS0gYS9saWIvaW9jdGxfd3JhcHBlcnMuYworKysgYi9saWIvaW9jdGxfd3JhcHBlcnMu YwpAQCAtNjYzLDYgKzY2Myw1OSBAQCB2b2lkIGdlbV9jb250ZXh0X2Rlc3Ryb3koaW50IGZkLCB1 aW50MzJfdCBjdHhfaWQpCiB9CiAKIC8qKgorICogZ2VtX2NvbnRleHRfZ2V0X3BhcmFtOgorICog QGZkOiBvcGVuIGk5MTUgZHJtIGZpbGUgZGVzY3JpcHRvcgorICogQHA6IGk5MTUgaHcgY29udGV4 dCBwYXJhbWV0ZXIKKyAqCisgKiBUaGlzIGlzIGEgd3JhcHMgdGhlIENPTlRFWFRfR0VUX1BBUkFN IGlvY3RsLCB3aGljaCBpcyB1c2VkIHRvIGZyZWUgYSBoYXJkd2FyZQorICogY29udGV4dC4gTm90 IHRoYXQgc2ltaWxhcmx5IHRvIGdlbV9zZXRfY2FjaGluZygpIHRoaXMgd3JhcHBlciBjYWxscwor ICogaWd0X3JlcXVpcmUoKSBpbnRlcm5hbGx5IHRvIGNvcnJlY3RseSBza2lwIG9uIGtlcm5lbHMg YW5kIHBsYXRmb3JtcyB3aGVyZSBodworICogY29udGV4dCBwYXJhbWV0ZXIgc3VwcG9ydCBpcyBu b3QgYXZhaWxhYmxlLgorICovCit2b2lkIGdlbV9jb250ZXh0X2dldF9wYXJhbShpbnQgZmQsIHN0 cnVjdCBsb2NhbF9pOTE1X2dlbV9jb250ZXh0X3BhcmFtICpwKQoreworI2RlZmluZSBMT0NBTF9J OTE1X0dFTV9DT05URVhUX0dFVFBBUkFNICAgICAgIDB4MzQKKyNkZWZpbmUgTE9DQUxfSU9DVExf STkxNV9HRU1fQ09OVEVYVF9HRVRQQVJBTSBEUk1fSU9XUiAoRFJNX0NPTU1BTkRfQkFTRSArIExP Q0FMX0k5MTVfR0VNX0NPTlRFWFRfR0VUUEFSQU0sIHN0cnVjdCBsb2NhbF9pOTE1X2dlbV9jb250 ZXh0X3BhcmFtKQorCWRvX2lvY3RsKGZkLCBMT0NBTF9JT0NUTF9JOTE1X0dFTV9DT05URVhUX0dF VFBBUkFNLCBwKTsKK30KKworLyoqCisgKiBnZW1fY29udGV4dF9zZXRfcGFyYW06CisgKiBAZmQ6 IG9wZW4gaTkxNSBkcm0gZmlsZSBkZXNjcmlwdG9yCisgKiBAcDogaTkxNSBodyBjb250ZXh0IHBh cmFtZXRlcgorICoKKyAqIFRoaXMgaXMgYSB3cmFwcyB0aGUgQ09OVEVYVF9TRVRfUEFSQU0gaW9j dGwsIHdoaWNoIGlzIHVzZWQgdG8gZnJlZSBhIGhhcmR3YXJlCisgKiBjb250ZXh0LiBOb3QgdGhh dCBzaW1pbGFybHkgdG8gZ2VtX3NldF9jYWNoaW5nKCkgdGhpcyB3cmFwcGVyIGNhbGxzCisgKiBp Z3RfcmVxdWlyZSgpIGludGVybmFsbHkgdG8gY29ycmVjdGx5IHNraXAgb24ga2VybmVscyBhbmQg cGxhdGZvcm1zIHdoZXJlIGh3CisgKiBjb250ZXh0IHBhcmFtZXRlciBzdXBwb3J0IGlzIG5vdCBh dmFpbGFibGUuCisgKi8KK3ZvaWQgZ2VtX2NvbnRleHRfc2V0X3BhcmFtKGludCBmZCwgc3RydWN0 IGxvY2FsX2k5MTVfZ2VtX2NvbnRleHRfcGFyYW0gKnApCit7CisjZGVmaW5lIExPQ0FMX0k5MTVf R0VNX0NPTlRFWFRfU0VUUEFSQU0gICAgICAgMHgzNQorI2RlZmluZSBMT0NBTF9JT0NUTF9JOTE1 X0dFTV9DT05URVhUX1NFVFBBUkFNIERSTV9JT1dSIChEUk1fQ09NTUFORF9CQVNFICsgTE9DQUxf STkxNV9HRU1fQ09OVEVYVF9TRVRQQVJBTSwgc3RydWN0IGxvY2FsX2k5MTVfZ2VtX2NvbnRleHRf cGFyYW0pCisJZG9faW9jdGwoZmQsIExPQ0FMX0lPQ1RMX0k5MTVfR0VNX0NPTlRFWFRfU0VUUEFS QU0sIHApOworfQorCisvKioKKyAqIGdlbV9yZXF1aXJlX2NhY2hpbmc6CisgKiBAZmQ6IG9wZW4g aTkxNSBkcm0gZmlsZSBkZXNjcmlwdG9yCisgKgorICogRmVhdHVyZSB0ZXN0IG1hY3JvIHRvIHF1 ZXJ5IHdoZXRoZXIgaHcgY29udGV4dCBwYXJhbWV0ZXIgc3VwcG9ydCBmb3IgQHBhcmFtCisgKiBp cyBhdmFpbGFibGUuIEF1dG9tYXRpY2FsbHkgc2tpcHMgdGhyb3VnaCBpZ3RfcmVxdWlyZSgpIGlm IG5vdC4KKyAqLwordm9pZCBnZW1fY29udGV4dF9yZXF1aXJlX3BhcmFtKGludCBmZCwgdWludDY0 X3QgcGFyYW0pCit7CisJc3RydWN0IGxvY2FsX2k5MTVfZ2VtX2NvbnRleHRfcGFyYW0gcDsKKwor CXAuY29udGV4dCA9IDA7CisJcC5wYXJhbSA9IHBhcmFtOworCXAudmFsdWUgPSAwOworCXAuc2l6 ZSA9IDA7CisKKwlpZ3RfcmVxdWlyZShkcm1Jb2N0bChmZCwgTE9DQUxfSU9DVExfSTkxNV9HRU1f Q09OVEVYVF9HRVRQQVJBTSwgJnApID09IDApOworfQorCisvKioKICAqIGdlbV9zd19maW5pc2g6 CiAgKiBAZmQ6IG9wZW4gaTkxNSBkcm0gZmlsZSBkZXNjcmlwdG9yCiAgKiBAaGFuZGxlOiBnZW0g YnVmZmVyIG9iamVjdCBoYW5kbGUKQEAgLTEwODksMjkgKzExNDIsMyBAQCBvZmZfdCBwcmltZV9n ZXRfc2l6ZShpbnQgZG1hX2J1Zl9mZCkKIAogCXJldHVybiByZXQ7CiB9Ci0KLXZvaWQgZ2VtX2Nv bnRleHRfZ2V0X3BhcmFtKGludCBmZCwgc3RydWN0IGxvY2FsX2k5MTVfZ2VtX2NvbnRleHRfcGFy YW0gKnApCi17Ci0jZGVmaW5lIExPQ0FMX0k5MTVfR0VNX0NPTlRFWFRfR0VUUEFSQU0gICAgICAg MHgzNAotI2RlZmluZSBMT0NBTF9JT0NUTF9JOTE1X0dFTV9DT05URVhUX0dFVFBBUkFNIERSTV9J T1dSIChEUk1fQ09NTUFORF9CQVNFICsgTE9DQUxfSTkxNV9HRU1fQ09OVEVYVF9HRVRQQVJBTSwg c3RydWN0IGxvY2FsX2k5MTVfZ2VtX2NvbnRleHRfcGFyYW0pCi0JZG9faW9jdGwoZmQsIExPQ0FM X0lPQ1RMX0k5MTVfR0VNX0NPTlRFWFRfR0VUUEFSQU0sIHApOwotfQotCi12b2lkIGdlbV9jb250 ZXh0X3NldF9wYXJhbShpbnQgZmQsIHN0cnVjdCBsb2NhbF9pOTE1X2dlbV9jb250ZXh0X3BhcmFt ICpwKQotewotI2RlZmluZSBMT0NBTF9JOTE1X0dFTV9DT05URVhUX1NFVFBBUkFNICAgICAgIDB4 MzUKLSNkZWZpbmUgTE9DQUxfSU9DVExfSTkxNV9HRU1fQ09OVEVYVF9TRVRQQVJBTSBEUk1fSU9X UiAoRFJNX0NPTU1BTkRfQkFTRSArIExPQ0FMX0k5MTVfR0VNX0NPTlRFWFRfU0VUUEFSQU0sIHN0 cnVjdCBsb2NhbF9pOTE1X2dlbV9jb250ZXh0X3BhcmFtKQotCWRvX2lvY3RsKGZkLCBMT0NBTF9J T0NUTF9JOTE1X0dFTV9DT05URVhUX1NFVFBBUkFNLCBwKTsKLX0KLQotdm9pZCBnZW1fY29udGV4 dF9yZXF1aXJlX3BhcmFtKGludCBmZCwgdWludDY0X3QgcGFyYW0pCi17Ci0Jc3RydWN0IGxvY2Fs X2k5MTVfZ2VtX2NvbnRleHRfcGFyYW0gcDsKLQotCXAuY29udGV4dCA9IDA7Ci0JcC5wYXJhbSA9 IHBhcmFtOwotCXAudmFsdWUgPSAwOwotCXAuc2l6ZSA9IDA7Ci0KLQlpZ3RfcmVxdWlyZShkcm1J b2N0bChmZCwgTE9DQUxfSTkxNV9HRU1fQ09OVEVYVF9HRVRQQVJBTSwgJnApID09IDApOwotfQpk aWZmIC0tZ2l0IGEvbGliL2lvY3RsX3dyYXBwZXJzLmggYi9saWIvaW9jdGxfd3JhcHBlcnMuaApp bmRleCBhZDEwYmQwM2QzNzAuLmVhOWY1NTk4ZTdlMyAxMDA2NDQKLS0tIGEvbGliL2lvY3RsX3dy YXBwZXJzLmgKKysrIGIvbGliL2lvY3RsX3dyYXBwZXJzLmgKQEAgLTk3LDYgKzk3LDE2IEBAIGlu dCBnZW1fbWFkdmlzZShpbnQgZmQsIHVpbnQzMl90IGhhbmRsZSwgaW50IHN0YXRlKTsKIHVpbnQz Ml90IGdlbV9jb250ZXh0X2NyZWF0ZShpbnQgZmQpOwogdm9pZCBnZW1fY29udGV4dF9kZXN0cm95 KGludCBmZCwgdWludDMyX3QgY3R4X2lkKTsKIGludCBfX2dlbV9jb250ZXh0X2Rlc3Ryb3koaW50 IGZkLCB1aW50MzJfdCBjdHhfaWQpOworc3RydWN0IGxvY2FsX2k5MTVfZ2VtX2NvbnRleHRfcGFy YW0geworCXVpbnQzMl90IGNvbnRleHQ7CisJdWludDMyX3Qgc2l6ZTsKKwl1aW50NjRfdCBwYXJh bTsKKyNkZWZpbmUgTE9DQUxfQ09OVEVYVF9QQVJBTV9CQU5fUEVSSU9EIDB4MQorCXVpbnQ2NF90 IHZhbHVlOworfTsKK3ZvaWQgZ2VtX2NvbnRleHRfcmVxdWlyZV9wYXJhbShpbnQgZmQsIHVpbnQ2 NF90IHBhcmFtKTsKK3ZvaWQgZ2VtX2NvbnRleHRfZ2V0X3BhcmFtKGludCBmZCwgc3RydWN0IGxv Y2FsX2k5MTVfZ2VtX2NvbnRleHRfcGFyYW0gKnApOwordm9pZCBnZW1fY29udGV4dF9zZXRfcGFy YW0oaW50IGZkLCBzdHJ1Y3QgbG9jYWxfaTkxNV9nZW1fY29udGV4dF9wYXJhbSAqcCk7CiAKIHZv aWQgZ2VtX3N3X2ZpbmlzaChpbnQgZmQsIHVpbnQzMl90IGhhbmRsZSk7CiAKQEAgLTEyNSwxNiAr MTM1LDQgQEAgaW50IHByaW1lX2hhbmRsZV90b19mZChpbnQgZmQsIHVpbnQzMl90IGhhbmRsZSk7 CiB1aW50MzJfdCBwcmltZV9mZF90b19oYW5kbGUoaW50IGZkLCBpbnQgZG1hX2J1Zl9mZCk7CiBv ZmZfdCBwcmltZV9nZXRfc2l6ZShpbnQgZG1hX2J1Zl9mZCk7CiAKLXN0cnVjdCBsb2NhbF9pOTE1 X2dlbV9jb250ZXh0X3BhcmFtIHsKLQl1aW50MzJfdCBjb250ZXh0OwotCXVpbnQzMl90IHNpemU7 Ci0JdWludDY0X3QgcGFyYW07Ci0jZGVmaW5lIExPQ0FMX0NPTlRFWFRfUEFSQU1fQkFOX1BFUklP RCAweDEKLQl1aW50NjRfdCB2YWx1ZTsKLX07Ci0KLXZvaWQgZ2VtX2NvbnRleHRfcmVxdWlyZV9w YXJhbShpbnQgZmQsIHVpbnQ2NF90IHBhcmFtKTsKLXZvaWQgZ2VtX2NvbnRleHRfZ2V0X3BhcmFt KGludCBmZCwgc3RydWN0IGxvY2FsX2k5MTVfZ2VtX2NvbnRleHRfcGFyYW0gKnApOwotdm9pZCBn ZW1fY29udGV4dF9zZXRfcGFyYW0oaW50IGZkLCBzdHJ1Y3QgbG9jYWxfaTkxNV9nZW1fY29udGV4 dF9wYXJhbSAqcCk7Ci0KICNlbmRpZiAvKiBJT0NUTF9XUkFQUEVSU19IICovCi0tIAoyLjEuNAoK X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KSW50ZWwtZ2Z4 IG1haWxpbmcgbGlzdApJbnRlbC1nZnhAbGlzdHMuZnJlZWRlc2t0b3Aub3JnCmh0dHA6Ly9saXN0 cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9pbnRlbC1nZngK