732-v5.13-0003-of-base-Fix-some-formatting-issues-and-provide-missi.patch 4.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495
  1. From 3637d49e11219512920aca8b8ccd0994be33fa8b Mon Sep 17 00:00:00 2001
  2. From: Lee Jones <[email protected]>
  3. Date: Thu, 18 Mar 2021 10:40:30 +0000
  4. Subject: [PATCH] of: base: Fix some formatting issues and provide missing
  5. descriptions
  6. Fixes the following W=1 kernel build warning(s):
  7. drivers/of/base.c:315: warning: Function parameter or member 'cpun' not described in '__of_find_n_match_cpu_property'
  8. drivers/of/base.c:315: warning: Function parameter or member 'prop_name' not described in '__of_find_n_match_cpu_property'
  9. drivers/of/base.c:315: warning: Function parameter or member 'cpu' not described in '__of_find_n_match_cpu_property'
  10. drivers/of/base.c:315: warning: Function parameter or member 'thread' not described in '__of_find_n_match_cpu_property'
  11. drivers/of/base.c:315: warning: expecting prototype for property holds the physical id of the(). Prototype was for __of_find_n_match_cpu_property() instead
  12. drivers/of/base.c:1139: warning: Function parameter or member 'match' not described in 'of_find_matching_node_and_match'
  13. drivers/of/base.c:1779: warning: Function parameter or member 'np' not described in '__of_add_property'
  14. drivers/of/base.c:1779: warning: Function parameter or member 'prop' not described in '__of_add_property'
  15. drivers/of/base.c:1800: warning: Function parameter or member 'np' not described in 'of_add_property'
  16. drivers/of/base.c:1800: warning: Function parameter or member 'prop' not described in 'of_add_property'
  17. drivers/of/base.c:1849: warning: Function parameter or member 'np' not described in 'of_remove_property'
  18. drivers/of/base.c:1849: warning: Function parameter or member 'prop' not described in 'of_remove_property'
  19. drivers/of/base.c:2137: warning: Function parameter or member 'dn' not described in 'of_console_check'
  20. drivers/of/base.c:2137: warning: Function parameter or member 'name' not described in 'of_console_check'
  21. drivers/of/base.c:2137: warning: Function parameter or member 'index' not described in 'of_console_check'
  22. Cc: Rob Herring <[email protected]>
  23. Cc: Frank Rowand <[email protected]>
  24. Cc: "David S. Miller" <[email protected]>
  25. Cc: [email protected]
  26. Signed-off-by: Lee Jones <[email protected]>
  27. Signed-off-by: Rob Herring <[email protected]>
  28. Link: https://lore.kernel.org/r/[email protected]
  29. ---
  30. drivers/of/base.c | 16 +++++++++++-----
  31. 1 file changed, 11 insertions(+), 5 deletions(-)
  32. --- a/drivers/of/base.c
  33. +++ b/drivers/of/base.c
  34. @@ -305,7 +305,7 @@ bool __weak arch_match_cpu_phys_id(int c
  35. return (u32)phys_id == cpu;
  36. }
  37. -/**
  38. +/*
  39. * Checks if the given "prop_name" property holds the physical id of the
  40. * core/thread corresponding to the logical cpu 'cpu'. If 'thread' is not
  41. * NULL, local thread number within the core is returned in it.
  42. @@ -1128,7 +1128,7 @@ EXPORT_SYMBOL(of_match_node);
  43. * will; typically, you pass what the previous call
  44. * returned. of_node_put() will be called on it
  45. * @matches: array of of device match structures to search in
  46. - * @match Updated to point at the matches entry which matched
  47. + * @match: Updated to point at the matches entry which matched
  48. *
  49. * Returns a node pointer with refcount incremented, use
  50. * of_node_put() on it when done.
  51. @@ -1779,6 +1779,8 @@ EXPORT_SYMBOL(of_count_phandle_with_args
  52. /**
  53. * __of_add_property - Add a property to a node without lock operations
  54. + * @np: Caller's Device Node
  55. + * @prob: Property to add
  56. */
  57. int __of_add_property(struct device_node *np, struct property *prop)
  58. {
  59. @@ -1800,6 +1802,8 @@ int __of_add_property(struct device_node
  60. /**
  61. * of_add_property - Add a property to a node
  62. + * @np: Caller's Device Node
  63. + * @prob: Property to add
  64. */
  65. int of_add_property(struct device_node *np, struct property *prop)
  66. {
  67. @@ -1844,6 +1848,8 @@ int __of_remove_property(struct device_n
  68. /**
  69. * of_remove_property - Remove a property from a node.
  70. + * @np: Caller's Device Node
  71. + * @prob: Property to remove
  72. *
  73. * Note that we don't actually remove it, since we have given out
  74. * who-knows-how-many pointers to the data using get-property.
  75. @@ -2130,9 +2136,9 @@ EXPORT_SYMBOL_GPL(of_alias_get_highest_i
  76. /**
  77. * of_console_check() - Test and setup console for DT setup
  78. - * @dn - Pointer to device node
  79. - * @name - Name to use for preferred console without index. ex. "ttyS"
  80. - * @index - Index to use for preferred console.
  81. + * @dn: Pointer to device node
  82. + * @name: Name to use for preferred console without index. ex. "ttyS"
  83. + * @index: Index to use for preferred console.
  84. *
  85. * Check if the given device node matches the stdout-path property in the
  86. * /chosen node. If it does then register it as the preferred console and return