Fix lots of new kernel-doc warnings in kernel/sched/fair.c: Warning(kernel/sched/fair.c:3625): No description found for parameter 'env' Warning(kernel/sched/fair.c:3625): Excess function parameter 'sd' description in 'update_sg_lb_stats' Warning(kernel/sched/fair.c:3735): No description found for parameter 'env' Warning(kernel/sched/fair.c:3735): Excess function parameter 'sd' description in 'update_sd_pick_busiest' Warning(kernel/sched/fair.c:3735): Excess function parameter 'this_cpu' description in 'update_sd_pick_busiest' .. more warnings
Unified · Split
| @@ -3632,7 +3632,7 @@ fix_small_capacity(struct sched_domain *sd, struct sched_group *group) · 3631 unmodified lines | ||
| 3632 | 3632 | |
| 3633 | 3633 | /** |
| 3634 | 3634 | * update_sg_lb_stats - Update sched_group's statistics for load balancing. |
| 3635 | − * @sd: The sched_domain whose statistics are to be updated. | |
| 3635 | + * @env: The load balancing environment. | |
| 3636 | 3636 | * @group: sched_group whose statistics are to be updated. |
| 3637 | 3637 | * @load_idx: Load index of sched_domain of this_cpu for load calc. |
| 3638 | 3638 | * @local_group: Does group contain this_cpu. |
| @@ -3741,11 +3741,10 @@ static inline void update_sg_lb_stats(struct lb_env *env, · 102 unmodified lines | ||
| 3741 | 3741 | |
| 3742 | 3742 | /** |
| 3743 | 3743 | * update_sd_pick_busiest - return 1 on busiest group |
| 3744 | − * @sd: sched_domain whose statistics are to be checked | |
| 3744 | + * @env: The load balancing environment. | |
| 3745 | 3745 | * @sds: sched_domain statistics |
| 3746 | 3746 | * @sg: sched_group candidate to be checked for being the busiest |
| 3747 | 3747 | * @sgs: sched_group statistics |
| 3748 | − * @this_cpu: the current cpu | |
| 3749 | 3748 | * |
| 3750 | 3749 | * Determine if @sg is a busier group than the previously selected |
| 3751 | 3750 | * busiest group. |
| @@ -3783,9 +3782,7 @@ static bool update_sd_pick_busiest(struct lb_env *env, · 31 unmodified lines | ||
| 3783 | 3782 | |
| 3784 | 3783 | /** |
| 3785 | 3784 | * update_sd_lb_stats - Update sched_domain's statistics for load balancing. |
| 3786 | − * @sd: sched_domain whose statistics are to be updated. | |
| 3787 | − * @this_cpu: Cpu for which load balance is currently performed. | |
| 3788 | − * @idle: Idle status of this_cpu | |
| 3785 | + * @env: The load balancing environment. | |
| 3789 | 3786 | * @cpus: Set of cpus considered for load balancing. |
| 3790 | 3787 | * @balance: Should we balance. |
| 3791 | 3788 | * @sds: variable to hold the statistics for this sched_domain. |
| @@ -3874,10 +3871,8 @@ static inline void update_sd_lb_stats(struct lb_env *env, · 82 unmodified lines | ||
| 3874 | 3871 | * Returns 1 when packing is required and a task should be moved to |
| 3875 | 3872 | * this CPU. The amount of the imbalance is returned in *imbalance. |
| 3876 | 3873 | * |
| 3877 | − * @sd: The sched_domain whose packing is to be checked. | |
| 3874 | + * @env: The load balancing environment. | |
| 3878 | 3875 | * @sds: Statistics of the sched_domain which is to be packed |
| 3879 | − * @this_cpu: The cpu at whose sched_domain we're performing load-balance. | |
| 3880 | − * @imbalance: returns amount of imbalanced due to packing. | |
| 3881 | 3876 | */ |
| 3882 | 3877 | static int check_asym_packing(struct lb_env *env, struct sd_lb_stats *sds) |
| 3883 | 3878 | { |
| @@ -3903,9 +3898,8 @@ static int check_asym_packing(struct lb_env *env, struct sd_lb_stats *sds) · 19 unmodified lines | ||
| 3903 | 3898 | * fix_small_imbalance - Calculate the minor imbalance that exists |
| 3904 | 3899 | * amongst the groups of a sched_domain, during |
| 3905 | 3900 | * load balancing. |
| 3901 | + * @env: The load balancing environment. | |
| 3906 | 3902 | * @sds: Statistics of the sched_domain whose imbalance is to be calculated. |
| 3907 | − * @this_cpu: The cpu at whose sched_domain we're performing load-balance. | |
| 3908 | − * @imbalance: Variable to store the imbalance. | |
| 3909 | 3903 | */ |
| 3910 | 3904 | static inline |
| 3911 | 3905 | void fix_small_imbalance(struct lb_env *env, struct sd_lb_stats *sds) |
| @@ -4048,11 +4042,7 @@ static inline void calculate_imbalance(struct lb_env *env, struct sd_lb_stats *s · 136 unmodified lines | ||
| 4048 | 4042 | * Also calculates the amount of weighted load which should be moved |
| 4049 | 4043 | * to restore balance. |
| 4050 | 4044 | * |
| 4051 | − * @sd: The sched_domain whose busiest group is to be returned. | |
| 4052 | − * @this_cpu: The cpu for which load balancing is currently being performed. | |
| 4053 | − * @imbalance: Variable which stores amount of weighted load which should | |
| 4054 | − * be moved to restore balance/put a group to idle. | |
| 4055 | − * @idle: The idle status of this_cpu. | |
| 4045 | + * @env: The load balancing environment. | |
| 4056 | 4046 | * @cpus: The set of CPUs under consideration for load-balancing. |
| 4057 | 4047 | * @balance: Pointer to a variable indicating if this_cpu |
| 4058 | 4048 | * is the appropriate cpu to perform load balancing at this_level. |