From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754599AbcDGCtX (ORCPT ); Wed, 6 Apr 2016 22:49:23 -0400 Received: from mailout2.samsung.com ([203.254.224.25]:51922 "EHLO mailout2.samsung.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753508AbcDGCtV (ORCPT ); Wed, 6 Apr 2016 22:49:21 -0400 X-AuditID: cbfee68f-f79c86d0000012ad-b7-5705caad6a1f From: Andi Shyti To: linux-doc@vger.kernel.org Cc: Michael Turquette , Jonathan Corbet , linux-kernel@vger.kernel.org, Andi Shyti Subject: [PATCH] Documentation: clk: update file names containing referenced structures Date: Thu, 07 Apr 2016 11:48:53 +0900 Message-id: <1459997333-29884-1-git-send-email-andi.shyti@samsung.com> X-Mailer: git-send-email 2.8.0.rc3 X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFtrMLMWRmVeSWpSXmKPExsWyRsSkQHftKdZwg/VfjS0W/3jOZPHkQDuj xcK2JSwWl3fNYbO4eMrVgdXj/Y1Wdo/rSz4xeyzum8zq8XmTXABLFJdNSmpOZllqkb5dAlfG 2p+9jAUHpCtePJ7P2MD4R6SLkZNDQsBEYtXf5UwQtpjEhXvr2boYuTiEBFYwSlw6v4kJpujk giNMEImljBJXHn9mBUkICXxklFi5VRzEZhPQlGi6/YMNxBYRkJX4ufEiM4jNLDCJUWLLJFkQ W1ggUmJLx1FGEJtFQFXi3/v77CA2r4CbxNNdF5ghlilJbHhwAWyZhMB7NolVG/ezQTQISHyb fIili5EDKCErsekAVL2kxMEVN1gmMAouYGRYxSiaWpBcUJyUXmSsV5yYW1yal66XnJ+7iREY lqf/PevfwXj3gPUhRgEORiUeXotO1nAh1sSy4srcQ4ymQBsmMkuJJucDgz+vJN7Q2MzIwtTE 1NjI3NJMSZx3odTPYCGB9MSS1OzU1ILUovii0pzU4kOMTBycUg2Mgfe4b52KcA6dwGIbbjDh IV/jwhXcNr3H15VFsTRIZy+oi7N59kzh3PbsRYa5d8IW3XBZff3uZvYsjW0/De+6WX58WClw sWRZspG51lmH76+Z7zy9XymQH3gyq/FykJu+wK1Zbx/nVO9sWbxJebUcj+OVfRo/NWtW7/z9 g2dR/pOVURw8RTbJSizFGYmGWsxFxYkAclQhs0YCAAA= X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFmpgkeLIzCtJLcpLzFFi42I5/e+xgO7aU6zhBjsf61ks/vGcyeLJgXZG i4VtS1gsLu+aw2Zx8ZSrA6vH+xut7B7Xl3xi9ljcN5nV4/MmuQCWqAZGm4zUxJTUIoXUvOT8 lMy8dFsl7+B453hTMwNDXUNLC3MlhbzE3FRbJRefAF23zBygvUoKZYk5pUChgMTiYiV9O0wT QkPcdC1gGiN0fUOC4HqMDNBAwhrGjLU/exkLDkhXvHg8n7GB8Y9IFyMnh4SAicTJBUeYIGwx iQv31rN1MXJxCAksZZS48vgzK0hCSOAjo8TKreIgNpuApkTT7R9sILaIgKzEz40XmUFsZoFJ jBJbJsmC2MICkRJbOo4ygtgsAqoS/97fZwexeQXcJJ7uusAMsUxJYsODC0wTGLkXMDKsYpRI LUguKE5KzzXMSy3XK07MLS7NS9dLzs/dxAgO/WdSOxgP7nI/xCjAwajEw2vRyRouxJpYVlyZ e4hRgoNZSYR3wkmgEG9KYmVValF+fFFpTmrxIUZToAMmMkuJJucD4zKvJN7Q2MTMyNLI3NDC yNhcSZz38f91YUIC6YklqdmpqQWpRTB9TBycUg2MRwRTZ+YdenbrqvZOryfr9i1NiLr/ufhZ ZOVdj2XzeF73bP15tmVdlGXzQe3aC29uLNG/rPl5/60pP2vMcu7Kbzu5I1TobvbVo04uualz 4uPDZjidv1XvdH6igcjyZJ/wDuW9avXeF/eUBe5LmBPmVyTZcmhSScSzD6ec5hf17J/0UvHG ROYNXEosxRmJhlrMRcWJAL0WhYuTAgAA DLP-Filter: Pass X-MTR: 20000000000000000@CPGS X-CFilter-Loop: Reflected Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Commit 'b09d6d991' removes include/linux/clk-private.h and re-arranges the clock related structures contained in it in different files. The documentation has not been updated accordingly, thus it wasn't anymore consistent. Place the structures referenced by Documentation/clk.txt in the correct files and update their contents to the latest status. Signed-off-by: Andi Shyti --- Documentation/clk.txt | 44 +++++++++++++++++++++++--------------------- 1 file changed, 23 insertions(+), 21 deletions(-) diff --git a/Documentation/clk.txt b/Documentation/clk.txt index 5c4bc4d..4c106fd 100644 --- a/Documentation/clk.txt +++ b/Documentation/clk.txt @@ -38,17 +38,18 @@ clock interface. Part 2 - common data structures and api Below is the common struct clk definition from -include/linux/clk-private.h, modified for brevity: - - struct clk { - const char *name; - const struct clk_ops *ops; - struct clk_hw *hw; - char **parent_names; - struct clk **parents; - struct clk *parent; - struct hlist_head children; - struct hlist_node child_node; +include/linux/clk.c, modified for brevity: + + struct clk_core { + const char *name; + const struct clk_ops *ops; + struct clk_hw *hw; + struct module *owner; + struct clk_core *parent; + const char **parent_names; + struct clk_core **parents; + u8 num_parents; + u8 new_parent_index; ... }; @@ -58,35 +59,36 @@ struct clk. That api is documented in include/linux/clk.h. Platforms and devices utilizing the common struct clk use the struct clk_ops pointer in struct clk to perform the hardware-specific parts of -the operations defined in clk.h: +the operations defined in clk-provider.h: struct clk_ops { int (*prepare)(struct clk_hw *hw); void (*unprepare)(struct clk_hw *hw); + int (*is_prepared)(struct clk_hw *hw); + void (*unprepare_unused)(struct clk_hw *hw); int (*enable)(struct clk_hw *hw); void (*disable)(struct clk_hw *hw); int (*is_enabled)(struct clk_hw *hw); + void (*disable_unused)(struct clk_hw *hw); unsigned long (*recalc_rate)(struct clk_hw *hw, unsigned long parent_rate); - long (*round_rate)(struct clk_hw *hw, - unsigned long rate, + long (*round_rate)(struct clk_hw *hw, unsigned long rate, unsigned long *parent_rate); int (*determine_rate)(struct clk_hw *hw, struct clk_rate_request *req); int (*set_parent)(struct clk_hw *hw, u8 index); u8 (*get_parent)(struct clk_hw *hw); - int (*set_rate)(struct clk_hw *hw, - unsigned long rate, + int (*set_rate)(struct clk_hw *hw, unsigned long rate, unsigned long parent_rate); int (*set_rate_and_parent)(struct clk_hw *hw, unsigned long rate, - unsigned long parent_rate, - u8 index); + unsigned long parent_rate, u8 index); unsigned long (*recalc_accuracy)(struct clk_hw *hw, - unsigned long parent_accuracy); + unsigned long parent_accuracy); + int (*get_phase)(struct clk_hw *hw); + int (*set_phase)(struct clk_hw *hw, int degrees); void (*init)(struct clk_hw *hw); - int (*debug_init)(struct clk_hw *hw, - struct dentry *dentry); + int (*debug_init)(struct clk_hw *hw, struct dentry *dentry); }; Part 3 - hardware clk implementations -- 2.8.0.rc3