From nobody Tue Dec 2 00:05:07 2025 Received: from mail-pf1-f170.google.com (mail-pf1-f170.google.com [209.85.210.170]) (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 1887530C63E for ; Wed, 26 Nov 2025 02:55:37 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.170 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1764125739; cv=none; b=gvAWlkdjzZjXhGKFzSZJl2/iEkVayENxSVt131iyLImf+6b8V8u0EwesKMqf6oGFLJblwjw2UJB/AjiO6waGSpBtebtsSwNGhO1ygRuQLBKOeU8sIQ6UcxyVGf86lMUC0aUN6LYWOjcw4rCYN2sXIqidrvoRUziauo84Ljht2Jc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1764125739; c=relaxed/simple; bh=eu8w/L4jetrWzX8S8bCyHzu61RjFwW0nWHCcZCg8Aqo=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=MUkb+vp4/n0pm0RuWD+m9JmDtoCIUiiM7zPk82WQ64xPAYlJQ61CiVKPaSiV9reoaSJ7rLq8RAVWvDuqgotUA0BzMQMmXzKMuXFfQz25iMCHlcecEP4iCVNK1NjJjuzFdcnAYx+ggSvkOTThd9WUiCKuio1qXZALBWeCLUJhU6g= 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=e7mk5ndj; arc=none smtp.client-ip=209.85.210.170 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="e7mk5ndj" Received: by mail-pf1-f170.google.com with SMTP id d2e1a72fcca58-7aae5f2633dso7210776b3a.3 for ; Tue, 25 Nov 2025 18:55:37 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1764125737; x=1764730537; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=+KeByN8pZJtcs9SgGB87hOBvkHQ9/iNV4qXnrYiyH/k=; b=e7mk5ndjZ3AXGNPvYflkSdGXyBgzMoUu910q7gadD2a5tasV5fN2kzWA4103bnLIuZ RV+0Oxie7XGiRFdVxs4AcDdWugMYjnTBpoufo95KNgQjwQUFI7HMdxlbNFf1mb4URUkd 8s2bzNxTdIihf4sTy2jux73sBntgcyK5n5oEIaoRBJHok2tHLy1EBiP3U4I7pyxQ467F RV+IjcVyzu2JD24sCisuT34NFJjv6W78LI4rI1GUuhdQsvkerGj0jcjU/M6ful0HjSXJ RhCRHXL8H+eVbHnIA3uv6zCXRD+RUOPU61xp/iuNQZnVE92x9bsv2/pkvKAT0yznCBCP Jm6g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1764125737; x=1764730537; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=+KeByN8pZJtcs9SgGB87hOBvkHQ9/iNV4qXnrYiyH/k=; b=fTOhFhQ55U2kZR3dlQE/6KpcXonjyDZGLm2imo9Gg1fOwfPwlPubs+CLCeq0cf0gOQ 7VIaCafyZ03ZGa+Bj9JlWO6q88YiEwtw1R72e4JoaGH4Oqyv1EYeOG86OLKGrdMIa5X8 09GvFKQDcb0ngt8BaebqStRpfGxIfk3HqKO/YtWfAB2JtNr70MkRqNBm/Udk9giR9ETl uCM39PXH3b0MydRGV/V1qMRooXfCfmQR0gt3tk+oZua5Zc2n8CDunZz5mz+L1mg9SKmS Vq6slFkG5a6R6LGs0PF89sim3ypg5QQ1EEF5VdcNrQnTAbYp63uL0C3MEf4v6MwfOxVp Plkg== X-Gm-Message-State: AOJu0Yy20+eMrkbO6r4HisQQ/YhKk3t+iIfsB/kQiHcNditXJS73iRI/ VPY5Gu5hIaUYGMG0U5/a7vvRF11vVSbeEdCmx9OsbAGeeSmQnb5PqHfW X-Gm-Gg: ASbGncuBLCS3FX6durtWmRoou3YxXhYUbTLYit7XVmvA76bBRkE7cmRB60kQDRkfsj9 bWzTH2Tu2w3kyQjH9LwJ1FgN2BZNso7IPM7vY0+BPQCZFeV3yJq5bsy7YsRspWDtfiV20G1z/8Q P+MXa0DPepxEgZQkw1jCh5pEy5s8bqnbYbjOEEX7GQX/28dPQyXlC04JK8ROE2L8esDm+dho3ry UmFnhP66hc/ovblZ12VK06BKHlJxiSPcQN7bJvUzW2PVcMxDwPqWdwtrJMzvrEw3/UpLg2V8wDn TvOImk+r1zR4rZrPC9dwxWsQiXtGm+1EZBmE9ymT9hwBmLfAC9PjLKaTPFlCKVhpYruTWIujyfL S80RylN71yZJOMMuA2t1Zu1DsvxshswbgL16TCL6PpRg34VgqFvlxsbeYcdghydFiCzS2xN49FI URDWeK7395A5E= X-Google-Smtp-Source: AGHT+IHIifJejiWbRdt3S7poUuZWmIaesVFBZv1qrOM6SPQ2pCnhHKZv1D2NutmEuZZmsqcvSOMpWA== X-Received: by 2002:a05:6a20:3ca3:b0:334:8759:5016 with SMTP id adf61e73a8af0-3614ed933eemr20913143637.28.1764125737333; Tue, 25 Nov 2025 18:55:37 -0800 (PST) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-7c3ed471f8dsm19859188b3a.23.2025.11.25.18.55.35 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 25 Nov 2025 18:55:36 -0800 (PST) Received: by archie.me (Postfix, from userid 1000) id EF70D483269A; Wed, 26 Nov 2025 09:55:24 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux AFS , Linux Filesystems Development Cc: David Howells , Marc Dionne , Jonathan Corbet , Damien Le Moal , Naohiro Aota , Johannes Thumshirn , Bagas Sanjaya , Andrew Morton , Dan Williams , Gerald Schaefer , Daniel Palmer Subject: [PATCH 5/5] Documentation: zonefs: Format error processing table Date: Wed, 26 Nov 2025 09:55:11 +0700 Message-ID: <20251126025511.25188-6-bagasdotme@gmail.com> X-Mailer: git-send-email 2.52.0 In-Reply-To: <20251126025511.25188-1-bagasdotme@gmail.com> References: <20251126025511.25188-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=4941; i=bagasdotme@gmail.com; h=from:subject; bh=eu8w/L4jetrWzX8S8bCyHzu61RjFwW0nWHCcZCg8Aqo=; b=kA0DAAoW9rmJSVVRTqMByyZiAGkma6nIEzG2WLuzX7sWuVkmC2EQ7u/9SppXX70RrJ4lD8eoa Yh1BAAWCgAdFiEEkmEOgsu6MhTQh61B9rmJSVVRTqMFAmkma6kACgkQ9rmJSVVRTqMe+AD+O0Aw 4OxiUoP5/E9QIU7kvJ7hHIdfZawbesbNBBu9akYA/1IStx6I6qUi0O+8A1KIohdVsRkmrLXyVdq ed1VVzhcK X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Format zonefs I/O error processing table as reST grid table. Signed-off-by: Bagas Sanjaya Acked-by: Damien Le Moal Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap --- Documentation/filesystems/zonefs.rst | 53 +++++++++++++++++----------- 1 file changed, 32 insertions(+), 21 deletions(-) diff --git a/Documentation/filesystems/zonefs.rst b/Documentation/filesyste= ms/zonefs.rst index 58cfb1183589dd..a2e97bd69b6347 100644 --- a/Documentation/filesystems/zonefs.rst +++ b/Documentation/filesystems/zonefs.rst @@ -255,30 +255,41 @@ permissions. Further action taken by zonefs I/O error recovery can be controlled by the= user with the "errors=3Dxxx" mount option. The table below summarizes the resul= t of zonefs I/O error processing depending on the mount option and on the zone -conditions:: +conditions: =20 +--------------+-----------+-----------------------------------------+ | | | Post error state | - | "errors=3Dxxx" | device | access permissions = | - | mount | zone | file file device zone | - | option | condition | size read write read write | - +--------------+-----------+-----------------------------------------+ - | | good | fixed yes no yes yes | - | remount-ro | read-only | as is yes no yes no | - | (default) | offline | 0 no no no no | - +--------------+-----------+-----------------------------------------+ - | | good | fixed yes no yes yes | - | zone-ro | read-only | as is yes no yes no | - | | offline | 0 no no no no | - +--------------+-----------+-----------------------------------------+ - | | good | 0 no no yes yes | - | zone-offline | read-only | 0 no no yes no | - | | offline | 0 no no no no | - +--------------+-----------+-----------------------------------------+ - | | good | fixed yes yes yes yes | - | repair | read-only | as is yes no yes no | - | | offline | 0 no no no no | - +--------------+-----------+-----------------------------------------+ + | | +--------+---------------+----------------+ + | | | | access permissions | + | "errors=3Dxxx" | device | file +---------------+---------------= -+ + | mount | zone | size | file | device zone | + | option | condition | +-------+-------+--------+-------+ + | | | | read | write | read | write | + +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D+=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D+=3D=3D=3D=3D=3D=3D=3D=3D+=3D=3D=3D=3D=3D=3D=3D+=3D=3D=3D=3D=3D=3D= =3D+=3D=3D=3D=3D=3D=3D=3D=3D+=3D=3D=3D=3D=3D=3D=3D+ + | | good | fixed | yes | no | yes | yes | + | +-----------+--------+-------+-------+--------+-------+ + | remount-ro | read-only | as is | yes | no | yes | no | + | (default) +-----------+--------+-------+-------+--------+-------+ + | | offline | 0 | no | no | no | no | + +--------------+-----------+--------+-------+-------+--------+-------+ + | | good | fixed | yes | no | yes | yes | + | +-----------+--------+-------+-------+--------+-------+ + | zone-ro | read-only | as is | yes | no | yes | no | + | +-----------+--------+-------+-------+--------+-------+ + | | offline | 0 | no | no | no | no | + +--------------+-----------+--------+-------+-------+--------+-------+ + | | good | 0 | no | no | yes | yes | + | +-----------+--------+-------+-------+--------+-------+ + | zone-offline | read-only | 0 | no | no | yes | no | + | +-----------+--------+-------+-------+--------+-------+ + | | offline | 0 | no | no | no | no | + +--------------+-----------+--------+-------+-------+--------+-------+ + | | good | fixed | yes | yes | yes | yes | + | +-----------+--------+-------+-------+--------+-------+ + | repair | read-only | as is | yes | no | yes | no | + | +-----------+--------+-------+-------+--------+-------+ + | | offline | 0 | no | no | no | no | + +--------------+-----------+--------+-------+-------+--------+-------+ =20 Further notes: =20 --=20 An old man doll... just what I always wanted! - Clara