root/drivers/misc/rpmb-core.c
// SPDX-License-Identifier: GPL-2.0
/*
 * Copyright(c) 2015 - 2019 Intel Corporation. All rights reserved.
 * Copyright(c) 2021 - 2024 Linaro Ltd.
 */
#include <linux/device.h>
#include <linux/init.h>
#include <linux/kernel.h>
#include <linux/list.h>
#include <linux/module.h>
#include <linux/mutex.h>
#include <linux/rpmb.h>
#include <linux/slab.h>

static DEFINE_IDA(rpmb_ida);

/**
 * rpmb_dev_get() - increase rpmb device ref counter
 * @rdev: rpmb device
 */
struct rpmb_dev *rpmb_dev_get(struct rpmb_dev *rdev)
{
        if (rdev)
                get_device(&rdev->dev);
        return rdev;
}
EXPORT_SYMBOL_GPL(rpmb_dev_get);

/**
 * rpmb_dev_put() - decrease rpmb device ref counter
 * @rdev: rpmb device
 */
void rpmb_dev_put(struct rpmb_dev *rdev)
{
        if (rdev)
                put_device(&rdev->dev);
}
EXPORT_SYMBOL_GPL(rpmb_dev_put);

/**
 * rpmb_route_frames() - route rpmb frames to rpmb device
 * @rdev:       rpmb device
 * @req:        rpmb request frames
 * @req_len:    length of rpmb request frames in bytes
 * @rsp:        rpmb response frames
 * @rsp_len:    length of rpmb response frames in bytes
 *
 * Returns: < 0 on failure
 */
int rpmb_route_frames(struct rpmb_dev *rdev, u8 *req,
                      unsigned int req_len, u8 *rsp, unsigned int rsp_len)
{
        if (!req || !req_len || !rsp || !rsp_len)
                return -EINVAL;

        return rdev->descr.route_frames(rdev->dev.parent, req, req_len,
                                        rsp, rsp_len);
}
EXPORT_SYMBOL_GPL(rpmb_route_frames);

static void rpmb_dev_release(struct device *dev)
{
        struct rpmb_dev *rdev = to_rpmb_dev(dev);

        ida_free(&rpmb_ida, rdev->id);
        kfree(rdev->descr.dev_id);
        kfree(rdev);
}

static struct class rpmb_class = {
        .name = "rpmb",
        .dev_release = rpmb_dev_release,
};

/**
 * rpmb_dev_find_device() - return first matching rpmb device
 * @start: rpmb device to begin with
 * @data: data for the match function
 * @match: the matching function
 *
 * Iterate over registered RPMB devices, and call @match() for each passing
 * it the RPMB device and @data.
 *
 * The return value of @match() is checked for each call. If it returns
 * anything other 0, break and return the found RPMB device.
 *
 * It's the callers responsibility to call rpmb_dev_put() on the returned
 * device, when it's done with it.
 *
 * Returns: a matching rpmb device or NULL on failure
 */
struct rpmb_dev *rpmb_dev_find_device(const void *data,
                                      const struct rpmb_dev *start,
                                      int (*match)(struct device *dev,
                                                   const void *data))
{
        struct device *dev;
        const struct device *start_dev = NULL;

        if (start)
                start_dev = &start->dev;
        dev = class_find_device(&rpmb_class, start_dev, data, match);

        return dev ? to_rpmb_dev(dev) : NULL;
}
EXPORT_SYMBOL_GPL(rpmb_dev_find_device);

int rpmb_interface_register(struct class_interface *intf)
{
        intf->class = &rpmb_class;

        return class_interface_register(intf);
}
EXPORT_SYMBOL_GPL(rpmb_interface_register);

void rpmb_interface_unregister(struct class_interface *intf)
{
        class_interface_unregister(intf);
}
EXPORT_SYMBOL_GPL(rpmb_interface_unregister);

/**
 * rpmb_dev_unregister() - unregister RPMB partition from the RPMB subsystem
 * @rdev: the rpmb device to unregister
 *
 * This function should be called from the release function of the
 * underlying device used when the RPMB device was registered.
 *
 * Returns: < 0 on failure
 */
int rpmb_dev_unregister(struct rpmb_dev *rdev)
{
        if (!rdev)
                return -EINVAL;

        device_del(&rdev->dev);

        rpmb_dev_put(rdev);

        return 0;
}
EXPORT_SYMBOL_GPL(rpmb_dev_unregister);

/**
 * rpmb_dev_register - register RPMB partition with the RPMB subsystem
 * @dev: storage device of the rpmb device
 * @descr: RPMB device description
 *
 * While registering the RPMB partition extract needed device information
 * while needed resources are available.
 *
 * Returns: a pointer to a 'struct rpmb_dev' or an ERR_PTR on failure
 */
struct rpmb_dev *rpmb_dev_register(struct device *dev,
                                   struct rpmb_descr *descr)
{
        struct rpmb_dev *rdev;
        int ret;

        if (!dev || !descr || !descr->route_frames || !descr->dev_id ||
            !descr->dev_id_len)
                return ERR_PTR(-EINVAL);

        rdev = kzalloc_obj(*rdev);
        if (!rdev)
                return ERR_PTR(-ENOMEM);
        rdev->descr = *descr;
        rdev->descr.dev_id = kmemdup(descr->dev_id, descr->dev_id_len,
                                     GFP_KERNEL);
        if (!rdev->descr.dev_id) {
                ret = -ENOMEM;
                goto err_free_rdev;
        }

        ret = ida_alloc(&rpmb_ida, GFP_KERNEL);
        if (ret < 0)
                goto err_free_dev_id;
        rdev->id = ret;

        dev_set_name(&rdev->dev, "rpmb%d", rdev->id);
        rdev->dev.class = &rpmb_class;
        rdev->dev.parent = dev;

        ret = device_register(&rdev->dev);
        if (ret) {
                put_device(&rdev->dev);
                return ERR_PTR(ret);
        }

        dev_dbg(&rdev->dev, "registered device\n");

        return rdev;

err_free_dev_id:
        kfree(rdev->descr.dev_id);
err_free_rdev:
        kfree(rdev);
        return ERR_PTR(ret);
}
EXPORT_SYMBOL_GPL(rpmb_dev_register);

static int __init rpmb_init(void)
{
        int ret;

        ret = class_register(&rpmb_class);
        if (ret) {
                pr_err("couldn't create class\n");
                return ret;
        }
        ida_init(&rpmb_ida);
        return 0;
}

static void __exit rpmb_exit(void)
{
        ida_destroy(&rpmb_ida);
        class_unregister(&rpmb_class);
}

subsys_initcall(rpmb_init);
module_exit(rpmb_exit);

MODULE_AUTHOR("Jens Wiklander <jens.wiklander@linaro.org>");
MODULE_DESCRIPTION("RPMB class");
MODULE_LICENSE("GPL");