1 // SPDX-License-Identifier: GPL-2.0-only
4  * Copyright (c) 2012-2013, The Linux Foundation. All rights reserved.
18  * struct qcom_smem_state - state context
39  * qcom_smem_state_update_bits() - update the masked bits in state with value
50 	if (state->orphan)  in qcom_smem_state_update_bits()
51 		return -ENXIO;  in qcom_smem_state_update_bits()
53 	if (!state->ops.update_bits)  in qcom_smem_state_update_bits()
54 		return -ENOTSUPP;  in qcom_smem_state_update_bits()
56 	return state->ops.update_bits(state->priv, mask, value);  in qcom_smem_state_update_bits()
67 		if (state->of_node == np) {  in of_node_to_state()
68 			kref_get(&state->refcount);  in of_node_to_state()
72 	return ERR_PTR(-EPROBE_DEFER);  in of_node_to_state()
76  * qcom_smem_state_get() - acquire handle to a state
94 		index = of_property_match_string(dev->of_node,  in qcom_smem_state_get()
95 						 "qcom,smem-state-names",  in qcom_smem_state_get()
98 			dev_err(dev, "missing qcom,smem-state-names\n");  in qcom_smem_state_get()
103 	ret = of_parse_phandle_with_args(dev->of_node,  in qcom_smem_state_get()
104 					 "qcom,smem-states",  in qcom_smem_state_get()
105 					 "#qcom,smem-state-cells",  in qcom_smem_state_get()
109 		dev_err(dev, "failed to parse qcom,smem-states property\n");  in qcom_smem_state_get()
114 		dev_err(dev, "invalid #qcom,smem-state-cells\n");  in qcom_smem_state_get()
115 		state = ERR_PTR(-EINVAL);  in qcom_smem_state_get()
135 	list_del(&state->list);  in qcom_smem_state_release()
136 	of_node_put(state->of_node);  in qcom_smem_state_release()
141  * qcom_smem_state_put() - release state handle
147 	kref_put(&state->refcount, qcom_smem_state_release);  in qcom_smem_state_put()
158  * devm_qcom_smem_state_get() - acquire handle to a devres managed state
174 		return ERR_PTR(-ENOMEM);  in devm_qcom_smem_state_get()
189  * qcom_smem_state_register() - register a new state
202 		return ERR_PTR(-ENOMEM);  in qcom_smem_state_register()
204 	kref_init(&state->refcount);  in qcom_smem_state_register()
206 	state->of_node = of_node_get(of_node);  in qcom_smem_state_register()
207 	state->ops = *ops;  in qcom_smem_state_register()
208 	state->priv = priv;  in qcom_smem_state_register()
211 	list_add(&state->list, &smem_states);  in qcom_smem_state_register()
219  * qcom_smem_state_unregister() - unregister a registered state
224 	state->orphan = true;  in qcom_smem_state_unregister()