linux-kernel - Re: [PATCH] PM / devfreq: add comments and Documentation

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <CA+Z25wX5a4_NFX0xGTWEcPkB=625m9w=OvDgM6o4WgPo3iHqNw@mail.gmail.com>
Date:	Tue, 5 Feb 2013 21:11:59 +0530
From:	Rajagopal Venkat <rajagopal.venkat@...aro.org>
To:	MyungJoo Ham <myungjoo.ham@...sung.com>
Cc:	linux-pm@...r.kernel.org, linux-kernel@...r.kernel.org,
	rafael.j.wysocki@...el.com, nm@...com, a.kesavan@...sung.com,
	jonghwa3.lee@...sung.com, sangjung.woo@...sung.com,
	myungjoo.ham@...il.com
Subject: Re: [PATCH] PM / devfreq: add comments and Documentation

On 5 February 2013 15:15, MyungJoo Ham <myungjoo.ham@...sung.com> wrote:
> - Added missing ABI documents
> - Added comments to clarify the objectives of functions
>
> Signed-off-by: MyungJoo Ham <myungjoo.ham@...sung.com>
Acked-by: Rajagopal Venkat <rajagopal.venkat@...aro.org>

> ---
>  Documentation/ABI/testing/sysfs-class-devfreq |   20 ++++++++++++++++++++
>  drivers/devfreq/devfreq.c                     |   10 ++++++++++
>  include/linux/devfreq.h                       |    2 ++
>  3 files changed, 32 insertions(+), 0 deletions(-)
>
> diff --git a/Documentation/ABI/testing/sysfs-class-devfreq b/Documentation/ABI/testing/sysfs-class-devfreq
> index 0ba6ea2..ee39aca 100644
> --- a/Documentation/ABI/testing/sysfs-class-devfreq
> +++ b/Documentation/ABI/testing/sysfs-class-devfreq
> @@ -78,3 +78,23 @@ Contact:     Nishanth Menon <nm@...com>
>  Description:
>                 The /sys/class/devfreq/.../available_governors shows
>                 currently available governors in the system.
> +
> +What:          /sys/class/devfreq/.../min_freq
> +Date:          January 2013
> +Contact:       MyungJoo Ham <myungjoo.ham@...sung.com>
> +Description:
> +               The /sys/class/devfreq/.../min_freq shows and stores
> +               the minimum frequency requested by users. It is 0 if
> +               the user does not care. min_freq overrides the
> +               frequency requested by governors.
> +
> +What:          /sys/class/devfreq/.../max_freq
> +Date:          January 2013
> +Contact:       MyungJoo Ham <myungjoo.ham@...sung.com>
> +Description:
> +               The /sys/class/devfreq/.../max_freq shows and stores
> +               the maximum frequency requested by users. It is 0 if
> +               the user does not care. max_freq overrides the
> +               frequency requested by governors and min_freq.
> +               The max_freq overrides min_freq because max_freq may be
> +               used to throttle devices to avoid overheating.
> diff --git a/drivers/devfreq/devfreq.c b/drivers/devfreq/devfreq.c
> index abfa14d..44c4079 100644
> --- a/drivers/devfreq/devfreq.c
> +++ b/drivers/devfreq/devfreq.c
> @@ -527,6 +527,8 @@ EXPORT_SYMBOL(devfreq_add_device);
>  /**
>   * devfreq_remove_device() - Remove devfreq feature from a device.
>   * @devfreq:   the devfreq instance to be removed
> + *
> + * The opposite of devfreq_add_device().
>   */
>  int devfreq_remove_device(struct devfreq *devfreq)
>  {
> @@ -542,6 +544,10 @@ EXPORT_SYMBOL(devfreq_remove_device);
>  /**
>   * devfreq_suspend_device() - Suspend devfreq of a device.
>   * @devfreq: the devfreq instance to be suspended
> + *
> + * This function is intended to be called by the pm callbacks
> + * (e.g., runtime_suspend, suspend) of the device driver that
> + * holds the devfreq.
>   */
>  int devfreq_suspend_device(struct devfreq *devfreq)
>  {
> @@ -559,6 +565,10 @@ EXPORT_SYMBOL(devfreq_suspend_device);
>  /**
>   * devfreq_resume_device() - Resume devfreq of a device.
>   * @devfreq: the devfreq instance to be resumed
> + *
> + * This function is intended to be called by the pm callbacks
> + * (e.g., runtime_resume, resume) of the device driver that
> + * holds the devfreq.
>   */
>  int devfreq_resume_device(struct devfreq *devfreq)
>  {
> diff --git a/include/linux/devfreq.h b/include/linux/devfreq.h
> index e83ef39..04ad61d 100644
> --- a/include/linux/devfreq.h
> +++ b/include/linux/devfreq.h
> @@ -181,6 +181,8 @@ extern struct devfreq *devfreq_add_device(struct device *dev,
>                                   const char *governor_name,
>                                   void *data);
>  extern int devfreq_remove_device(struct devfreq *devfreq);
> +
> +/* Supposed to be called by PM_SLEEP/PM_RUNTIME callbacks */
>  extern int devfreq_suspend_device(struct devfreq *devfreq);
>  extern int devfreq_resume_device(struct devfreq *devfreq);
>
> --
> 1.7.5.4
>



-- 
Regards,
Rajagopal
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/