nfsd_file_acquire(9)

💖 nfsd_file_acquire(9) — Kernel API Manual 💖

okay so bestie, this is the Kernel API Manual page for nfsd_file_acquire(9), and it's literally here to get you a struct nfsd_file with an open file. let's get into it 🫶✨

✨ NAME ✨

nfsd_file_acquire — get a struct nfsd_file with an open file

🌸 SYNOPSIS 🌸

__be32 nfsd_file_acquire (struct svc_rqst *rqstp , struct svc_fh *fhp ,
       unsigned int may_flags , struct nfsd_file **pnf );

🎀 ARGUMENTS 🎀

• rqstp — the RPC transaction being executed
• fhp — the NFS filehandle of the file to be opened
• may_flags — NFSD_MAY_ settings for the file
• pnf — OUT: new or found struct nfsd_file object

🦋 DESCRIPTION 🦋

The nfsd_file_object returned by this API is reference-counted but not garbage-collected — no cap, that's just how it is 💅. The object is unhashed after the final nfsd_file_put.

Return values:

• nfs_ok — pnf points to an nfsd_file with its reference count boosted ✨
• On error, an nfsstat value in network byte order is returned 😭

💜 SEE ALSO 💜

Kernel file: ./fs/nfsd/filecache.c — and these are the related pages, bestie:

• nfsd_file_check_write_error(9)
• nfsd_file_put(9)
• nfsd_file_put_local(9)
• nfsd_file_file(9)
• nfsd_file_dispose_list_delayed(9)
• nfsd_file_net_dispose(9)
• nfsd_file_lru_cb(9)
• nfsd_file_cond_queue(9)
• nfsd_file_queue_for_close(9)
• nfsd_file_close_inode(9)
• nfsd_file_close_inode_sync(9)
• nfsd_file_close_export(9)
• __nfsd_file_cache_purge(9)
• nfsd_file_cache_purge(9)
• nfsd_file_is_cached(9)
• nfsd_file_acquire_gc(9)
• nfsd_file_acquire_local(9)
• nfsd_file_acquire_opened(9)
• nfsd_file_acquire_dir(9)
• nfsd_fsnotify_recalc_mask(9)

mwah 💋 — source/version is ./fs/nfsd, date is October 2026, and this iconic page is nfsd_file_acquire(9). bye bestie 🫶✨