mirror of
https://github.com/torvalds/linux.git
synced 2024-12-29 14:21:47 +00:00
b24413180f
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>
176 lines
6.3 KiB
C
176 lines
6.3 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
#ifndef DRBD_STATE_H
|
|
#define DRBD_STATE_H
|
|
|
|
struct drbd_device;
|
|
struct drbd_connection;
|
|
|
|
/**
|
|
* DOC: DRBD State macros
|
|
*
|
|
* These macros are used to express state changes in easily readable form.
|
|
*
|
|
* The NS macros expand to a mask and a value, that can be bit ored onto the
|
|
* current state as soon as the spinlock (req_lock) was taken.
|
|
*
|
|
* The _NS macros are used for state functions that get called with the
|
|
* spinlock. These macros expand directly to the new state value.
|
|
*
|
|
* Besides the basic forms NS() and _NS() additional _?NS[23] are defined
|
|
* to express state changes that affect more than one aspect of the state.
|
|
*
|
|
* E.g. NS2(conn, C_CONNECTED, peer, R_SECONDARY)
|
|
* Means that the network connection was established and that the peer
|
|
* is in secondary role.
|
|
*/
|
|
#define role_MASK R_MASK
|
|
#define peer_MASK R_MASK
|
|
#define disk_MASK D_MASK
|
|
#define pdsk_MASK D_MASK
|
|
#define conn_MASK C_MASK
|
|
#define susp_MASK 1
|
|
#define user_isp_MASK 1
|
|
#define aftr_isp_MASK 1
|
|
#define susp_nod_MASK 1
|
|
#define susp_fen_MASK 1
|
|
|
|
#define NS(T, S) \
|
|
({ union drbd_state mask; mask.i = 0; mask.T = T##_MASK; mask; }), \
|
|
({ union drbd_state val; val.i = 0; val.T = (S); val; })
|
|
#define NS2(T1, S1, T2, S2) \
|
|
({ union drbd_state mask; mask.i = 0; mask.T1 = T1##_MASK; \
|
|
mask.T2 = T2##_MASK; mask; }), \
|
|
({ union drbd_state val; val.i = 0; val.T1 = (S1); \
|
|
val.T2 = (S2); val; })
|
|
#define NS3(T1, S1, T2, S2, T3, S3) \
|
|
({ union drbd_state mask; mask.i = 0; mask.T1 = T1##_MASK; \
|
|
mask.T2 = T2##_MASK; mask.T3 = T3##_MASK; mask; }), \
|
|
({ union drbd_state val; val.i = 0; val.T1 = (S1); \
|
|
val.T2 = (S2); val.T3 = (S3); val; })
|
|
|
|
#define _NS(D, T, S) \
|
|
D, ({ union drbd_state __ns; __ns = drbd_read_state(D); __ns.T = (S); __ns; })
|
|
#define _NS2(D, T1, S1, T2, S2) \
|
|
D, ({ union drbd_state __ns; __ns = drbd_read_state(D); __ns.T1 = (S1); \
|
|
__ns.T2 = (S2); __ns; })
|
|
#define _NS3(D, T1, S1, T2, S2, T3, S3) \
|
|
D, ({ union drbd_state __ns; __ns = drbd_read_state(D); __ns.T1 = (S1); \
|
|
__ns.T2 = (S2); __ns.T3 = (S3); __ns; })
|
|
|
|
enum chg_state_flags {
|
|
CS_HARD = 1 << 0,
|
|
CS_VERBOSE = 1 << 1,
|
|
CS_WAIT_COMPLETE = 1 << 2,
|
|
CS_SERIALIZE = 1 << 3,
|
|
CS_ORDERED = CS_WAIT_COMPLETE + CS_SERIALIZE,
|
|
CS_LOCAL_ONLY = 1 << 4, /* Do not consider a device pair wide state change */
|
|
CS_DC_ROLE = 1 << 5, /* DC = display as connection state change */
|
|
CS_DC_PEER = 1 << 6,
|
|
CS_DC_CONN = 1 << 7,
|
|
CS_DC_DISK = 1 << 8,
|
|
CS_DC_PDSK = 1 << 9,
|
|
CS_DC_SUSP = 1 << 10,
|
|
CS_DC_MASK = CS_DC_ROLE + CS_DC_PEER + CS_DC_CONN + CS_DC_DISK + CS_DC_PDSK,
|
|
CS_IGN_OUTD_FAIL = 1 << 11,
|
|
|
|
/* Make sure no meta data IO is in flight, by calling
|
|
* drbd_md_get_buffer(). Used for graceful detach. */
|
|
CS_INHIBIT_MD_IO = 1 << 12,
|
|
};
|
|
|
|
/* drbd_dev_state and drbd_state are different types. This is to stress the
|
|
small difference. There is no suspended flag (.susp), and no suspended
|
|
while fence handler runs flas (susp_fen). */
|
|
union drbd_dev_state {
|
|
struct {
|
|
#if defined(__LITTLE_ENDIAN_BITFIELD)
|
|
unsigned role:2 ; /* 3/4 primary/secondary/unknown */
|
|
unsigned peer:2 ; /* 3/4 primary/secondary/unknown */
|
|
unsigned conn:5 ; /* 17/32 cstates */
|
|
unsigned disk:4 ; /* 8/16 from D_DISKLESS to D_UP_TO_DATE */
|
|
unsigned pdsk:4 ; /* 8/16 from D_DISKLESS to D_UP_TO_DATE */
|
|
unsigned _unused:1 ;
|
|
unsigned aftr_isp:1 ; /* isp .. imposed sync pause */
|
|
unsigned peer_isp:1 ;
|
|
unsigned user_isp:1 ;
|
|
unsigned _pad:11; /* 0 unused */
|
|
#elif defined(__BIG_ENDIAN_BITFIELD)
|
|
unsigned _pad:11;
|
|
unsigned user_isp:1 ;
|
|
unsigned peer_isp:1 ;
|
|
unsigned aftr_isp:1 ; /* isp .. imposed sync pause */
|
|
unsigned _unused:1 ;
|
|
unsigned pdsk:4 ; /* 8/16 from D_DISKLESS to D_UP_TO_DATE */
|
|
unsigned disk:4 ; /* 8/16 from D_DISKLESS to D_UP_TO_DATE */
|
|
unsigned conn:5 ; /* 17/32 cstates */
|
|
unsigned peer:2 ; /* 3/4 primary/secondary/unknown */
|
|
unsigned role:2 ; /* 3/4 primary/secondary/unknown */
|
|
#else
|
|
# error "this endianess is not supported"
|
|
#endif
|
|
};
|
|
unsigned int i;
|
|
};
|
|
|
|
extern enum drbd_state_rv drbd_change_state(struct drbd_device *device,
|
|
enum chg_state_flags f,
|
|
union drbd_state mask,
|
|
union drbd_state val);
|
|
extern void drbd_force_state(struct drbd_device *, union drbd_state,
|
|
union drbd_state);
|
|
extern enum drbd_state_rv _drbd_request_state(struct drbd_device *,
|
|
union drbd_state,
|
|
union drbd_state,
|
|
enum chg_state_flags);
|
|
|
|
extern enum drbd_state_rv
|
|
_drbd_request_state_holding_state_mutex(struct drbd_device *, union drbd_state,
|
|
union drbd_state, enum chg_state_flags);
|
|
|
|
extern enum drbd_state_rv _drbd_set_state(struct drbd_device *, union drbd_state,
|
|
enum chg_state_flags,
|
|
struct completion *done);
|
|
extern void print_st_err(struct drbd_device *, union drbd_state,
|
|
union drbd_state, int);
|
|
|
|
enum drbd_state_rv
|
|
_conn_request_state(struct drbd_connection *connection, union drbd_state mask, union drbd_state val,
|
|
enum chg_state_flags flags);
|
|
|
|
enum drbd_state_rv
|
|
conn_request_state(struct drbd_connection *connection, union drbd_state mask, union drbd_state val,
|
|
enum chg_state_flags flags);
|
|
|
|
extern void drbd_resume_al(struct drbd_device *device);
|
|
extern bool conn_all_vols_unconf(struct drbd_connection *connection);
|
|
|
|
/**
|
|
* drbd_request_state() - Request a state change
|
|
* @device: DRBD device.
|
|
* @mask: mask of state bits to change.
|
|
* @val: value of new state bits.
|
|
*
|
|
* This is the most graceful way of requesting a state change. It is verbose
|
|
* quite verbose in case the state change is not possible, and all those
|
|
* state changes are globally serialized.
|
|
*/
|
|
static inline int drbd_request_state(struct drbd_device *device,
|
|
union drbd_state mask,
|
|
union drbd_state val)
|
|
{
|
|
return _drbd_request_state(device, mask, val, CS_VERBOSE + CS_ORDERED);
|
|
}
|
|
|
|
/* for use in adm_detach() (drbd_adm_detach(), drbd_adm_down()) */
|
|
enum drbd_state_rv
|
|
drbd_request_detach_interruptible(struct drbd_device *device);
|
|
|
|
enum drbd_role conn_highest_role(struct drbd_connection *connection);
|
|
enum drbd_role conn_highest_peer(struct drbd_connection *connection);
|
|
enum drbd_disk_state conn_highest_disk(struct drbd_connection *connection);
|
|
enum drbd_disk_state conn_lowest_disk(struct drbd_connection *connection);
|
|
enum drbd_disk_state conn_highest_pdsk(struct drbd_connection *connection);
|
|
enum drbd_conns conn_lowest_conn(struct drbd_connection *connection);
|
|
|
|
#endif
|