Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
Message-ID: <66110ee1-9358-b337-9481-d9fcdb5a4c00@amd.com>
Date:   Tue, 12 Jul 2022 17:54:23 +0200
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101
 Thunderbird/91.9.1
Subject: Re: [RFC][PATCH 1/3] drm: drm_syncobj: Add note in DOC about absolute
 timeout values
Content-Language: en-US
To:     John Stultz <jstultz@google.com>
Cc:     LKML <linux-kernel@vger.kernel.org>,
        Maarten Lankhorst <maarten.lankhorst@linux.intel.com>,
        Maxime Ripard <mripard@kernel.org>,
        Thomas Zimmermann <tzimmermann@suse.de>,
        Jason Ekstrand <jason@jlekstrand.net>,
        Lionel Landwerlin <lionel.g.landwerlin@intel.com>,
        Chunming Zhou <david1.zhou@amd.com>,
        David Airlie <airlied@linux.ie>,
        Daniel Vetter <daniel@ffwll.ch>,
        dri-devel@lists.freedesktop.org
References: <20220712042258.293010-1-jstultz@google.com>
 <13c5ca05-a366-2751-4f26-d978d074f748@amd.com>
 <CANDhNCp_d2M+n90T1ziP5rHF85ZsxyN6qg4iE84ucPO-XK_HUg@mail.gmail.com>
From:   =?UTF-8?Q?Christian_K=c3=b6nig?= <christian.koenig@amd.com>
In-Reply-To: <CANDhNCp_d2M+n90T1ziP5rHF85ZsxyN6qg4iE84ucPO-XK_HUg@mail.gmail.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?T2dEeWlCL0FRMjhjcS8vOGF3MEZ3TlRTOUNlSlBGaGs0YUxjWjhDQnBUUDBB?=
 =?utf-8?B?WFQzMzNrMTJhK29NRFFMTU1nWjA4TVB2bnJ1R0xZYXVQTi95Znh4YjA2R1Jz?=
 =?utf-8?B?TUpuYlEreWpMTjlEYUxLR0RiSzBaNlRWUHlUd1NqMjRnQ3ZRVlhzMnBGN3FN?=
 =?utf-8?B?cGx0ck9RTFZLS2l6aUppZW5sTUw1LzA1QURydlo5dVJ1OHlpV0ZxL3l2UGR1?=
 =?utf-8?B?QldwTlRKOU9Gd3FZNm5OL0grRXRFZ3lxQSs4ZTdVYjFUeDl1NnlRK0JNNDcv?=
 =?utf-8?B?alduOEVHVHdEMmgxSUtSd3hRL1ZVUmI5N3pqOVNkODFVU2RKWHUyVlpCUUpL?=
 =?utf-8?B?TUJpQlN1YVFPcERoajkyZHptc2NzNVlkYXRNazlSVmJpY3ZZejNjQkxCVHhm?=
 =?utf-8?B?RkY2czBKYS9LUmloQzdaV0RHajlrZ3V5QzllTThZbXhybDlFc1BWU1pIVXJM?=
 =?utf-8?B?V2ZxY3QyWS9wMjlDcGR1OHFxKzBYN0FFVEI3Z2hLemp6YlNZMTdadTJrUVY4?=
 =?utf-8?B?ZlJJRWNERlFRTTFPcmxTRnplL3B2ZjlDc3lFMG1lKzY2TkhTMWNuNDNkZlVm?=
 =?utf-8?B?TTRUWlNKcG5JdWR4bHR2WmlCUXVyenpBVllXNjRVTkg4N2FyVWsyKzhuOEow?=
 =?utf-8?B?WXpXMU5ZK0NtRk9GUE5GN1VmWmtxQk5nS2dIMFRjMHFzdENqaXYwSTlpTzVU?=
 =?utf-8?B?c0tFcmpDZlZ2ck5jUnRaQnd0czRpMmtteW0rK2FYU2tJZ3lCeDRveHh2WVZ6?=
 =?utf-8?B?NzRQTEVwUktRMzB2Y2hQWkhvYVkvSFoxSjJaeGNyUlFKMjJhakVYRFY0ZlJZ?=
 =?utf-8?B?V09sOERyVithNnFsMUdPNThHZUFEbEV0WWYwM3lhRm1OWThwTzdiNnVyNGpT?=
 =?utf-8?B?czNNSSsrMC9WblBmM3YwdEU4K1RUSmtUcEE2TkNXREdWS1hpbWJRT3RKd3dh?=
 =?utf-8?B?S2thTTZFTlVLUHpNQVgwNlRaU1V1VnhQQmNsbFI1eHNDcDU0N1ppVUtqVEVs?=
 =?utf-8?B?VGIrRmIvbVhpMEd1dTlYRHIvZXhOcGx2OXRRbWx1R3RpeGhxSEF3RFB5QjBp?=
 =?utf-8?B?bkpHV1pBZUV2L3kxTlRSTTdhVUJFU0dxNXZjWWxqbExhOXN3NmZEak96cTBB?=
 =?utf-8?B?c1dURFpGcGhnRUNvY2lTYklZa0RNV2hQRU9jQTZnUloyZEMxK1EwSWhrSk15?=
 =?utf-8?B?RFAvN2QrWjVxdXRmZEFob2tocWxNQjUzNEJ4UHl6Y1VRMGQ4V2JQQWRrbFI1?=
 =?utf-8?B?UmtuNTJ2OWNTdHdxa2QrcktpSVVrZ29JTDZTSGhRMlE4RnFRSTVJRHl5MjVk?=
 =?utf-8?B?Qk8vQjhSU2dVU244WEpOa05sbUdzRzZlRXNDRlFoOFBrbFdCb0tZNEh5R2ZK?=
 =?utf-8?B?eHQ5RG9vaVdXcWVIbzE5dklpU2tEVCtPZENBbXZxNmhMT3VUazIrUWJOdG9a?=
 =?utf-8?B?RjJuLzRHU0VFS0JnRzNSSFdWVnZpeEFvUTJtVVQxNkp6UVg4L29HZzJOR2xO?=
 =?utf-8?B?SjRORlJ4REZDRWxqQm9uNnFWTGRIZXJDZlhydmlvQUhnS25PbUZTbzJBQ2hX?=
 =?utf-8?B?NDYvQWRFOWIyc3RRd2I2TDA5ZWtLNlVnd0l6c1BjdWtCaW9GWmpJSmNscFN2?=
 =?utf-8?B?NGVlNnFDZUR6S0RrMmFKNWI2SnhuZStGVERGNThmc2VGSmpBSm9UQjVMb21T?=
 =?utf-8?B?MWcvb1QxanlWVHFXOUFaejhCYUVUNDVBbDMwaURVUCswM0pUbzhNNlhGSGFG?=
 =?utf-8?B?cWZpeHVnNStVTkdBeWxqTkJDMnRScGZ2SjNiMUVSSFRWQVdMeFYyRlFwMjVn?=
 =?utf-8?B?aE1ES3o3QUpjRmxwSU9BcHdDTUN0MFhIeEhBT0dJQzBpSENGWGRGbjFyd3ZX?=
 =?utf-8?B?dkJER1BjRFgvSExVR0RJSCtjRXlrVU5VYm5xQnEwY05ZZFNzNHU2RTUwak5h?=
 =?utf-8?B?VEQwMENoeklXVlN3VVRzamZGWVJRUDJyV0JEOE12ZUcvMEEzYUNqRkhTSWZO?=
 =?utf-8?B?N1E2TVlSYTREYkhjSWM5U0lGcDdHang0QUc2TG5vR3kyNzhoSC9vOTRXcDNv?=
 =?utf-8?B?RFFETGF5SHhoamdzOTNJSlNDVzZ0My9OZk1Kd2c0NkVEMmYrdFZpWmM2d0pM?=
 =?utf-8?B?RGhuU01OZDJqNmFORVhJdkVXb1pmMXZFMG9Ka1dLdmlTRTJ2amQ2RTZRQ2Fa?=
 =?utf-8?Q?BIhwHm/liqaR1TaRKzOr8p1i6zJPZVC0VEqek7danJBJ?=
X-OriginatorOrg: amd.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 903cff3c-f5ba-4097-8acb-08da641ece47
X-MS-Exchange-CrossTenant-AuthSource: BN8PR12MB3587.namprd12.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 12 Jul 2022 15:54:29.9875
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: ggibJ/y79JM7d7GPBehTrvGGW4nLC7P7RO6jSMhdCOHQiLqHgVX5gnLJbIEzi1tf
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM5PR12MB1244
X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,
        DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,NICE_REPLY_A,RCVD_IN_DNSWL_NONE,
        RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS,T_SCC_BODY_TEXT_LINE
        autolearn=ham autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

Am 12.07.22 um 17:48 schrieb John Stultz:
> On Tue, Jul 12, 2022 at 12:40 AM Christian König
> <christian.koenig@amd.com> wrote:
>> Am 12.07.22 um 06:22 schrieb John Stultz:
>>> After having to debug down through the kernel to figure out
>>> why my _WAIT calls were always timing out, I realized its
>>> an absolute timeout value instead of the more common relative
>>> timeouts.
>>>
>>> This detail should be called out in the documentation, as while
>>> the absolute value makes sense here, its not as common for timeout
>>> values.
>> Well absolute timeout values are mandatory for making -ERESTARTSYS work
>> without any additional handling.
> Yes! I'm not saying it's wrong to use absolute values, just that
> relative values are common enough to create some confusion here.
>
>> So using them is recommended for ~20 years now and IIRC even documented
>> somewhere.
> So in addition to "somewhere", why not in the interface documentation as well?

Because it's the desired default behavior and we shouldn't have to 
document that on every instance it is used.

IIRC it's documented centralized (but I need to dig that up as well).

What we should do instead is to have a warning on every relative timeout 
that this probably shouldn't be used as example.

Regards,+
Christian.

>
>> See here as well https://nam11.safelinks.protection.outlook.com/?url=https%3A%2F%2Flwn.net%2FArticles%2F17744%2F&amp;data=05%7C01%7Cchristian.koenig%40amd.com%7C68a13ac3906d4ac4cc4308da641df25c%7C3dd8961fe4884e608e11a82d994e183d%7C0%7C0%7C637932377042931797%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&amp;sdata=dM4BkqnO0LrsdKBwKKMvx4zMabWrM%2FY7pPGDsdFO%2BnI%3D&amp;reserved=0 how much trouble system
>> calls with relative timeouts are.
> Yep. Well aware. :)
>
> thanks
> -john