History

sched/fair: fix lots of kernel-doc warnings

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

Randy Dunlap committed 14 years ago

Commit cd968911 parent 8f533691 file · +6 −16Browse files

Unified · Split

kernel/sched/fair.c+6−16
@@ -3632,7 +3632,7 @@ fix_small_capacity(struct sched_domain *sd, struct sched_group *group) · 3631 unmodified lines
3632 3632
3633/**3633/**
3634 * update_sg_lb_stats - Update sched_group's statistics for load balancing.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 * @group: sched_group whose statistics are to be updated.3636 * @group: sched_group whose statistics are to be updated.
3637 * @load_idx: Load index of sched_domain of this_cpu for load calc.3637 * @load_idx: Load index of sched_domain of this_cpu for load calc.
3638 * @local_group: Does group contain this_cpu.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 * update_sd_pick_busiest - return 1 on busiest group3743 * update_sd_pick_busiest - return 1 on busiest group
3744 * @sd: sched_domain whose statistics are to be checked3744 * @env: The load balancing environment.
3745 * @sds: sched_domain statistics3745 * @sds: sched_domain statistics
3746 * @sg: sched_group candidate to be checked for being the busiest3746 * @sg: sched_group candidate to be checked for being the busiest
3747 * @sgs: sched_group statistics3747 * @sgs: sched_group statistics
3748 * @this_cpu: the current cpu
3749 *3748 *
3750 * Determine if @sg is a busier group than the previously selected3749 * Determine if @sg is a busier group than the previously selected
3751 * busiest group.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 * update_sd_lb_stats - Update sched_domain's statistics for load balancing.3784 * update_sd_lb_stats - Update sched_domain's statistics for load balancing.
3786 * @sd: sched_domain whose statistics are to be updated.3785 * @env: The load balancing environment.
3787 * @this_cpu: Cpu for which load balance is currently performed.
3788 * @idle: Idle status of this_cpu
3789 * @cpus: Set of cpus considered for load balancing.3786 * @cpus: Set of cpus considered for load balancing.
3790 * @balance: Should we balance.3787 * @balance: Should we balance.
3791 * @sds: variable to hold the statistics for this sched_domain.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 * Returns 1 when packing is required and a task should be moved to3871 * Returns 1 when packing is required and a task should be moved to
3875 * this CPU. The amount of the imbalance is returned in *imbalance.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 * @sds: Statistics of the sched_domain which is to be packed3875 * @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 */
3882static int check_asym_packing(struct lb_env *env, struct sd_lb_stats *sds)3877static 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 * fix_small_imbalance - Calculate the minor imbalance that exists3898 * fix_small_imbalance - Calculate the minor imbalance that exists
3904 * amongst the groups of a sched_domain, during3899 * amongst the groups of a sched_domain, during
3905 * load balancing.3900 * load balancing.
3901 * @env: The load balancing environment.
3906 * @sds: Statistics of the sched_domain whose imbalance is to be calculated.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 */
3910static inline3904static inline
3911void fix_small_imbalance(struct lb_env *env, struct sd_lb_stats *sds)3905void 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 * Also calculates the amount of weighted load which should be moved4042 * Also calculates the amount of weighted load which should be moved
4049 * to restore balance.4043 * to restore balance.
4050 *4044 *
4051 * @sd: The sched_domain whose busiest group is to be returned.4045 * @env: The load balancing environment.
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.
4056 * @cpus: The set of CPUs under consideration for load-balancing.4046 * @cpus: The set of CPUs under consideration for load-balancing.
4057 * @balance: Pointer to a variable indicating if this_cpu4047 * @balance: Pointer to a variable indicating if this_cpu
4058 * is the appropriate cpu to perform load balancing at this_level.4048 * is the appropriate cpu to perform load balancing at this_level.