From patchwork Thu Jun 22 16:52:25 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: stsp X-Patchwork-Id: 111773 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:994d:0:b0:3d9:f83d:47d9 with SMTP id k13csp5208664vqr; Thu, 22 Jun 2023 09:58:34 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ78uHIy3wiLAY8TSjoAay5X5bv72FLZIq3PfNe+59hRxrqxYCg5FR7DdMFZjxAp4Nw3UaB2 X-Received: by 2002:a05:6808:2385:b0:3a0:61dd:c64b with SMTP id bp5-20020a056808238500b003a061ddc64bmr1752502oib.56.1687453114418; Thu, 22 Jun 2023 09:58:34 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1687453114; cv=none; d=google.com; s=arc-20160816; b=AWluPXabN3uCAraJfAcoi1K0rHr+vXpZKoj6afLEcxLljnOtKOT11P/eSV35dIhXCr x+fJakXS9ejSdbS+ikTSBSuSaElpX1daQfi3vp3l1+u9SiRxmxP1Uq9KtAoNEzJbLyz3 1pOY9st0rTixuwemcpzhxhfcZc99navsRKzzBMk0zHUgWfY9mzOvfpPhXXkWpUH6x/ng ruiubhwC+5o0GorEJf3cH8nN1M/cRtB6kNYEHClPIdD/DJ1ozMJefcWcRetNNDGB2YOO 9dBZGkBeA0uXhSYc6ql4z0Atl3SpMGA/H4c+Mmtr/5iloEpN//P51jz0DMOElOVRUKp/ ZG+A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=b93M/kd7RtP0LNT+znv3PSo9p5SOOzFeXYgHQxmwv9I=; b=VHr58kWCmBEhxi5z8U9rDxUzPv8BKbrZGG8WZ1zLXgq7/eoA76D8BiOzcndR5scDAK jv8BP9H+kYLI8lDKAil60YNOBt76GjOM1indO9wiwsiKOSR3nS+NqsEmwQ11TMN6N/76 iTRkX+j2yTUtJoJXg55hZSjNm8i5DOMwTQB3wtLDSX/unBETSnCV007cSTCew3OSZD1u b+U8et5bXoW+1sxtPmFpLyLGJJj6NVTPArlMgYO9TXZ6P32L0kTwQLvzLV3W+TJGyPBW yC8CjLGKwt5ii6zr/3s48nvpXhI5CzFW6YLREtyIl20AVBOVoIXRwh5/jvQTgosVWnuJ m9Wg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@yandex.ru header.s=mail header.b=pw9vkkfj; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=yandex.ru Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id ft18-20020a17090b0f9200b002569e5bd4a2si14646709pjb.87.2023.06.22.09.58.21; Thu, 22 Jun 2023 09:58:34 -0700 (PDT) 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; Authentication-Results: mx.google.com; dkim=pass header.i=@yandex.ru header.s=mail header.b=pw9vkkfj; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=yandex.ru Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229930AbjFVQxh (ORCPT + 99 others); Thu, 22 Jun 2023 12:53:37 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:41612 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231465AbjFVQxC (ORCPT ); Thu, 22 Jun 2023 12:53:02 -0400 Received: from forward100c.mail.yandex.net (forward100c.mail.yandex.net [178.154.239.211]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E4E9210D; Thu, 22 Jun 2023 09:53:00 -0700 (PDT) Received: from mail-nwsmtp-smtp-production-main-39.sas.yp-c.yandex.net (mail-nwsmtp-smtp-production-main-39.sas.yp-c.yandex.net [IPv6:2a02:6b8:c08:2087:0:640:7bf5:0]) by forward100c.mail.yandex.net (Yandex) with ESMTP id E1C5C600A6; Thu, 22 Jun 2023 19:52:58 +0300 (MSK) Received: by mail-nwsmtp-smtp-production-main-39.sas.yp-c.yandex.net (smtp/Yandex) with ESMTPSA id kqJAlpLDeKo0-Yux8647Y; Thu, 22 Jun 2023 19:52:58 +0300 X-Yandex-Fwd: 1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yandex.ru; s=mail; t=1687452778; bh=b93M/kd7RtP0LNT+znv3PSo9p5SOOzFeXYgHQxmwv9I=; h=Message-Id:Date:In-Reply-To:Cc:Subject:References:To:From; b=pw9vkkfjeG7hR2ziEEn7ezSdAdQd1GZRddpnZWxGipXv2Szk9UACc3EslkeEgEv/E xpHc8yjiiNPoWf3pcJZGIZLrjEnutadOLRA+jeHwIe1F3y4CkU24kPaejvYDM0u5IF H7l6CO4WQlEBibwIa7RnUNt2taP9LR0eAMJNcEpo= Authentication-Results: mail-nwsmtp-smtp-production-main-39.sas.yp-c.yandex.net; dkim=pass header.i=@yandex.ru From: Stas Sergeev To: linux-kernel@vger.kernel.org Cc: Stas Sergeev , Jeff Layton , Chuck Lever , Alexander Viro , Christian Brauner , linux-fsdevel@vger.kernel.org, Shuah Khan , linux-kselftest@vger.kernel.org, linux-api@vger.kernel.org Subject: [PATCH] fcntl.2: document F_UNLCK F_OFD_GETLK extension Date: Thu, 22 Jun 2023 21:52:25 +0500 Message-Id: <20230622165225.2772076-4-stsp2@yandex.ru> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20230622165225.2772076-1-stsp2@yandex.ru> References: <20230622165225.2772076-1-stsp2@yandex.ru> MIME-Version: 1.0 X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM,RCVD_IN_MSPIKE_H4,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE, 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: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1769422837192182520?= X-GMAIL-MSGID: =?utf-8?q?1769422837192182520?= F_UNLCK has the special meaning when used as a lock type on input. It returns the information about any lock found in the specified region on that particular file descriptor. Locks on other file descriptors are ignored by F_UNLCK. Signed-off-by: Stas Sergeev CC: Jeff Layton CC: Chuck Lever CC: Alexander Viro CC: Christian Brauner CC: linux-fsdevel@vger.kernel.org CC: linux-kernel@vger.kernel.org CC: Shuah Khan CC: linux-kselftest@vger.kernel.org CC: linux-api@vger.kernel.org --- man2/fcntl.2 | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/man2/fcntl.2 b/man2/fcntl.2 index 7b5604e3a..e3e3e7b8c 100644 --- a/man2/fcntl.2 +++ b/man2/fcntl.2 @@ -604,6 +604,13 @@ then details about one of these locks are returned via .IR lock , as described above for .BR F_GETLK . +.B F_UNLCK +has the special meaning when put into +.I l_type +as an input. It returns the information about any lock in the specified +range on that particular file descriptor. The locks on other file +descriptors are ignored by +.BR F_UNLCK . .PP In the current implementation, .\" commit 57b65325fe34ec4c917bc4e555144b4a94d9e1f7