2 * Copyright (C) 2003 Sistina Software.
3 * Copyright (C) 2004-2005 Red Hat, Inc. All rights reserved.
5 * Module Author: Heinz Mauelshagen
7 * This file is released under the GPL.
9 * Round-robin path selector.
12 #include <linux/device-mapper.h>
14 #include "dm-path-selector.h"
16 #include <linux/slab.h>
17 #include <linux/module.h>
19 #define DM_MSG_PREFIX "multipath round-robin"
21 #define RR_VERSION "1.1.0"
23 /*-----------------------------------------------------------------
24 * Path-handling code, paths are held in lists
25 *---------------------------------------------------------------*/
27 struct list_head list;
29 unsigned repeat_count;
32 static void free_paths(struct list_head *paths)
34 struct path_info *pi, *next;
36 list_for_each_entry_safe(pi, next, paths, list) {
42 /*-----------------------------------------------------------------
43 * Round-robin selector
44 *---------------------------------------------------------------*/
47 struct list_head valid_paths;
48 struct list_head invalid_paths;
51 static struct selector *alloc_selector(void)
53 struct selector *s = kmalloc(sizeof(*s), GFP_KERNEL);
56 INIT_LIST_HEAD(&s->valid_paths);
57 INIT_LIST_HEAD(&s->invalid_paths);
63 static int rr_create(struct path_selector *ps, unsigned argc, char **argv)
75 static void rr_destroy(struct path_selector *ps)
77 struct selector *s = (struct selector *) ps->context;
79 free_paths(&s->valid_paths);
80 free_paths(&s->invalid_paths);
85 static int rr_status(struct path_selector *ps, struct dm_path *path,
86 status_type_t type, char *result, unsigned int maxlen)
97 case STATUSTYPE_TABLE:
99 DMEMIT("%u ", pi->repeat_count);
108 * Called during initialisation to register each path with an
109 * optional repeat_count.
111 static int rr_add_path(struct path_selector *ps, struct dm_path *path,
112 int argc, char **argv, char **error)
114 struct selector *s = (struct selector *) ps->context;
115 struct path_info *pi;
116 unsigned repeat_count = RR_MIN_IO;
120 *error = "round-robin ps: incorrect number of arguments";
124 /* First path argument is number of I/Os before switching path */
125 if ((argc == 1) && (sscanf(argv[0], "%u%c", &repeat_count, &dummy) != 1)) {
126 *error = "round-robin ps: invalid repeat count";
130 if (repeat_count > 1) {
131 DMWARN_LIMIT("repeat_count > 1 is deprecated, using 1 instead");
135 /* allocate the path */
136 pi = kmalloc(sizeof(*pi), GFP_KERNEL);
138 *error = "round-robin ps: Error allocating path context";
143 pi->repeat_count = repeat_count;
145 path->pscontext = pi;
147 list_add_tail(&pi->list, &s->valid_paths);
152 static void rr_fail_path(struct path_selector *ps, struct dm_path *p)
154 struct selector *s = (struct selector *) ps->context;
155 struct path_info *pi = p->pscontext;
157 list_move(&pi->list, &s->invalid_paths);
160 static int rr_reinstate_path(struct path_selector *ps, struct dm_path *p)
162 struct selector *s = (struct selector *) ps->context;
163 struct path_info *pi = p->pscontext;
165 list_move(&pi->list, &s->valid_paths);
170 static struct dm_path *rr_select_path(struct path_selector *ps,
171 unsigned *repeat_count, size_t nr_bytes)
173 struct selector *s = (struct selector *) ps->context;
174 struct path_info *pi = NULL;
176 if (!list_empty(&s->valid_paths)) {
177 pi = list_entry(s->valid_paths.next, struct path_info, list);
178 list_move_tail(&pi->list, &s->valid_paths);
179 *repeat_count = pi->repeat_count;
182 return pi ? pi->path : NULL;
185 static struct path_selector_type rr_ps = {
186 .name = "round-robin",
187 .module = THIS_MODULE,
191 .destroy = rr_destroy,
193 .add_path = rr_add_path,
194 .fail_path = rr_fail_path,
195 .reinstate_path = rr_reinstate_path,
196 .select_path = rr_select_path,
199 static int __init dm_rr_init(void)
201 int r = dm_register_path_selector(&rr_ps);
204 DMERR("register failed %d", r);
206 DMINFO("version " RR_VERSION " loaded");
211 static void __exit dm_rr_exit(void)
213 int r = dm_unregister_path_selector(&rr_ps);
216 DMERR("unregister failed %d", r);
219 module_init(dm_rr_init);
220 module_exit(dm_rr_exit);
222 MODULE_DESCRIPTION(DM_NAME " round-robin multipath path selector");
223 MODULE_AUTHOR("Sistina Software <dm-devel@redhat.com>");
224 MODULE_LICENSE("GPL");