From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 2037CC02199 for ; Wed, 29 Jan 2025 20:34:50 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:In-Reply-To:MIME-Version:References: Message-ID:Subject:Cc:To:From:Date:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=NvrPtEnHmzLl8WZixs+64n7GDImVgsVPHwvqg8qG/xM=; b=gRWzPvMj5WzP+o jv9fsyrkD66n9TNQ11/WyHvFIwwF2mU2cIwl6itHlQNOuPydsdLUVn/9hTIBl4IJYDafgVVeNGRKp THYlbvoThgw+x4rUrDSm2Tg3KD0H1pvx12zh2O5KEVKbREyyEgikFX4WVTrZGjja5QYEL3kEnCSIj JqtGJYNw9UcRO+gEiCojO55XhCTVDfEIkKVFKva3XlN04vMsVRqtufVRiNPtoul6/zZDca9zz5GPS r4I5k6pckybYp9DrtCfe4mRqABVZW8bEP/0kQ8DnjErAYP5l+4EPtoJ60O8dPxrqEJ1tel79PL1+i +rgHh7KGKAWfQzbcQGnw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.98 #2 (Red Hat Linux)) id 1tdElt-00000007lOQ-3UhY; Wed, 29 Jan 2025 20:34:49 +0000 Received: from mail-yb1-xb2b.google.com ([2607:f8b0:4864:20::b2b]) by bombadil.infradead.org with esmtps (Exim 4.98 #2 (Red Hat Linux)) id 1tc6iC-00000000Vax-14rx for linux-i3c@lists.infradead.org; Sun, 26 Jan 2025 17:46:21 +0000 Received: by mail-yb1-xb2b.google.com with SMTP id 3f1490d57ef6-e398484b60bso5504497276.1 for ; Sun, 26 Jan 2025 09:46:19 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1737913578; x=1738518378; darn=lists.infradead.org; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:references:message-id:subject:cc:to:from:date:from:to :cc:subject:date:message-id:reply-to; bh=XwP6AmZtHOBgTFWNHWplhL+BYlJ0uLnqNJ1QKPcccSI=; b=iGO0oqiB25jtzBlgMAxzi9KGCCrXcjj4IxzKH3bRqsZY2BCAVxtqB1+HYDlBZoYWzN BV+ZN43Y1XI9jGrhLvUIsGd1ruFvH9+3ysxGPQR59RjK3J7sbBdamKe26MW29YWxAjRK 6UGU/BCSLcXvnp0Bt7UnjwqfpESAMgMgGNEvdRaljHTunOUX+ErtHsYSRsKc6LEszx4P VlJFdzYJ+u8j6G84LCd4ymaKuNx9TX43NVBphwp1q2qKOvpxd5XZFZI6bseRY1Y4iHKq 6IF2mkh3i1nEvaaQv/Dc/q0UUkX6t5G7Fh5Fd7sGDIxOcZq/hBIPENY0oqPXoqMyIRUW s/tA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1737913578; x=1738518378; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:references:message-id:subject:cc:to:from:date :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=XwP6AmZtHOBgTFWNHWplhL+BYlJ0uLnqNJ1QKPcccSI=; b=FmWPaBbbJgxPLo2Jzrfu+HA2FClB8ZOydT5gSf2ifECJuj1g8iDVsYJLj6wXbw1Xs4 S3ECFS6sYJ+qcDMFWRyUp9CCDv0uXFkU4010oFu1N6hbMr6X3XJQQ2oe3HAeUQzAl6k4 g1XvT2bS5dYsduwGqZEZe5QLTl3YHrEnrGcTQ2TfqVpvRl5Do9nY++GP3uzVQck7L5CN HheTsq91J4aCfiwigDm+wnoZ7YCjuo+ygcIh8rTAK1dDdjS7asi9FDP3FB6bTbGoq2Gd BB3jbxZar6UnipRb//AbFil/HETMuo5r6WLVBWvMpf5gx4bpXjk6YOa6bz04R3EE/aM0 DXAQ== X-Forwarded-Encrypted: i=1; AJvYcCVWkZeDv0ehb2HZbcYoraybZ3T1Y8KxQRVWTOWecPRkUEUYHx2P89TJm7iRJQ3/9BTun5d7djW9WRU=@lists.infradead.org X-Gm-Message-State: AOJu0YxMoV9VNSFf0DgpoghbA82oRyDHRGr2451U4+6qBLbtW5tl2iZV CeqPp7T1uMwbF5cHDNrXIUA6wi0GPDtftiOJTit+y8BsIKjUp8V+ X-Gm-Gg: ASbGncseLHhqHXCxsl38uoTXx+ccCAaI/NHxfxZMmYozsznVqtvlvH0BzVN9BVd8V6/ U2bRAdyvw7d5x26jGYs0FxzNSB9RNthMf61rFdws75CtrxUloTpLkz8TZR/a+IoQqvYowDqhsZq bD6e8ZBT8Bfgo4jBVzCUCjLJefPph3dVCKClMyW/8PJEjH8YTcxrcTMfs5ddKWdWpMBbIKNJNzd lhnpun+md2Ak3e7AQJFCPdKNBC0qu5uWodLMVCS0hSoYdkJYBKYuhqFWzm+AZpTuehPfqRVYkdy XMqk4J8OgHZgYZ7DC47LvhpK522/07yDQEUTHKMAUARAJABNotg= X-Google-Smtp-Source: AGHT+IGO1xwVW2l1LTQ+o+lYbUxQvekVO4YA1p5kU65hCGKORVU3e+VmeRoBj3dBeymOr5vl4GWC3Q== X-Received: by 2002:a05:690c:2008:b0:6f7:534b:560a with SMTP id 00721157ae682-6f7534b56aamr70501867b3.8.1737913578433; Sun, 26 Jan 2025 09:46:18 -0800 (PST) Received: from localhost (c-73-224-175-84.hsd1.fl.comcast.net. [73.224.175.84]) by smtp.gmail.com with ESMTPSA id 00721157ae682-6f757a372fbsm11330997b3.117.2025.01.26.09.46.17 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 26 Jan 2025 09:46:17 -0800 (PST) Date: Sun, 26 Jan 2025 12:46:17 -0500 From: Yury Norov To: Geert Uytterhoeven Cc: Wolfram Sang , linux-renesas-soc@vger.kernel.org, linux-i3c@lists.infradead.org, Alexandre Belloni , Rasmus Villemoes , Kuan-Wei Chiu , linus@ucla.edu Subject: Re: [PATCH] bitops: use safer link explaining the algorithm Message-ID: References: <20250125130320.38232-2-wsa+renesas@sang-engineering.com> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20250126_094620_321760_469D5AA4 X-CRM114-Status: GOOD ( 26.03 ) X-Mailman-Approved-At: Wed, 29 Jan 2025 12:34:46 -0800 X-BeenThere: linux-i3c@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Sender: "linux-i3c" Errors-To: linux-i3c-bounces+linux-i3c=archiver.kernel.org@lists.infradead.org T24gU2F0LCBKYW4gMjUsIDIwMjUgYXQgMDQ6MTA6MzZQTSArMDEwMCwgR2VlcnQgVXl0dGVyaG9l dmVuIHdyb3RlOgo+IEhpIFdvbGZyYW0sCj4gCj4gQ0MgTGludXMgKHRoZSBmdW5sb29wIG9uZSA7 LSkKPiAKPiBPbiBTYXQsIEphbiAyNSwgMjAyNSBhdCAyOjAz4oCvUE0gV29sZnJhbSBTYW5nCj4g PHdzYStyZW5lc2FzQHNhbmctZW5naW5lZXJpbmcuY29tPiB3cm90ZToKPiA+IER1cmluZyByZXZp ZXcsIGEgY29uY2VybiB3YXMgcmFpc2VkIHRoYXQgdGhlIGxpbmsgZXhwbGFpbmluZyB0aGUKPiA+ IGFsZ29yaXRobSBtaWdodCBnZXQgc3RhbGUuIE1lYW53aGlsZSwgdGhlIHNpdGUgaGFzIGJlZW4g YXJjaGl2ZWQgaW4gdGhlCj4gPiBXYXlCYWNrIG1hY2hpbmUuIFNvLCB1c2UgdGhlaXIgbGluayB3 aGljaCBpcyBob3BlZnVsbHkgbW9yZSBzdGFibGUuCj4gPgo+ID4gRml4ZXM6IGMzMjA1OTJmM2Yy YSAoImJpdG9wczogYWRkIGdlbmVyaWMgcGFyaXR5IGNhbGN1bGF0aW9uIGZvciB1OCIpCj4gPiBT aWduZWQtb2ZmLWJ5OiBXb2xmcmFtIFNhbmcgPHdzYStyZW5lc2FzQHNhbmctZW5naW5lZXJpbmcu Y29tPgo+IAo+IFRoYW5rcyBmb3IgeW91ciBwYXRjaCEKPiAKPiA+IC0tLSBhL2luY2x1ZGUvbGlu dXgvYml0b3BzLmgKPiA+ICsrKyBiL2luY2x1ZGUvbGludXgvYml0b3BzLmgKPiA+IEBAIC0yNTQs NyArMjU0LDcgQEAgc3RhdGljIGlubGluZSBpbnQgcGFyaXR5OCh1OCB2YWwpCj4gPiAgewo+ID4g ICAgICAgICAvKgo+ID4gICAgICAgICAgKiBPbmUgZXhwbGFuYXRpb24gb2YgdGhpcyBhbGdvcml0 aG06Cj4gPiAtICAgICAgICAqIGh0dHBzOi8vZnVubG9vcC5vcmcvY29kZXgvcHJvYmxlbS9wYXJp dHkvUkVBRE1FLmh0bWwKPiA+ICsgICAgICAgICogaHR0cDovL3dlYi5hcmNoaXZlLm9yZy93ZWIv MjAyNTAxMDUwOTMzMTYvaHR0cHM6Ly9mdW5sb29wLm9yZy9jb2RleC9wcm9ibGVtL3Bhcml0eS9S RUFETUUuaHRtbAo+IAo+IElzIHRoZSBwbGFuIHRvIHJlcGxhY2UgYWxsIHdlYmxpbmtzIGJ5IHdl YmFyY2hpdmUgbGlua3MgYXMgYSBwcmVjYXV0aW9uPwo+IEV2ZW4gd2Vic2l0ZXMgYmFja2VkIGJ5 IGJpZyBjb21wYW5pZXMgbWF5IGRpc2FwcGVhclsxXS4uLgo+IFB1dHRpbmcgdGhlIHdlYmFyY2hp dmUgbGluayBoZXJlIGFsc28gaW1wYWN0cyB0aGUgZnVubG9vcC5vcmcgc2VydmVyCj4gc3RhdGlz dGljcywgZG93bnBsYXlpbmcgaXRzIHJlbGV2YW5jZSwgYW5kIHBvc3NpYmx5IGV2ZW4gY2F1c2lu ZyBhbgo+IGVhcmxpZXIgc2h1dGRvd24uCj4gVGhlIFVSTCBjYW4gYWx3YXlzIGJlIHVwZGF0ZWQg d2hlbiB0aGUgb3JpZ2luYWwgc2l0ZSBkaXNhcHBlYXJzLgo+IAo+ID4gICAgICAgICAgKi8KPiA+ ICAgICAgICAgdmFsIF49IHZhbCA+PiA0Owo+ID4gICAgICAgICByZXR1cm4gKDB4Njk5NiA+PiAo dmFsICYgMHhmKSkgJiAxOwo+IAo+IFsxXSBUaGUgIkxlc3NXYXR0cy5vcmciIFQtc2hpcnQgSSBn b3QgZnJvbSBJbnRlbCBzdXJ2aXZlZCB0aGUKPiAgICAgY29ycmVzcG9uZGluZyB3ZWJzaXRlIGJ5 IG1hbnkgeWVhcnMgOy0pCgpUaGF0IHdhcyBhY3R1YWxseSBteSBjb25jZXJuLiBJIHVzZWQgdG8g dGhpbmsgdGhhdCBrZXJuZWwgcmVwb3NpdG9yeQpzaG91bGQgYmV0dGVyIGJlIGEgc2VsZi1jb250 YWluZWQgdGhpbmcuIEFuZCB0aGUgcmVhc29uIGlzIHRoYXQga2VybmVsCnNvdXJjZXMgc2hvdWxk IGJlIHVuZGVyc3RhbmRhYmxlIGV2ZW4gb24gYW4gQXRsYW50aWMgZmxpZ2h0LgoKQnV0IHRoaXMg ZGF5cyBhaXJsaW5lcnMgaGF2ZSBwcmV0dHkgZ29vZCBpbnRlcm5ldCBhY2Nlc3MuIFNvIEkgZG9u J3QKd2FudCB0byBsb29rIGxpa2UgYSBndXkgcHVzaGluZyA4MC1jaGFycyBsaW5lIGxpbWl0LCB3 aGlsZSB3ZSBmb3Jnb3QKZXZlbiB0aGUgbWVhbmluZyBvZiBWR0EgYWNyb255bSBtYXliZSAxNSB5 ZWFycyBhZ28uCgpRdWljayBncmVwcGluZyBzYXlzIHRoYXQgdGhlIGluY2x1ZGUvbGludXggZGly ZWN0b3J5IGFscmVhZHkgaGFzIDIzNQonaHR0cCcgbGlua3MuIEV2ZW4gYWZ0ZXIgZXhjbHVkaW5n IGNvbXBpbGVyIGxpbmthZ2UsIHdlIGhhdmUgMTQ5IG9mIHRoZW0uCgpTby4uLgoKSWYgeW91IGd1 eXMgZmVlbCB0aGF0IHlvdSBjYW4gZXhwbGFpbiB0aGUgYWxnb3JpdGhtIHlvdSdyZSBlbXBsb3lp bmcKaW4gYSBoYWxmLVZHQS1zY3JlZW4gY29tbWVudCwgaXQgd291bGQgYmUgdGhlIGJlc3QgY2hv aWNlLCBhbmQgdGhhdCdzCmVub3VnaC4KCklmIGl0J3MgaW1wb3NzaWJsZSBvciB5b3UgdGhpbmsg dGhhdCBleHRlcm5hbCByZWZlcmVuY2UgaXMgcmVhbGx5IG5lZWRlZCwKSSB0cnVzdCB5b3UuIEJ1 dCBwbGVhc2UgcmVmZXIgdGhlIG9yaWdpbmFsIHNvdXJjZS4gSW4gdGhpcyBjYXNlLCBpdCdzOgoK ICAgICAgICBXYXJyZW4sIEguIFMuICgyMDEzKS4gSGFja2Vy4oCZcyBEZWxpZ2h0ICgybmQgZWQp LCBwYWdlIDk3LgoKSWYgeW91IHRoaW5rIHRoYXQgcG9pbnRpbmcgdG8gYSB3ZWItcGFnZSB3aXRo IG5pY2Ugc3VtbWFyeSB0byB0aGUgdG9waWMgCmlzIGhlbHBmdWwgLSBwbGVhc2UgZG8uIEFuZCBp ZiB5b3Ugd291bGQgbGlrZSB0byBjYWNoZSB0aGUgbGluayAtIEkndmUKZ290IG5vdGhpbmcgYWdh aW5zdCBpdCAtIGFzIHNvb24gYXMgeW91IGNvbW1pdCB0byBtYWludGFpbiB0aG9zZSBsaW5rcwp1 cC10by1kYXRlIGluIHRoZSBrZXJuZWwgc291cmNlcy4KClRoYW5rcywKWXVyeQoKLS0gCmxpbnV4 LWkzYyBtYWlsaW5nIGxpc3QKbGludXgtaTNjQGxpc3RzLmluZnJhZGVhZC5vcmcKaHR0cDovL2xp c3RzLmluZnJhZGVhZC5vcmcvbWFpbG1hbi9saXN0aW5mby9saW51eC1pM2MK From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-yb1-f169.google.com (mail-yb1-f169.google.com [209.85.219.169]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 977729476 for ; Sun, 26 Jan 2025 17:46:19 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.219.169 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1737913581; cv=none; b=qbzTzj6TDdQSa8i7jHlmb4VY4NydQkNv+aSfQaqYk5wafr1RCjkMn7mBE8G4y5y3MC7sKXzCZneKrklm8hmGzWPVuqZFbv8ULIfDrEXE4iDPwt8HUY8XJqpsZ5sJzWGQ3VKDyjpNadNyPqKeLS5vOio21ASd+Xi7VAN7Fdy092U= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1737913581; c=relaxed/simple; bh=eMskTE926nzkvBOPe+0xNWGDURHDb3Ipk7aKj4KUnjQ=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=JRNzjDfWZO8H0484654RYiSYxEOZvjttQqBoYElIecO6mjqM/rbW0rvr9tDu5kaLl1F7J/nLl+whCr80VVWrlJfXWU+PCbTzRyCU8k87FHsOUf9RrzUfdc/o8PRLDyRWJb8HHVLK+5Hy1NRrviIx60LQUo+yZ68Xc32ws5Fh7zk= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=d1Sq5XsV; arc=none smtp.client-ip=209.85.219.169 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="d1Sq5XsV" Received: by mail-yb1-f169.google.com with SMTP id 3f1490d57ef6-e398484b60bso5504496276.1 for ; Sun, 26 Jan 2025 09:46:19 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1737913578; x=1738518378; darn=vger.kernel.org; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:references:message-id:subject:cc:to:from:date:from:to :cc:subject:date:message-id:reply-to; bh=XwP6AmZtHOBgTFWNHWplhL+BYlJ0uLnqNJ1QKPcccSI=; b=d1Sq5XsVKj631NSRGmFw9rQSPwlzvNm6g2wcHzgj1HsRPrwt6S2lThCQaq792hsJbG hfJfvT80fyXO4ULbdI7F/Unc26gBCDPaqx/ffd80RIPYJtLXnoHy5TBxQ84GOgCERJMF /PXtDyIfEmuzmfNWnCRvKBAmqhYX1XvhY87BFy6lvdr5A50H9NFJ+p6u6li6m9tlinm/ TRChCPAuS9VV5SvxA5NigkvwNC8f/jGp+0Z7jbTpfQmXgY2BHpfEi48p12A9xVBbIjIy FM1i1xCj2A9tDXD0+2WgiqTCGf/CawgBKBlrLXlcNtHbHy0Zt1hp+rzNJUL0yub0HSHb c8uQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1737913578; x=1738518378; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:references:message-id:subject:cc:to:from:date :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=XwP6AmZtHOBgTFWNHWplhL+BYlJ0uLnqNJ1QKPcccSI=; b=vLK72mIHvcN2jcZCq8+E1RRlPXA31FZuqMefer7a6Jf3cTlIPz+dbkPNiVg5HXKxNA K+NDdSrtmUCZnXETaOggmExt8Cn4Cwf5+qPOLU0j59ZYxejMtjPXYuWiYru9zkPJIaku /ClylWwIM5GLgIWt/gwGL09LgEn/WpGenshdSb6PrGvLRCRic+SuYOJMYsWMo6zvnGrM V0yAY6gZdColnPoaA+FALzBUofrMSjtSDht3yXP9d7g4XMZoqZtPpkNilBYSHp4HIAGI 8RwY96/TuCVJ6uq9COL+jNBiLYCTSQXTCeko+DffKxR4TjdnEOr30C3rDD1n0fWRFQEr keeA== X-Forwarded-Encrypted: i=1; AJvYcCX+A+SdkjuHteuSYmbEMgpsJ13QN4tyKa3aLwDD0sOnCup6AyNdACL98KmA7WyxE8D6UAD1hF8CZxqAa3tYViZ4gg==@vger.kernel.org X-Gm-Message-State: AOJu0Yz/DvLqjLcYlxkBYwQdIYkwu3W3HUnMNENX+RRImotcZxK5tQBp H/IqfSS6gT6mzEsAkxV/fiPS4Mkm5AeEMK5H87sQClwvcr4nvVen X-Gm-Gg: ASbGncv8GD2xgrTC2slzQ1acnybNxelxCYPd8Tp+9Kx4IXh4nZ5z1//fSOhRHNkt517 SwGjAgwUjJ/sX/0FbVbxrUjAkUIrt6t4c1g5Z/T77L7QTMu9wL5mzfJmdw45zdI5Nzv5Zf9weic d6J1nN6fD8LspwuGb0NFhkPp/3MBDx08X5HS6OH47cSyMKZX3mAeuwUSf8pygTtR91B/ADihmFt TilPsqSr1UBpRZKfnQgIcR2LWL45MJZcORTLUUK3y4SVXEhw8kDC22GoemwLESYFuZrV9ixZMo5 yA5ph5l5+Kt+qbYqIwABn1OtitX/IrmqkyjSA3RS44okrsxJUAw= X-Google-Smtp-Source: AGHT+IGO1xwVW2l1LTQ+o+lYbUxQvekVO4YA1p5kU65hCGKORVU3e+VmeRoBj3dBeymOr5vl4GWC3Q== X-Received: by 2002:a05:690c:2008:b0:6f7:534b:560a with SMTP id 00721157ae682-6f7534b56aamr70501867b3.8.1737913578433; Sun, 26 Jan 2025 09:46:18 -0800 (PST) Received: from localhost (c-73-224-175-84.hsd1.fl.comcast.net. [73.224.175.84]) by smtp.gmail.com with ESMTPSA id 00721157ae682-6f757a372fbsm11330997b3.117.2025.01.26.09.46.17 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 26 Jan 2025 09:46:17 -0800 (PST) Date: Sun, 26 Jan 2025 12:46:17 -0500 From: Yury Norov To: Geert Uytterhoeven Cc: Wolfram Sang , linux-renesas-soc@vger.kernel.org, linux-i3c@lists.infradead.org, Alexandre Belloni , Rasmus Villemoes , Kuan-Wei Chiu , linus@ucla.edu Subject: Re: [PATCH] bitops: use safer link explaining the algorithm Message-ID: References: <20250125130320.38232-2-wsa+renesas@sang-engineering.com> Precedence: bulk X-Mailing-List: linux-renesas-soc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: On Sat, Jan 25, 2025 at 04:10:36PM +0100, Geert Uytterhoeven wrote: > Hi Wolfram, > > CC Linus (the funloop one ;-) > > On Sat, Jan 25, 2025 at 2:03 PM Wolfram Sang > wrote: > > During review, a concern was raised that the link explaining the > > algorithm might get stale. Meanwhile, the site has been archived in the > > WayBack machine. So, use their link which is hopefully more stable. > > > > Fixes: c320592f3f2a ("bitops: add generic parity calculation for u8") > > Signed-off-by: Wolfram Sang > > Thanks for your patch! > > > --- a/include/linux/bitops.h > > +++ b/include/linux/bitops.h > > @@ -254,7 +254,7 @@ static inline int parity8(u8 val) > > { > > /* > > * One explanation of this algorithm: > > - * https://funloop.org/codex/problem/parity/README.html > > + * http://web.archive.org/web/20250105093316/https://funloop.org/codex/problem/parity/README.html > > Is the plan to replace all weblinks by webarchive links as a precaution? > Even websites backed by big companies may disappear[1]... > Putting the webarchive link here also impacts the funloop.org server > statistics, downplaying its relevance, and possibly even causing an > earlier shutdown. > The URL can always be updated when the original site disappears. > > > */ > > val ^= val >> 4; > > return (0x6996 >> (val & 0xf)) & 1; > > [1] The "LessWatts.org" T-shirt I got from Intel survived the > corresponding website by many years ;-) That was actually my concern. I used to think that kernel repository should better be a self-contained thing. And the reason is that kernel sources should be understandable even on an Atlantic flight. But this days airliners have pretty good internet access. So I don't want to look like a guy pushing 80-chars line limit, while we forgot even the meaning of VGA acronym maybe 15 years ago. Quick grepping says that the include/linux directory already has 235 'http' links. Even after excluding compiler linkage, we have 149 of them. So... If you guys feel that you can explain the algorithm you're employing in a half-VGA-screen comment, it would be the best choice, and that's enough. If it's impossible or you think that external reference is really needed, I trust you. But please refer the original source. In this case, it's: Warren, H. S. (2013). Hacker’s Delight (2nd ed), page 97. If you think that pointing to a web-page with nice summary to the topic is helpful - please do. And if you would like to cache the link - I've got nothing against it - as soon as you commit to maintain those links up-to-date in the kernel sources. Thanks, Yury