Gitlab 现已全面支持 git over ssh 与 git over https。通过 HTTPS 访问请配置带有 read_repository / write_repository 权限的 Personal access token。通过 SSH 端口访问请使用 22 端口或 13389 端口。如果使用CAS注册了账户但不知道密码，可以自行至设置中更改；如有其他问题，请发邮件至 service@cra.moe 寻求协助。

Commit b6d0531e authored Dec 02, 2019 by Fabien Dessenne Committed by Jessica Yu Dec 09, 2019

moduleparam: fix kerneldoc



Document missing @arg in xxx_param_cb().
Describe all parameters of module_param_[named_]unsafe() and all
*_param_cb() to make ./scripts/kernel-doc happy.

Acked-by: Randy Dunlap <rdunlap@infradead.org>
Tested-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Fabien Dessenne <fabien.dessenne@st.com>
Signed-off-by: Jessica Yu <jeyu@kernel.org>

parent bf08949c

include/linux/moduleparam.h

+77 −5

Original line number	Diff line number	Diff line
		@@ -128,6 +128,9 @@ struct kparam_array

		/**
		* module_param_unsafe - same as module_param but taints kernel
		* @name: the variable to alter, and exposed parameter name.
		* @type: the type of the parameter
		* @perm: visibility in sysfs.
		*/
		#define module_param_unsafe(name, type, perm) \
		module_param_named_unsafe(name, name, type, perm)
		@@ -150,6 +153,10 @@ struct kparam_array

		/**
		* module_param_named_unsafe - same as module_param_named but taints kernel
		* @name: a valid C identifier which is the parameter name.
		* @value: the actual lvalue to alter.
		* @type: the type of the parameter
		* @perm: visibility in sysfs.
		*/
		#define module_param_named_unsafe(name, value, type, perm) \
		param_check_##type(name, &(value)); \
		@@ -160,6 +167,7 @@ struct kparam_array
		* module_param_cb - general callback for a module/cmdline parameter
		* @name: a valid C identifier which is the parameter name.
		* @ops: the set & get operations for this parameter.
		* @arg: args for @ops
		* @perm: visibility in sysfs.
		*
		* The ops can have NULL set or get functions.
		@@ -171,36 +179,96 @@ struct kparam_array
		__module_param_call(MODULE_PARAM_PREFIX, name, ops, arg, perm, -1, \
		KERNEL_PARAM_FL_UNSAFE)

		#define __level_param_cb(name, ops, arg, perm, level) \
		__module_param_call(MODULE_PARAM_PREFIX, name, ops, arg, perm, level, 0)
		/**
		* <level>_param_cb - general callback for a module/cmdline parameter
		* to be evaluated before certain initcall level
		* core_param_cb - general callback for a module/cmdline parameter
		* to be evaluated before core initcall level
		* @name: a valid C identifier which is the parameter name.
		* @ops: the set & get operations for this parameter.
		* @arg: args for @ops
		* @perm: visibility in sysfs.
		*
		* The ops can have NULL set or get functions.
		*/
		#define __level_param_cb(name, ops, arg, perm, level) \
		__module_param_call(MODULE_PARAM_PREFIX, name, ops, arg, perm, level, 0)

		#define core_param_cb(name, ops, arg, perm) \
		__level_param_cb(name, ops, arg, perm, 1)

		/**
		* postcore_param_cb - general callback for a module/cmdline parameter
		* to be evaluated before postcore initcall level
		* @name: a valid C identifier which is the parameter name.
		* @ops: the set & get operations for this parameter.
		* @arg: args for @ops
		* @perm: visibility in sysfs.
		*
		* The ops can have NULL set or get functions.
		*/
		#define postcore_param_cb(name, ops, arg, perm) \
		__level_param_cb(name, ops, arg, perm, 2)

		/**
		* arch_param_cb - general callback for a module/cmdline parameter
		* to be evaluated before arch initcall level
		* @name: a valid C identifier which is the parameter name.
		* @ops: the set & get operations for this parameter.
		* @arg: args for @ops
		* @perm: visibility in sysfs.
		*
		* The ops can have NULL set or get functions.
		*/
		#define arch_param_cb(name, ops, arg, perm) \
		__level_param_cb(name, ops, arg, perm, 3)

		/**
		* subsys_param_cb - general callback for a module/cmdline parameter
		* to be evaluated before subsys initcall level
		* @name: a valid C identifier which is the parameter name.
		* @ops: the set & get operations for this parameter.
		* @arg: args for @ops
		* @perm: visibility in sysfs.
		*
		* The ops can have NULL set or get functions.
		*/
		#define subsys_param_cb(name, ops, arg, perm) \
		__level_param_cb(name, ops, arg, perm, 4)

		/**
		* fs_param_cb - general callback for a module/cmdline parameter
		* to be evaluated before fs initcall level
		* @name: a valid C identifier which is the parameter name.
		* @ops: the set & get operations for this parameter.
		* @arg: args for @ops
		* @perm: visibility in sysfs.
		*
		* The ops can have NULL set or get functions.
		*/
		#define fs_param_cb(name, ops, arg, perm) \
		__level_param_cb(name, ops, arg, perm, 5)

		/**
		* device_param_cb - general callback for a module/cmdline parameter
		* to be evaluated before device initcall level
		* @name: a valid C identifier which is the parameter name.
		* @ops: the set & get operations for this parameter.
		* @arg: args for @ops
		* @perm: visibility in sysfs.
		*
		* The ops can have NULL set or get functions.
		*/
		#define device_param_cb(name, ops, arg, perm) \
		__level_param_cb(name, ops, arg, perm, 6)

		/**
		* late_param_cb - general callback for a module/cmdline parameter
		* to be evaluated before late initcall level
		* @name: a valid C identifier which is the parameter name.
		* @ops: the set & get operations for this parameter.
		* @arg: args for @ops
		* @perm: visibility in sysfs.
		*
		* The ops can have NULL set or get functions.
		*/
		#define late_param_cb(name, ops, arg, perm) \
		__level_param_cb(name, ops, arg, perm, 7)

		@@ -263,6 +331,10 @@ static inline void kernel_param_unlock(struct module *mod)

		/**
		* core_param_unsafe - same as core_param but taints kernel
		* @name: the name of the cmdline and sysfs parameter (often the same as var)
		* @var: the variable
		* @type: the type of the parameter
		* @perm: visibility in sysfs
		*/
		#define core_param_unsafe(name, var, type, perm) \
		param_check_##type(name, &(var)); \

CRA Git | Maintained and supported by SUSTech CRA and CCSE