auto lm_J*j"TqTţ 0+ l4( (  fB- _?_I|+? /* SPDX-License-Identifier: GPL-2.0-only */ /* * Copyright (C) 2001 Sistina Software (UK) Limited. * Copyright (C) 2004-2008 Red Hat, Inc. All rights reserved. * * This file is released under the LGPL. */ #ifndef _LINUX_DEVICE_MAPPER_H #define _LINUX_DEVICE_MAPPER_H #include #include #include #include #include struct dm_dev; struct dm_target; struct dm_table; struct dm_report_zones_args; struct mapped_device; struct bio_vec; enum dax_access_mode; /* * Type of table, mapped_device's mempool and request_queue */ enum dm_queue_mode { DM_TYPE_NONE = 0, DM_TYPE_BIO_BASED = 1, DM_TYPE_REQUEST_BASED = 2, DM_TYPE_DAX_BIO_BASED = 3, }; typedef enum { STATUSTYPE_INFO, STATUSTYPE_TABLE, STATUSTYPE_IMA } status_type_t; union map_info { void *ptr; }; /* * In the constructor the target parameter will already have the * table, type, begin and len fields filled in. */ typedef int (*dm_ctr_fn) (struct dm_target *target, unsigned int argc, char **argv); /* * The destructor doesn't need to free the dm_target, just * anything hidden ti->private. */ typedef void (*dm_dtr_fn) (struct dm_target *ti); /* * The map function must return: * < 0: error * = 0: The target will handle the io by resubmitting it later * = 1: simple remap complete * = 2: The target wants to push back the io */ typedef int (*dm_map_fn) (struct dm_target *ti, struct bio *bio); typedef int (*dm_clone_and_map_request_fn) (struct dm_target *ti, struct request *rq, union map_info *map_context, struct request **clone); typedef void (*dm_release_clone_request_fn) (struct request *clone, union map_info *map_context); /* * Returns: * < 0 : error (currently ignored) * 0 : ended successfully * 1 : for some reason the io has still not completed (eg, * multipath target might want to requeue a failed io). * 2 : The target wants to push back the io */ typedef int (*dm_endio_fn) (struct dm_target *ti, struct bio *bio, blk_status_t *error); typedef int (*dm_request_endio_fn) (struct dm_target *ti, struct request *clone, blk_status_t error, union map_info *map_context); typedef void (*dm_presuspend_fn) (struct dm_target *ti); typedef void (*dm_presuspend_undo_fn) (struct dm_target *ti); typedef void (*dm_postsuspend_fn) (struct dm_target *ti); typedef int (*dm_preresume_fn) (struct dm_target *ti); typedef void (*dm_resume_fn) (struct dm_target *ti); typedef void (*dm_status_fn) (struct dm_target *ti, status_type_t status_type, unsigned int status_flags, char *result, unsigned int maxlen); typedef int (*dm_message_fn) (struct dm_target *ti, unsigned int argc, char **argv, char *result, unsigned int maxlen); /* * Called with *forward == true. If it remains true, the ioctl should be * forwarded to bdev. If it is reset to false, the target already fully handled * the ioctl and the return value is the return value for the whole ioctl. */ typedef int (*dm_prepare_ioctl_fn) (struct dm_target *ti, struct block_device **bdev, unsigned int cmd, unsigned long arg, bool *forward); #ifdef CONFIG_BLK_DEV_ZONED typedef int (*dm_report_zones_fn) (struct dm_target *ti, struct dm_report_zones_args *args, unsigned int nr_zones); #else /* * Define dm_report_zones_fn so that targets can assign to NULL if * CONFIG_BLK_DEV_ZONED disabled. Otherwise each target needs to do * awkward #ifdefs in their target_type, etc. */ typedef int (*dm_report_zones_fn) (struct dm_target *dummy); #endif /* * These iteration functions are typically used to check (and combine) * properties of underlying devices. * E.g. Does at least one underlying device support flush? * Does any underlying device not support WRITE_SAME? * * The callout function is called once for each contiguous section of * an underlying device. State can be maintained in *data.