All of lore.kernel.org
 help / color / mirror / Atom feed
* [PATCH v3 0/4] Containerised NFS clients and teardown
@ 2025-03-21 15:21 trondmy
  2025-03-21 15:21 ` [PATCH v3 1/4] NFS: Add a mount option to make ENETUNREACH errors fatal trondmy
                   ` (4 more replies)
  0 siblings, 5 replies; 6+ messages in thread
From: trondmy @ 2025-03-21 15:21 UTC (permalink / raw)
  To: linux-nfs; +Cc: Jeff Layton, Josef Bacik

From: Trond Myklebust <trond.myklebust@hammerspace.com>

When a NFS client is started from inside a container, it is often not
possible to ensure a safe shutdown and flush of the data before the
container orchestrator steps in to tear down the network. Typically,
what can happen is that the orchestrator triggers a lazy umount of the
mounted filesystems, then proceeds to delete virtual network device
links, bridges, NAT configurations, etc.

Once that happens, it may be impossible to reach into the container to
perform any further shutdown actions on the NFS client.

This patchset proposes to allow the client to deal with these situations
by treating the two errors ENETDOWN  and ENETUNREACH as being fatal.
The intention is to then allow the I/O queue to drain, and any remaining
RPC calls to error out, so that the lazy umounts can complete the
shutdown process.

In order to do so, a new mount option "fatal_neterrors" is introduced,
which can take the values "default", "none" and "ENETDOWN:ENETUNREACH".
The value "none" forces the existing behaviour, whereby hard mounts are
unaffected by the ENETDOWN and ENETUNREACH errors.
The value "ENETDOWN:ENETUNREACH" forces ENETDOWN and ENETUNREACH errors
to always be fatal.
If the user does not specify the "fatal_neterrors" option, or uses the
value "default", then ENETDOWN and ENETUNREACH will be fatal if the
mount was started from inside a network namespace that is not
"init_net", and otherwise not.

The expectation is that users will normally not need to set this option,
unless they are running inside a container, and want to prevent ENETDOWN
and ENETUNREACH from being fatal by setting "-ofatal_neterrors=none".

---
v2:
- Fix NFSv4 client cl_flag initialisation
- Add RPC task flag trace decoding
v3:
- Fix a copy/paste error in nfs4_set_client() (Thanks, Jeff Layton!)
- Fix the mount option name to be "fatal_neterrors".
- Capitalise ENETDOWN and ENETUNREACH in the fatal_neterrors parameter
  list to make it more obvious this refers to the POSIX networking
  errors.
- Always display the "fatal_neterrors" setting in /proc/mounts

Trond Myklebust (4):
  NFS: Add a mount option to make ENETUNREACH errors fatal
  NFS: Treat ENETUNREACH errors as fatal in containers
  pNFS/flexfiles: Treat ENETUNREACH errors as fatal in containers
  pNFS/flexfiles: Report ENETDOWN as a connection error

 fs/nfs/client.c                        |  5 ++++
 fs/nfs/flexfilelayout/flexfilelayout.c | 24 ++++++++++++++--
 fs/nfs/fs_context.c                    | 39 ++++++++++++++++++++++++++
 fs/nfs/nfs3client.c                    |  2 ++
 fs/nfs/nfs4client.c                    |  7 +++++
 fs/nfs/nfs4proc.c                      |  3 ++
 fs/nfs/super.c                         |  3 ++
 include/linux/nfs4.h                   |  1 +
 include/linux/nfs_fs_sb.h              |  2 ++
 include/linux/sunrpc/clnt.h            |  5 +++-
 include/linux/sunrpc/sched.h           |  1 +
 include/trace/events/sunrpc.h          |  1 +
 net/sunrpc/clnt.c                      | 30 ++++++++++++++------
 13 files changed, 112 insertions(+), 11 deletions(-)

-- 
2.49.0


^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2025-03-21 15:34 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2025-03-21 15:21 [PATCH v3 0/4] Containerised NFS clients and teardown trondmy
2025-03-21 15:21 ` [PATCH v3 1/4] NFS: Add a mount option to make ENETUNREACH errors fatal trondmy
2025-03-21 15:21 ` [PATCH v3 2/4] NFS: Treat ENETUNREACH errors as fatal in containers trondmy
2025-03-21 15:21 ` [PATCH v3 3/4] pNFS/flexfiles: " trondmy
2025-03-21 15:21 ` [PATCH v3 4/4] pNFS/flexfiles: Report ENETDOWN as a connection error trondmy
2025-03-21 15:33 ` [PATCH v3 0/4] Containerised NFS clients and teardown Chuck Lever

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.