fs/nfsd/lockd.c

Source file repositories/reference/linux-study-clean/fs/nfsd/lockd.c

File Facts

System
Linux kernel
Corpus path
fs/nfsd/lockd.c
Extension
.c
Size
3021 bytes
Lines
111
Domain
Core OS
Bucket
VFS And Filesystem Core
Inferred role
Core OS: implementation source
Status
source implementation candidate

Why This File Exists

Core operating-system implementation surface: boot, tasks, memory, VFS, syscall-facing interfaces, synchronization, credentials, and isolation.

Dependency Surface

Detected Declarations

Annotated Snippet

// SPDX-License-Identifier: GPL-2.0
/*
 * This file contains all the stubs needed when communicating with lockd.
 * This level of indirection is necessary so we can run nfsd+lockd without
 * requiring the nfs client to be compiled in/loaded, and vice versa.
 *
 * Copyright (C) 1996, Olaf Kirch <okir@monad.swb.de>
 */

#include <linux/file.h>
#include <linux/lockd/bind.h>
#include "nfsd.h"
#include "vfs.h"

#define NFSDDBG_FACILITY		NFSDDBG_LOCKD

/**
 * nlm_fopen - Open an NFSD file
 * @rqstp: NLM RPC procedure execution context
 * @f: NFS file handle to be opened
 * @filp: OUT: an opened struct file
 * @flags: the POSIX open flags to use
 *
 * nlm_fopen() holds the dentry reference until nlm_fclose() releases it.
 *
 * Returns zero on success or a negative errno value if the file
 * cannot be opened.
 */
static int nlm_fopen(struct svc_rqst *rqstp, struct nfs_fh *f,
		     struct file **filp, int flags)
{
	__be32		nfserr;
	int		access;
	struct svc_fh	fh;

	/* must initialize before using! but maxsize doesn't matter */
	fh_init(&fh,0);
	fh.fh_handle.fh_size = f->size;
	memcpy(&fh.fh_handle.fh_raw, f->data, f->size);
	fh.fh_export = NULL;

	/*
	 * Allow BYPASS_GSS as some client implementations use AUTH_SYS
	 * for NLM even when GSS is used for NFS.
	 * Allow OWNER_OVERRIDE as permission might have been changed
	 * after the file was opened.
	 * Pass MAY_NLM so that authentication can be completely bypassed
	 * if NFSEXP_NOAUTHNLM is set.  Some older clients use AUTH_NULL
	 * for NLM requests.
	 */
	access = (flags == O_WRONLY) ? NFSD_MAY_WRITE : NFSD_MAY_READ;
	access |= NFSD_MAY_NLM | NFSD_MAY_OWNER_OVERRIDE | NFSD_MAY_BYPASS_GSS;
	nfserr = nfsd_open(rqstp, &fh, S_IFREG, access, filp);
	fh_put(&fh);

	switch (nfserr) {
	case nfs_ok:
		break;
	case nfserr_jukebox:
		/*
		 * This error can indicate a presence of a conflicting
		 * delegation to an NLM lock request. Options are:
		 * (1) For now, drop this request and make the client
		 * retry. When delegation is returned, client's lock retry
		 * will complete.
		 * (2) NLM4_DENIED as per "spec" signals to the client
		 * that the lock is unavailable now but client can retry.
		 * Linux client implementation does not. It treats
		 * NLM4_DENIED same as NLM4_FAILED and fails the request.
		 * (3) For the future, treat this as blocked lock and try
		 * to callback when the delegation is returned but might
		 * not have a proper lock request to block on.
		 */
		return -EWOULDBLOCK;
	case nfserr_stale:
		return -ESTALE;
	default:
		return -ENOLCK;
	}

	return 0;
}

/**
 * nlm_fclose - Close an NFSD file
 * @filp: a struct file that was opened by nlm_fopen()
 */
static void
nlm_fclose(struct file *filp)
{

Annotation

Implementation Notes