blob: f7fabb478877e57919b11a9ea9de30a29483ca17 [file] [log] [blame]
Boaz Harrosh8ff660a2011-08-06 19:26:31 -07001/*
2 * Copyright (C) 2011
3 * Boaz Harrosh <bharrosh@panasas.com>
4 *
5 * Public Declarations of the ORE API
6 *
7 * This file is part of the ORE (Object Raid Engine) library.
8 *
9 * ORE is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License version 2 as published
11 * by the Free Software Foundation. (GPL v2)
12 *
13 * ORE is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with the ORE; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
21 */
22#ifndef __ORE_H__
23#define __ORE_H__
24
25#include <scsi/osd_initiator.h>
26#include <scsi/osd_attributes.h>
27#include <scsi/osd_sec.h>
28#include <linux/pnfs_osd_xdr.h>
29
30struct ore_comp {
31 struct osd_obj_id obj;
32 u8 cred[OSD_CAP_LEN];
33};
34
35struct ore_layout {
36 /* Our way of looking at the data_map */
Boaz Harrosh8d2d83a2011-08-10 14:15:02 -070037 enum pnfs_osd_raid_algorithm4
38 raid_algorithm;
Boaz Harrosh8ff660a2011-08-06 19:26:31 -070039 unsigned stripe_unit;
40 unsigned mirrors_p1;
41
42 unsigned group_width;
43 u64 group_depth;
44 unsigned group_count;
45};
46
47struct ore_components {
48 unsigned numdevs; /* Num of devices in array */
49 /* If @single_comp == EC_SINGLE_COMP, @comps points to a single
50 * component. else there are @numdevs components
51 */
52 enum EC_COMP_USAGE {
53 EC_SINGLE_COMP = 0, EC_MULTPLE_COMPS = 0xffffffff
54 } single_comp;
55 struct ore_comp *comps;
56 struct osd_dev **ods; /* osd_dev array */
57};
58
59struct ore_io_state;
60typedef void (*ore_io_done_fn)(struct ore_io_state *ios, void *private);
61
62struct ore_io_state {
63 struct kref kref;
64
65 void *private;
66 ore_io_done_fn done;
67
68 struct ore_layout *layout;
Boaz Harrosh5bf696d2011-09-28 11:39:59 +030069 struct ore_components *oc;
Boaz Harrosh8ff660a2011-08-06 19:26:31 -070070
71 /* Global read/write IO*/
72 loff_t offset;
73 unsigned long length;
74 void *kern_buff;
75
76 struct page **pages;
77 unsigned nr_pages;
78 unsigned pgbase;
79 unsigned pages_consumed;
80
81 /* Attributes */
82 unsigned in_attr_len;
83 struct osd_attr *in_attr;
84 unsigned out_attr_len;
85 struct osd_attr *out_attr;
86
87 bool reading;
88
89 /* Variable array of size numdevs */
90 unsigned numdevs;
91 struct ore_per_dev_state {
92 struct osd_request *or;
93 struct bio *bio;
94 loff_t offset;
95 unsigned length;
96 unsigned dev;
97 } per_dev[];
98};
99
100static inline unsigned ore_io_state_size(unsigned numdevs)
101{
102 return sizeof(struct ore_io_state) +
103 sizeof(struct ore_per_dev_state) * numdevs;
104}
105
106/* ore.c */
107int ore_get_rw_state(struct ore_layout *layout, struct ore_components *comps,
108 bool is_reading, u64 offset, u64 length,
109 struct ore_io_state **ios);
110int ore_get_io_state(struct ore_layout *layout, struct ore_components *comps,
111 struct ore_io_state **ios);
112void ore_put_io_state(struct ore_io_state *ios);
113
114int ore_check_io(struct ore_io_state *ios, u64 *resid);
115
116int ore_create(struct ore_io_state *ios);
117int ore_remove(struct ore_io_state *ios);
118int ore_write(struct ore_io_state *ios);
119int ore_read(struct ore_io_state *ios);
120int ore_truncate(struct ore_layout *layout, struct ore_components *comps,
121 u64 size);
122
123int extract_attr_from_ios(struct ore_io_state *ios, struct osd_attr *attr);
124
125extern const struct osd_attr g_attr_logical_length;
126
127#endif