adb58535e6
An io_state pre-allocates an error information structure for each possible osd-device that might error during IO. When IO is done if all was well the io_state is freed. (as today). If the I/O has ended with an error, the io_state is queued on a per-layout err_list. When eventually encode_layoutreturn() is called, each error is properly encoded on the XDR buffer and only then the io_state is removed from err_list and de-allocated. It is up to the io_engine to fill in the segment that fault and the type of osd_error that occurred. By calling objlayout_io_set_result() for each failing device. In objio_osd: * Allocate io-error descriptors space as part of io_state * Use generic objlayout error reporting at end of io. Signed-off-by: Boaz Harrosh <bharrosh@panasas.com> Signed-off-by: Benny Halevy <bhalevy@panasas.com>
157 lines
5 KiB
C
157 lines
5 KiB
C
/*
|
|
* Data types and function declerations for interfacing with the
|
|
* pNFS standard object layout driver.
|
|
*
|
|
* Copyright (C) 2007 Panasas Inc. [year of first publication]
|
|
* All rights reserved.
|
|
*
|
|
* Benny Halevy <bhalevy@panasas.com>
|
|
* Boaz Harrosh <bharrosh@panasas.com>
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License version 2
|
|
* See the file COPYING included with this distribution for more details.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
* 3. Neither the name of the Panasas company nor the names of its
|
|
* contributors may be used to endorse or promote products derived
|
|
* from this software without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED
|
|
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
|
* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
* DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
|
|
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
|
|
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
|
|
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
#ifndef _OBJLAYOUT_H
|
|
#define _OBJLAYOUT_H
|
|
|
|
#include <linux/nfs_fs.h>
|
|
#include <linux/pnfs_osd_xdr.h>
|
|
#include "../pnfs.h"
|
|
|
|
/*
|
|
* per-inode layout
|
|
*/
|
|
struct objlayout {
|
|
struct pnfs_layout_hdr pnfs_layout;
|
|
|
|
/* for layout_return */
|
|
spinlock_t lock;
|
|
struct list_head err_list;
|
|
};
|
|
|
|
static inline struct objlayout *
|
|
OBJLAYOUT(struct pnfs_layout_hdr *lo)
|
|
{
|
|
return container_of(lo, struct objlayout, pnfs_layout);
|
|
}
|
|
|
|
/*
|
|
* per-I/O operation state
|
|
* embedded in objects provider io_state data structure
|
|
*/
|
|
struct objlayout_io_state {
|
|
struct pnfs_layout_segment *lseg;
|
|
|
|
struct page **pages;
|
|
unsigned pgbase;
|
|
unsigned nr_pages;
|
|
unsigned long count;
|
|
loff_t offset;
|
|
bool sync;
|
|
|
|
void *rpcdata;
|
|
int status; /* res */
|
|
int eof; /* res */
|
|
int committed; /* res */
|
|
|
|
/* Error reporting (layout_return) */
|
|
struct list_head err_list;
|
|
unsigned num_comps;
|
|
/* Pointer to array of error descriptors of size num_comps.
|
|
* It should contain as many entries as devices in the osd_layout
|
|
* that participate in the I/O. It is up to the io_engine to allocate
|
|
* needed space and set num_comps.
|
|
*/
|
|
struct pnfs_osd_ioerr *ioerrs;
|
|
};
|
|
|
|
/*
|
|
* Raid engine I/O API
|
|
*/
|
|
extern int objio_alloc_lseg(struct pnfs_layout_segment **outp,
|
|
struct pnfs_layout_hdr *pnfslay,
|
|
struct pnfs_layout_range *range,
|
|
struct xdr_stream *xdr,
|
|
gfp_t gfp_flags);
|
|
extern void objio_free_lseg(struct pnfs_layout_segment *lseg);
|
|
|
|
extern int objio_alloc_io_state(
|
|
struct pnfs_layout_segment *lseg,
|
|
struct objlayout_io_state **outp,
|
|
gfp_t gfp_flags);
|
|
extern void objio_free_io_state(struct objlayout_io_state *state);
|
|
|
|
extern ssize_t objio_read_pagelist(struct objlayout_io_state *ol_state);
|
|
extern ssize_t objio_write_pagelist(struct objlayout_io_state *ol_state,
|
|
bool stable);
|
|
|
|
/*
|
|
* callback API
|
|
*/
|
|
extern void objlayout_io_set_result(struct objlayout_io_state *state,
|
|
unsigned index, struct pnfs_osd_objid *pooid,
|
|
int osd_error, u64 offset, u64 length, bool is_write);
|
|
|
|
extern void objlayout_read_done(struct objlayout_io_state *state,
|
|
ssize_t status, bool sync);
|
|
extern void objlayout_write_done(struct objlayout_io_state *state,
|
|
ssize_t status, bool sync);
|
|
|
|
extern int objlayout_get_deviceinfo(struct pnfs_layout_hdr *pnfslay,
|
|
struct nfs4_deviceid *d_id, struct pnfs_osd_deviceaddr **deviceaddr,
|
|
gfp_t gfp_flags);
|
|
extern void objlayout_put_deviceinfo(struct pnfs_osd_deviceaddr *deviceaddr);
|
|
|
|
/*
|
|
* exported generic objects function vectors
|
|
*/
|
|
|
|
extern struct pnfs_layout_hdr *objlayout_alloc_layout_hdr(struct inode *, gfp_t gfp_flags);
|
|
extern void objlayout_free_layout_hdr(struct pnfs_layout_hdr *);
|
|
|
|
extern struct pnfs_layout_segment *objlayout_alloc_lseg(
|
|
struct pnfs_layout_hdr *,
|
|
struct nfs4_layoutget_res *,
|
|
gfp_t gfp_flags);
|
|
extern void objlayout_free_lseg(struct pnfs_layout_segment *);
|
|
|
|
extern enum pnfs_try_status objlayout_read_pagelist(
|
|
struct nfs_read_data *);
|
|
|
|
extern enum pnfs_try_status objlayout_write_pagelist(
|
|
struct nfs_write_data *,
|
|
int how);
|
|
|
|
extern void objlayout_encode_layoutreturn(
|
|
struct pnfs_layout_hdr *,
|
|
struct xdr_stream *,
|
|
const struct nfs4_layoutreturn_args *);
|
|
|
|
#endif /* _OBJLAYOUT_H */
|