From patchwork Tue Jul 9 18:31:21 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Josef Bacik X-Patchwork-Id: 13728418 Received: from mail-qv1-f48.google.com (mail-qv1-f48.google.com [209.85.219.48]) (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 1BBE01B86E4 for ; Tue, 9 Jul 2024 18:31:46 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.219.48 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1720549909; cv=none; b=NMLLgxMmM3kxwWN9+uA3fjrWVqYQChQpx8RnEJLxU50Yk1Fj2dt5i0DQpeMgZgSSBniPpLPDQbo6stF1JbFbpa82Yj9EC1Gyk8NMMtaf9d0E2D9F3GM1Ohi5j1/HD9QJSzHnZ5E+nVpdm29ZnEQ7NPUR25PxJASt2m0aF69syrw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1720549909; c=relaxed/simple; bh=HGETCldYbcNCZ1ZFAye6opWeRzpkbfEccNZQmERX9QU=; h=From:To:Subject:Date:Message-ID:MIME-Version; b=JQJt4TaJ53csze8+H9DNumnLsu9g35jvPHiw7ayvRfj0UlCyYFAt/Ondjq+yiSE9k5pfRE6mAcAKrx6Z4w28s9JVBxifE/CyI4Htgp2rjONzbDy4QRvS4sYWa+tuq3Nb3LIP6BNTijcrth2qf7fey/62sd+wUV9msmjSkxykZYU= 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=nPPFDcHz; arc=none smtp.client-ip=209.85.219.48 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="nPPFDcHz" Received: by mail-qv1-f48.google.com with SMTP id 6a1803df08f44-6b5f3348f05so24136076d6.0 for ; Tue, 09 Jul 2024 11:31:46 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=toxicpanda-com.20230601.gappssmtp.com; s=20230601; t=1720549906; x=1721154706; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:to :from:from:to:cc:subject:date:message-id:reply-to; bh=sSlJ7ih+2Iyd6DUdnJMEGw0A84G/QfcyKdknN84svD0=; b=nPPFDcHzK+RL2TqF5Xnsl77jdJ5EmRvzqfjeD5EzbOnv6lVkCGPnpGvWHR/4la14kP Qr0t12rrw7CAwGzXkz59myYLpPE4wNGfqGP10+EMbvny+ChUCwNv/wZ3EXSN2RdY4vwU PPWo8xeNh8P5xqp0vPZCqSdG7y9UyoNs1VderD/gcraz8h90BKLvmZ/uEelFFT4mvpek +HMSliBWxV1noJcsZtTANtML/uFZ7+E8RAia7phOQMlk0f0wF04ruWTPHfJfxzC9YRBG dDoT7yJqVspsBrA2bmv0B0l0+MT7jiFehUW4W/VqAQLSTlJNu0N0pJ2uf3uXKW6KpZm4 K5NA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1720549906; x=1721154706; h=content-transfer-encoding:mime-version:message-id:date:subject:to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=sSlJ7ih+2Iyd6DUdnJMEGw0A84G/QfcyKdknN84svD0=; b=ZQpXIEx2ylJpsSt7VINniMywAvqwOf3eUUeK8VxchNM3SDVEUqG2P5Y16faGOKZavN vD//1kODJZf7Uds3cxfLaFc1c4flHG80wCLhQ3bWpayYEmJ3vfk1kFvvOfLvjdFkKSA0 B8C3ai11+ACMr5tY3gdOiRo7Xrs6T1S0InjnzavtzvOD6fnh3C8lkbG7+gHSL4mjr0ww yol6HZV+MFdHIbKkyNW5cwgEJ/++DV/b8u16Voe/1aJpoBzxE7nj+aOQy9fbnxdbUCJy fT4e3lla2PuhBNBy2cwe2oLtTLL9UzG894qtS3D4Wcegpsi1urKC6yEaEM9aeBraJCw/ rv4A== X-Forwarded-Encrypted: i=1; AJvYcCVVPROS84KUx8BvU1+s7q1vNr4FKRlqkOR04FsGyiXiq8IF/iR12xC9JVoXzcrOhk51o8KLB1W8GJdzuf0WEA4FeoIOMub6gmJulfPHmA== X-Gm-Message-State: AOJu0YwbLsM3F1Dos0MkhjBvehMbfrIPhXtT8z/FsKb9QH2f1lBTha+7 ae349lY0Ounwhq8XrcBncxePl/JZM8xPx0n9yNzFMjH27woyusMPwmnqjd572yHt+9PnQd8bEur c X-Google-Smtp-Source: AGHT+IHis6LVaz5pegztmv3IhAFqRHqD25McEQwiLb7mYAMUtId8cMUTIgXaSsfz/UzQBFHGP61W+A== X-Received: by 2002:ad4:5d6b:0:b0:6b5:e663:4d4d with SMTP id 6a1803df08f44-6b61bce676cmr44571496d6.30.1720549905920; Tue, 09 Jul 2024 11:31:45 -0700 (PDT) Received: from localhost (syn-076-182-020-124.res.spectrum.com. [76.182.20.124]) by smtp.gmail.com with ESMTPSA id 6a1803df08f44-6b61ba8ad29sm11084486d6.116.2024.07.09.11.31.45 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Jul 2024 11:31:45 -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 v6 0/2] man-pages: add documentation for statmount/listmount Date: Tue, 9 Jul 2024 14:31:21 -0400 Message-ID: X-Mailer: git-send-email 2.43.0 Precedence: bulk X-Mailing-List: linux-fsdevel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 V5: https://lore.kernel.org/linux-fsdevel/cover.1720545710.git.josef@toxicpanda.com/ V4: https://lore.kernel.org/linux-fsdevel/cover.1719840964.git.josef@toxicpanda.com/ V3: https://lore.kernel.org/linux-fsdevel/cover.1719425922.git.josef@toxicpanda.com/ V2: https://lore.kernel.org/linux-fsdevel/cover.1719417184.git.josef@toxicpanda.com/ V1: https://lore.kernel.org/linux-fsdevel/cover.1719341580.git.josef@toxicpanda.com/ v5->v6: - Reworked all of the NULL related comments. - Addressed the other review comments. v4->v5: - Described bufsize. - Moved the general description of some of the fields to under the field labels themselves, and generally reworked everything to be more specific. - Addressed the various formatting/wording review comments. v3->v4: - Addressed review comments. v2->v3: - Removed a spurious \t comment in listmount.2 (took me a while to figure out why it was needed in statmount.2 but not listmount.2, it's because it lets you know that there's a TS in the manpage). - Fixed some unbalanced " in both pages - Removed a EE in the nf section which is apparently not needed v1->v2: - Dropped the statx patch as Alejandro already took it (thanks!) - Reworked everything to use semantic newlines - Addressed all of the comments on the statmount.2 man page Josef Josef Bacik (2): statmount.2: New page describing the statmount syscall listmount.2: New page describing the listmount syscall man/man2/listmount.2 | 112 +++++++++++++++++ man/man2/statmount.2 | 281 +++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 393 insertions(+) create mode 100644 man/man2/listmount.2 create mode 100644 man/man2/statmount.2