mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-09-05 18:39:59 +00:00
![Greg Kroah-Hartman](/assets/img/avatar_default.png)
Many source files in the tree are missing licensing information, which makes it harder for compliance tools to determine the correct license. By default all files without license information are under the default license of the kernel, which is GPL version 2. Update the files which contain no license information with the 'GPL-2.0' SPDX license identifier. The SPDX identifier is a legally binding shorthand, which can be used instead of the full boiler plate text. This patch is based on work done by Thomas Gleixner and Kate Stewart and Philippe Ombredanne. How this work was done: Patches were generated and checked against linux-4.14-rc6 for a subset of the use cases: - file had no licensing information it it. - file was a */uapi/* one with no licensing information in it, - file was a */uapi/* one with existing licensing information, Further patches will be generated in subsequent months to fix up cases where non-standard license headers were used, and references to license had to be inferred by heuristics based on keywords. The analysis to determine which SPDX License Identifier to be applied to a file was done in a spreadsheet of side by side results from of the output of two independent scanners (ScanCode & Windriver) producing SPDX tag:value files created by Philippe Ombredanne. Philippe prepared the base worksheet, and did an initial spot review of a few 1000 files. The 4.13 kernel was the starting point of the analysis with 60,537 files assessed. Kate Stewart did a file by file comparison of the scanner results in the spreadsheet to determine which SPDX license identifier(s) to be applied to the file. She confirmed any determination that was not immediately clear with lawyers working with the Linux Foundation. Criteria used to select files for SPDX license identifier tagging was: - Files considered eligible had to be source code files. - Make and config files were included as candidates if they contained >5 lines of source - File already had some variant of a license header in it (even if <5 lines). All documentation files were explicitly excluded. The following heuristics were used to determine which SPDX license identifiers to apply. - when both scanners couldn't find any license traces, file was considered to have no license information in it, and the top level COPYING file license applied. For non */uapi/* files that summary was: SPDX license identifier # files ---------------------------------------------------|------- GPL-2.0 11139 and resulted in the first patch in this series. If that file was a */uapi/* path one, it was "GPL-2.0 WITH Linux-syscall-note" otherwise it was "GPL-2.0". Results of that was: SPDX license identifier # files ---------------------------------------------------|------- GPL-2.0 WITH Linux-syscall-note 930 and resulted in the second patch in this series. - if a file had some form of licensing information in it, and was one of the */uapi/* ones, it was denoted with the Linux-syscall-note if any GPL family license was found in the file or had no licensing in it (per prior point). Results summary: SPDX license identifier # files ---------------------------------------------------|------ GPL-2.0 WITH Linux-syscall-note 270 GPL-2.0+ WITH Linux-syscall-note 169 ((GPL-2.0 WITH Linux-syscall-note) OR BSD-2-Clause) 21 ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause) 17 LGPL-2.1+ WITH Linux-syscall-note 15 GPL-1.0+ WITH Linux-syscall-note 14 ((GPL-2.0+ WITH Linux-syscall-note) OR BSD-3-Clause) 5 LGPL-2.0+ WITH Linux-syscall-note 4 LGPL-2.1 WITH Linux-syscall-note 3 ((GPL-2.0 WITH Linux-syscall-note) OR MIT) 3 ((GPL-2.0 WITH Linux-syscall-note) AND MIT) 1 and that resulted in the third patch in this series. - when the two scanners agreed on the detected license(s), that became the concluded license(s). - when there was disagreement between the two scanners (one detected a license but the other didn't, or they both detected different licenses) a manual inspection of the file occurred. - In most cases a manual inspection of the information in the file resulted in a clear resolution of the license that should apply (and which scanner probably needed to revisit its heuristics). - When it was not immediately clear, the license identifier was confirmed with lawyers working with the Linux Foundation. - If there was any question as to the appropriate license identifier, the file was flagged for further research and to be revisited later in time. In total, over 70 hours of logged manual review was done on the spreadsheet to determine the SPDX license identifiers to apply to the source files by Kate, Philippe, Thomas and, in some cases, confirmation by lawyers working with the Linux Foundation. Kate also obtained a third independent scan of the 4.13 code base from FOSSology, and compared selected files where the other two scanners disagreed against that SPDX file, to see if there was new insights. The Windriver scanner is based on an older version of FOSSology in part, so they are related. Thomas did random spot checks in about 500 files from the spreadsheets for the uapi headers and agreed with SPDX license identifier in the files he inspected. For the non-uapi files Thomas did random spot checks in about 15000 files. In initial set of patches against 4.14-rc6, 3 files were found to have copy/paste license identifier errors, and have been fixed to reflect the correct identifier. Additionally Philippe spent 10 hours this week doing a detailed manual inspection and review of the 12,461 patched files from the initial patch version early this week with: - a full scancode scan run, collecting the matched texts, detected license ids and scores - reviewing anything where there was a license detected (about 500+ files) to ensure that the applied SPDX license was correct - reviewing anything where there was no detection but the patch license was not GPL-2.0 WITH Linux-syscall-note to ensure that the applied SPDX license was correct This produced a worksheet with 20 files needing minor correction. This worksheet was then exported into 3 different .csv files for the different types of files to be modified. These .csv files were then reviewed by Greg. Thomas wrote a script to parse the csv files and add the proper SPDX tag to the file, in the format that the file expected. This script was further refined by Greg based on the output to detect more types of files automatically and to distinguish between header and source .c files (which need different comment types.) Finally Greg ran the script using the .csv files to generate the patches. Reviewed-by: Kate Stewart <kstewart@linuxfoundation.org> Reviewed-by: Philippe Ombredanne <pombredanne@nexb.com> Reviewed-by: Thomas Gleixner <tglx@linutronix.de> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
373 lines
11 KiB
C
373 lines
11 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
/*
|
|
* linux/include/linux/lockd/lockd.h
|
|
*
|
|
* General-purpose lockd include file.
|
|
*
|
|
* Copyright (C) 1996 Olaf Kirch <okir@monad.swb.de>
|
|
*/
|
|
|
|
#ifndef LINUX_LOCKD_LOCKD_H
|
|
#define LINUX_LOCKD_LOCKD_H
|
|
|
|
#ifdef __KERNEL__
|
|
|
|
#include <linux/in.h>
|
|
#include <linux/in6.h>
|
|
#include <net/ipv6.h>
|
|
#include <linux/fs.h>
|
|
#include <linux/kref.h>
|
|
#include <linux/utsname.h>
|
|
#include <linux/lockd/bind.h>
|
|
#include <linux/lockd/xdr.h>
|
|
#ifdef CONFIG_LOCKD_V4
|
|
#include <linux/lockd/xdr4.h>
|
|
#endif
|
|
#include <linux/lockd/debug.h>
|
|
#include <linux/sunrpc/svc.h>
|
|
|
|
/*
|
|
* Version string
|
|
*/
|
|
#define LOCKD_VERSION "0.5"
|
|
|
|
/*
|
|
* Default timeout for RPC calls (seconds)
|
|
*/
|
|
#define LOCKD_DFLT_TIMEO 10
|
|
|
|
/*
|
|
* Lockd host handle (used both by the client and server personality).
|
|
*/
|
|
struct nlm_host {
|
|
struct hlist_node h_hash; /* doubly linked list */
|
|
struct sockaddr_storage h_addr; /* peer address */
|
|
size_t h_addrlen;
|
|
struct sockaddr_storage h_srcaddr; /* our address (optional) */
|
|
size_t h_srcaddrlen;
|
|
struct rpc_clnt *h_rpcclnt; /* RPC client to talk to peer */
|
|
char *h_name; /* remote hostname */
|
|
u32 h_version; /* interface version */
|
|
unsigned short h_proto; /* transport proto */
|
|
unsigned short h_reclaiming : 1,
|
|
h_server : 1, /* server side, not client side */
|
|
h_noresvport : 1,
|
|
h_inuse : 1;
|
|
wait_queue_head_t h_gracewait; /* wait while reclaiming */
|
|
struct rw_semaphore h_rwsem; /* Reboot recovery lock */
|
|
u32 h_state; /* pseudo-state counter */
|
|
u32 h_nsmstate; /* true remote NSM state */
|
|
u32 h_pidcount; /* Pseudopids */
|
|
atomic_t h_count; /* reference count */
|
|
struct mutex h_mutex; /* mutex for pmap binding */
|
|
unsigned long h_nextrebind; /* next portmap call */
|
|
unsigned long h_expires; /* eligible for GC */
|
|
struct list_head h_lockowners; /* Lockowners for the client */
|
|
spinlock_t h_lock;
|
|
struct list_head h_granted; /* Locks in GRANTED state */
|
|
struct list_head h_reclaim; /* Locks in RECLAIM state */
|
|
struct nsm_handle *h_nsmhandle; /* NSM status handle */
|
|
char *h_addrbuf; /* address eyecatcher */
|
|
struct net *net; /* host net */
|
|
char nodename[UNX_MAXNODENAME + 1];
|
|
const struct nlmclnt_operations *h_nlmclnt_ops; /* Callback ops for NLM users */
|
|
};
|
|
|
|
/*
|
|
* The largest string sm_addrbuf should hold is a full-size IPv6 address
|
|
* (no "::" anywhere) with a scope ID. The buffer size is computed to
|
|
* hold eight groups of colon-separated four-hex-digit numbers, a
|
|
* percent sign, a scope id (at most 32 bits, in decimal), and NUL.
|
|
*/
|
|
#define NSM_ADDRBUF ((8 * 4 + 7) + (1 + 10) + 1)
|
|
|
|
struct nsm_handle {
|
|
struct list_head sm_link;
|
|
atomic_t sm_count;
|
|
char *sm_mon_name;
|
|
char *sm_name;
|
|
struct sockaddr_storage sm_addr;
|
|
size_t sm_addrlen;
|
|
unsigned int sm_monitored : 1,
|
|
sm_sticky : 1; /* don't unmonitor */
|
|
struct nsm_private sm_priv;
|
|
char sm_addrbuf[NSM_ADDRBUF];
|
|
};
|
|
|
|
/*
|
|
* Rigorous type checking on sockaddr type conversions
|
|
*/
|
|
static inline struct sockaddr_in *nlm_addr_in(const struct nlm_host *host)
|
|
{
|
|
return (struct sockaddr_in *)&host->h_addr;
|
|
}
|
|
|
|
static inline struct sockaddr *nlm_addr(const struct nlm_host *host)
|
|
{
|
|
return (struct sockaddr *)&host->h_addr;
|
|
}
|
|
|
|
static inline struct sockaddr_in *nlm_srcaddr_in(const struct nlm_host *host)
|
|
{
|
|
return (struct sockaddr_in *)&host->h_srcaddr;
|
|
}
|
|
|
|
static inline struct sockaddr *nlm_srcaddr(const struct nlm_host *host)
|
|
{
|
|
return (struct sockaddr *)&host->h_srcaddr;
|
|
}
|
|
|
|
/*
|
|
* Map an fl_owner_t into a unique 32-bit "pid"
|
|
*/
|
|
struct nlm_lockowner {
|
|
struct list_head list;
|
|
atomic_t count;
|
|
|
|
struct nlm_host *host;
|
|
fl_owner_t owner;
|
|
uint32_t pid;
|
|
};
|
|
|
|
struct nlm_wait;
|
|
|
|
/*
|
|
* Memory chunk for NLM client RPC request.
|
|
*/
|
|
#define NLMCLNT_OHSIZE ((__NEW_UTS_LEN) + 10u)
|
|
struct nlm_rqst {
|
|
atomic_t a_count;
|
|
unsigned int a_flags; /* initial RPC task flags */
|
|
struct nlm_host * a_host; /* host handle */
|
|
struct nlm_args a_args; /* arguments */
|
|
struct nlm_res a_res; /* result */
|
|
struct nlm_block * a_block;
|
|
unsigned int a_retries; /* Retry count */
|
|
u8 a_owner[NLMCLNT_OHSIZE];
|
|
void * a_callback_data; /* sent to nlmclnt_operations callbacks */
|
|
};
|
|
|
|
/*
|
|
* This struct describes a file held open by lockd on behalf of
|
|
* an NFS client.
|
|
*/
|
|
struct nlm_file {
|
|
struct hlist_node f_list; /* linked list */
|
|
struct nfs_fh f_handle; /* NFS file handle */
|
|
struct file * f_file; /* VFS file pointer */
|
|
struct nlm_share * f_shares; /* DOS shares */
|
|
struct list_head f_blocks; /* blocked locks */
|
|
unsigned int f_locks; /* guesstimate # of locks */
|
|
unsigned int f_count; /* reference count */
|
|
struct mutex f_mutex; /* avoid concurrent access */
|
|
};
|
|
|
|
/*
|
|
* This is a server block (i.e. a lock requested by some client which
|
|
* couldn't be granted because of a conflicting lock).
|
|
*/
|
|
#define NLM_NEVER (~(unsigned long) 0)
|
|
/* timeout on non-blocking call: */
|
|
#define NLM_TIMEOUT (7 * HZ)
|
|
|
|
struct nlm_block {
|
|
struct kref b_count; /* Reference count */
|
|
struct list_head b_list; /* linked list of all blocks */
|
|
struct list_head b_flist; /* linked list (per file) */
|
|
struct nlm_rqst * b_call; /* RPC args & callback info */
|
|
struct svc_serv * b_daemon; /* NLM service */
|
|
struct nlm_host * b_host; /* host handle for RPC clnt */
|
|
unsigned long b_when; /* next re-xmit */
|
|
unsigned int b_id; /* block id */
|
|
unsigned char b_granted; /* VFS granted lock */
|
|
struct nlm_file * b_file; /* file in question */
|
|
struct cache_req * b_cache_req; /* deferred request handling */
|
|
struct cache_deferred_req * b_deferred_req;
|
|
unsigned int b_flags; /* block flags */
|
|
#define B_QUEUED 1 /* lock queued */
|
|
#define B_GOT_CALLBACK 2 /* got lock or conflicting lock */
|
|
#define B_TIMED_OUT 4 /* filesystem too slow to respond */
|
|
};
|
|
|
|
/*
|
|
* Global variables
|
|
*/
|
|
extern const struct rpc_program nlm_program;
|
|
extern const struct svc_procedure nlmsvc_procedures[];
|
|
#ifdef CONFIG_LOCKD_V4
|
|
extern const struct svc_procedure nlmsvc_procedures4[];
|
|
#endif
|
|
extern int nlmsvc_grace_period;
|
|
extern unsigned long nlmsvc_timeout;
|
|
extern bool nsm_use_hostnames;
|
|
extern u32 nsm_local_state;
|
|
|
|
/*
|
|
* Lockd client functions
|
|
*/
|
|
struct nlm_rqst * nlm_alloc_call(struct nlm_host *host);
|
|
int nlm_async_call(struct nlm_rqst *, u32, const struct rpc_call_ops *);
|
|
int nlm_async_reply(struct nlm_rqst *, u32, const struct rpc_call_ops *);
|
|
void nlmclnt_release_call(struct nlm_rqst *);
|
|
struct nlm_wait * nlmclnt_prepare_block(struct nlm_host *host, struct file_lock *fl);
|
|
void nlmclnt_finish_block(struct nlm_wait *block);
|
|
int nlmclnt_block(struct nlm_wait *block, struct nlm_rqst *req, long timeout);
|
|
__be32 nlmclnt_grant(const struct sockaddr *addr,
|
|
const struct nlm_lock *lock);
|
|
void nlmclnt_recovery(struct nlm_host *);
|
|
int nlmclnt_reclaim(struct nlm_host *, struct file_lock *,
|
|
struct nlm_rqst *);
|
|
void nlmclnt_next_cookie(struct nlm_cookie *);
|
|
|
|
/*
|
|
* Host cache
|
|
*/
|
|
struct nlm_host *nlmclnt_lookup_host(const struct sockaddr *sap,
|
|
const size_t salen,
|
|
const unsigned short protocol,
|
|
const u32 version,
|
|
const char *hostname,
|
|
int noresvport,
|
|
struct net *net);
|
|
void nlmclnt_release_host(struct nlm_host *);
|
|
struct nlm_host *nlmsvc_lookup_host(const struct svc_rqst *rqstp,
|
|
const char *hostname,
|
|
const size_t hostname_len);
|
|
void nlmsvc_release_host(struct nlm_host *);
|
|
struct rpc_clnt * nlm_bind_host(struct nlm_host *);
|
|
void nlm_rebind_host(struct nlm_host *);
|
|
struct nlm_host * nlm_get_host(struct nlm_host *);
|
|
void nlm_shutdown_hosts(void);
|
|
void nlm_shutdown_hosts_net(struct net *net);
|
|
void nlm_host_rebooted(const struct net *net,
|
|
const struct nlm_reboot *);
|
|
|
|
/*
|
|
* Host monitoring
|
|
*/
|
|
int nsm_monitor(const struct nlm_host *host);
|
|
void nsm_unmonitor(const struct nlm_host *host);
|
|
|
|
struct nsm_handle *nsm_get_handle(const struct net *net,
|
|
const struct sockaddr *sap,
|
|
const size_t salen,
|
|
const char *hostname,
|
|
const size_t hostname_len);
|
|
struct nsm_handle *nsm_reboot_lookup(const struct net *net,
|
|
const struct nlm_reboot *info);
|
|
void nsm_release(struct nsm_handle *nsm);
|
|
|
|
/*
|
|
* This is used in garbage collection and resource reclaim
|
|
* A return value != 0 means destroy the lock/block/share
|
|
*/
|
|
typedef int (*nlm_host_match_fn_t)(void *cur, struct nlm_host *ref);
|
|
|
|
/*
|
|
* Server-side lock handling
|
|
*/
|
|
__be32 nlmsvc_lock(struct svc_rqst *, struct nlm_file *,
|
|
struct nlm_host *, struct nlm_lock *, int,
|
|
struct nlm_cookie *, int);
|
|
__be32 nlmsvc_unlock(struct net *net, struct nlm_file *, struct nlm_lock *);
|
|
__be32 nlmsvc_testlock(struct svc_rqst *, struct nlm_file *,
|
|
struct nlm_host *, struct nlm_lock *,
|
|
struct nlm_lock *, struct nlm_cookie *);
|
|
__be32 nlmsvc_cancel_blocked(struct net *net, struct nlm_file *, struct nlm_lock *);
|
|
unsigned long nlmsvc_retry_blocked(void);
|
|
void nlmsvc_traverse_blocks(struct nlm_host *, struct nlm_file *,
|
|
nlm_host_match_fn_t match);
|
|
void nlmsvc_grant_reply(struct nlm_cookie *, __be32);
|
|
void nlmsvc_release_call(struct nlm_rqst *);
|
|
|
|
/*
|
|
* File handling for the server personality
|
|
*/
|
|
__be32 nlm_lookup_file(struct svc_rqst *, struct nlm_file **,
|
|
struct nfs_fh *);
|
|
void nlm_release_file(struct nlm_file *);
|
|
void nlmsvc_mark_resources(struct net *);
|
|
void nlmsvc_free_host_resources(struct nlm_host *);
|
|
void nlmsvc_invalidate_all(void);
|
|
|
|
/*
|
|
* Cluster failover support
|
|
*/
|
|
int nlmsvc_unlock_all_by_sb(struct super_block *sb);
|
|
int nlmsvc_unlock_all_by_ip(struct sockaddr *server_addr);
|
|
|
|
static inline struct inode *nlmsvc_file_inode(struct nlm_file *file)
|
|
{
|
|
return file_inode(file->f_file);
|
|
}
|
|
|
|
static inline int __nlm_privileged_request4(const struct sockaddr *sap)
|
|
{
|
|
const struct sockaddr_in *sin = (struct sockaddr_in *)sap;
|
|
|
|
if (ntohs(sin->sin_port) > 1023)
|
|
return 0;
|
|
|
|
return ipv4_is_loopback(sin->sin_addr.s_addr);
|
|
}
|
|
|
|
#if IS_ENABLED(CONFIG_IPV6)
|
|
static inline int __nlm_privileged_request6(const struct sockaddr *sap)
|
|
{
|
|
const struct sockaddr_in6 *sin6 = (struct sockaddr_in6 *)sap;
|
|
|
|
if (ntohs(sin6->sin6_port) > 1023)
|
|
return 0;
|
|
|
|
if (ipv6_addr_type(&sin6->sin6_addr) & IPV6_ADDR_MAPPED)
|
|
return ipv4_is_loopback(sin6->sin6_addr.s6_addr32[3]);
|
|
|
|
return ipv6_addr_type(&sin6->sin6_addr) & IPV6_ADDR_LOOPBACK;
|
|
}
|
|
#else /* IS_ENABLED(CONFIG_IPV6) */
|
|
static inline int __nlm_privileged_request6(const struct sockaddr *sap)
|
|
{
|
|
return 0;
|
|
}
|
|
#endif /* IS_ENABLED(CONFIG_IPV6) */
|
|
|
|
/*
|
|
* Ensure incoming requests are from local privileged callers.
|
|
*
|
|
* Return TRUE if sender is local and is connecting via a privileged port;
|
|
* otherwise return FALSE.
|
|
*/
|
|
static inline int nlm_privileged_requester(const struct svc_rqst *rqstp)
|
|
{
|
|
const struct sockaddr *sap = svc_addr(rqstp);
|
|
|
|
switch (sap->sa_family) {
|
|
case AF_INET:
|
|
return __nlm_privileged_request4(sap);
|
|
case AF_INET6:
|
|
return __nlm_privileged_request6(sap);
|
|
default:
|
|
return 0;
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Compare two NLM locks.
|
|
* When the second lock is of type F_UNLCK, this acts like a wildcard.
|
|
*/
|
|
static inline int nlm_compare_locks(const struct file_lock *fl1,
|
|
const struct file_lock *fl2)
|
|
{
|
|
return file_inode(fl1->fl_file) == file_inode(fl2->fl_file)
|
|
&& fl1->fl_pid == fl2->fl_pid
|
|
&& fl1->fl_owner == fl2->fl_owner
|
|
&& fl1->fl_start == fl2->fl_start
|
|
&& fl1->fl_end == fl2->fl_end
|
|
&&(fl1->fl_type == fl2->fl_type || fl2->fl_type == F_UNLCK);
|
|
}
|
|
|
|
extern const struct lock_manager_operations nlmsvc_lock_operations;
|
|
|
|
#endif /* __KERNEL__ */
|
|
|
|
#endif /* LINUX_LOCKD_LOCKD_H */
|