From patchwork Tue Jun 25 18:56:04 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Josef Bacik X-Patchwork-Id: 13711838 Received: from mail-oi1-f182.google.com (mail-oi1-f182.google.com [209.85.167.182]) (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 F2017178CFD for ; Tue, 25 Jun 2024 18:56:54 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.167.182 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1719341816; cv=none; b=sZ+YkmB8h/YVdFqp4xArd6C3mP3Feo1tRr/0neSOiWj8Q8iTd2aNE1bnN+hmMr2Q11kuwpCfZTGDr6Um5uR6fPf4aYkhDWBoL3nq7oOyvqRnjOhwA7twCxfjfWcPSLcLk0NAvhAGkQBApclWxbciCjv8+UVaip7BaEFd3gz/caw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1719341816; c=relaxed/simple; bh=cPyFS29MhsjbQsEzTdqOG8AYbV9KPWslEBcXgiruLzM=; h=From:To:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=gFwVLNIZX/BfjRfW1qDu+HGOPWK59v+//PBltSaloLqioF/ymSIUqqFdeRohj7tXXRyxnRxNw3sO36SkkgK0xk/4muPpKUaK25JjCge2qwIuKRqKQiZxv/MDJhhrhfurJs5jUXXIrKRHpi+UQ2JHahnydDfKB4QChT/Q51rnJN8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=toxicpanda.com; spf=none smtp.mailfrom=toxicpanda.com; dkim=pass (2048-bit key) header.d=toxicpanda-com.20230601.gappssmtp.com header.i=@toxicpanda-com.20230601.gappssmtp.com header.b=gt/+FqjM; arc=none smtp.client-ip=209.85.167.182 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=toxicpanda.com Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=toxicpanda.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=toxicpanda-com.20230601.gappssmtp.com header.i=@toxicpanda-com.20230601.gappssmtp.com header.b="gt/+FqjM" Received: by mail-oi1-f182.google.com with SMTP id 5614622812f47-3d55c0fadd2so451461b6e.3 for ; Tue, 25 Jun 2024 11:56:54 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=toxicpanda-com.20230601.gappssmtp.com; s=20230601; t=1719341814; x=1719946614; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:from:to:cc:subject:date:message-id :reply-to; bh=rb9wT4QSaiHaz9QBF9Tfy5DasMFtVo8sghmiqbkkuXw=; b=gt/+FqjMNnGPdDM+BgvN5jLcz8pIiCW9A8gBHEnhB2+DoFGmpWKoMnQM084g66cChB neDneM+PkbjX+rT88V0HXofsZvkpR4sfeIrrsULxn0qRBNZDPGPRNGyqWQUFrHtbNmyY lWonDFcwc53cizoZNCHiJ1Jzr5T+S2Zoyw/VKZ4l2CUEfkSXORpBbpOldDls/DFEbFb8 FqEn1yENiLkImML7UMlw4uEq7biw4gsGUYXDv5c9T2ZJYIlP8K2hCCzn7AU3xEQPVOh/ hc99sd8KX9gQjzn9k47IDR0NziQL9CMbYzTx0qg0y8styQi34x6nQrgN0SHnA6kZRjBo qSNg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1719341814; x=1719946614; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=rb9wT4QSaiHaz9QBF9Tfy5DasMFtVo8sghmiqbkkuXw=; b=uVvzSrwzYKICeCqVoDP9l+IjJCi0J+wRrUm7ww3XJVaYtEaVxRp9OgufD/+NHQMMeK g/86Md0ejWPYdxS+pNtmiaq9riTwNbG5cvdZa3/LFFvHpg7YijFkS93MFctQWmuZJDAD rSXpNLqWLYRAWLz4juSIag5pZZLvHmvmAQ1HOVfMOiaF3yJc01q0AwXpvDwVOhCB3xwi 9RCYASJoMD50vd4tm8NtJSviEgZjfGjxhXn7v3d+crxNo3KmvEL/6jMUfg/WsIw/bHiX nkiIM2VLKJ/fGwFiQaVyZpZXgQq9nV7pQXSvdao2+/rIBZHu9kMZDFozQ1ZjwagyoOWX UyAQ== X-Forwarded-Encrypted: i=1; AJvYcCXozUMEx1HOOThYJRKHJ2GTZYQckO03zh1ERoy9J7VI+6wwsenwsZW7axbFONY2fYWKAhBE3OL60bO+Ig0q2aub78MBMPZsaPYjlWPOEg== X-Gm-Message-State: AOJu0YwKT0OJiR/TsqsyMa1EH2WPmJ+b3BUIxaGKafkdh1WIE/E5u90m ezcbOWNTzFjXANP7rOdcIaxaDImX2Y9615Tv2Fo4j/igq/GdFKF1MwzEaWB8iBg= X-Google-Smtp-Source: AGHT+IFeNUser9m9SFMDA91HJIPpG+2ywT2PBdGGK4w7tNaXp3Fls7OvSC/z3dQbtgSBWqca92mNQg== X-Received: by 2002:a05:6808:1a21:b0:3d2:3811:bc69 with SMTP id 5614622812f47-3d543b84811mr10825652b6e.48.1719341813980; Tue, 25 Jun 2024 11:56:53 -0700 (PDT) Received: from localhost (syn-076-182-020-124.res.spectrum.com. [76.182.20.124]) by smtp.gmail.com with ESMTPSA id d75a77b69052e-444c2c3d924sm57436991cf.61.2024.06.25.11.56.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 25 Jun 2024 11:56:53 -0700 (PDT) From: Josef Bacik To: alx@kernel.org, linux-man@vger.kernel.org, brauner@kernel.org, linux-fsdevel@vger.kernel.org, mszeredi@redhat.com, kernel-team@fb.com Subject: [PATCH 1/3] statx.2: Document STATX_MNT_ID_UNIQUE Date: Tue, 25 Jun 2024 14:56:04 -0400 Message-ID: X-Mailer: git-send-email 2.43.0 In-Reply-To: References: Precedence: bulk X-Mailing-List: linux-fsdevel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Linux 6.8 adds STATX_MNT_ID_UNIQUE support https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=98d2b43081972 Add the text and explanation to the statx man page. Signed-off-by: Josef Bacik --- man/man2/statx.2 | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/man/man2/statx.2 b/man/man2/statx.2 index 0dcf7e20b..3d5ecd651 100644 --- a/man/man2/statx.2 +++ b/man/man2/statx.2 @@ -234,7 +234,7 @@ .SH DESCRIPTION .I mask is an ORed combination of the following constants: .P -.in +4n +.in +1n .TS lB l. STATX_TYPE Want stx_mode & S_IFMT @@ -255,6 +255,7 @@ .SH DESCRIPTION STATX_MNT_ID Want stx_mnt_id (since Linux 5.8) STATX_DIOALIGN Want stx_dio_mem_align and stx_dio_offset_align (since Linux 6.1; support varies by filesystem) +STATX_MNT_ID_UNIQUE Want unique stx_mnt_id (since Linux 6.8) .TE .in .P @@ -410,11 +411,18 @@ .SH DESCRIPTION .TP .I stx_mnt_id .\" commit fa2fcf4f1df1559a0a4ee0f46915b496cc2ebf60 -The mount ID of the mount containing the file. +If using STATX_MNT_ID, this is the mount ID of the mount containing the file. This is the same number reported by .BR name_to_handle_at (2) and corresponds to the number in the first field in one of the records in .IR /proc/self/mountinfo . +.IP +If using STATX_MNT_ID_UNIQUE, this is the unique mount ID of the mount +containing the file. This is the number reported by +.BR listmount (2) +and is the ID used to query the mount with +.BR statmount (2) . +It is guaranteed to not be reused while the system is running. .TP .I stx_dio_mem_align The alignment (in bytes) required for user memory buffers for direct I/O