1*7a0c41d5SAlan Somers /*- 2*7a0c41d5SAlan Somers * Copyright (c) 2011, 2012, 2013 Spectra Logic Corporation 3*7a0c41d5SAlan Somers * All rights reserved. 4*7a0c41d5SAlan Somers * 5*7a0c41d5SAlan Somers * Redistribution and use in source and binary forms, with or without 6*7a0c41d5SAlan Somers * modification, are permitted provided that the following conditions 7*7a0c41d5SAlan Somers * are met: 8*7a0c41d5SAlan Somers * 1. Redistributions of source code must retain the above copyright 9*7a0c41d5SAlan Somers * notice, this list of conditions, and the following disclaimer, 10*7a0c41d5SAlan Somers * without modification. 11*7a0c41d5SAlan Somers * 2. Redistributions in binary form must reproduce at minimum a disclaimer 12*7a0c41d5SAlan Somers * substantially similar to the "NO WARRANTY" disclaimer below 13*7a0c41d5SAlan Somers * ("Disclaimer") and any redistribution must be conditioned upon 14*7a0c41d5SAlan Somers * including a substantially similar Disclaimer requirement for further 15*7a0c41d5SAlan Somers * binary redistribution. 16*7a0c41d5SAlan Somers * 17*7a0c41d5SAlan Somers * NO WARRANTY 18*7a0c41d5SAlan Somers * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 19*7a0c41d5SAlan Somers * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 20*7a0c41d5SAlan Somers * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR 21*7a0c41d5SAlan Somers * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 22*7a0c41d5SAlan Somers * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23*7a0c41d5SAlan Somers * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24*7a0c41d5SAlan Somers * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25*7a0c41d5SAlan Somers * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 26*7a0c41d5SAlan Somers * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 27*7a0c41d5SAlan Somers * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28*7a0c41d5SAlan Somers * POSSIBILITY OF SUCH DAMAGES. 29*7a0c41d5SAlan Somers * 30*7a0c41d5SAlan Somers * Authors: Justin T. Gibbs (Spectra Logic Corporation) 31*7a0c41d5SAlan Somers */ 32*7a0c41d5SAlan Somers 33*7a0c41d5SAlan Somers /** 34*7a0c41d5SAlan Somers * \file vdev_iterator.h 35*7a0c41d5SAlan Somers * 36*7a0c41d5SAlan Somers * VdevIterator class definition. 37*7a0c41d5SAlan Somers * 38*7a0c41d5SAlan Somers * Header requirements: 39*7a0c41d5SAlan Somers * 40*7a0c41d5SAlan Somers * #include <list> 41*7a0c41d5SAlan Somers */ 42*7a0c41d5SAlan Somers #ifndef _VDEV_ITERATOR_H_ 43*7a0c41d5SAlan Somers #define _VDEV_ITERATOR_H_ 44*7a0c41d5SAlan Somers 45*7a0c41d5SAlan Somers /*=========================== Forward Declarations ===========================*/ 46*7a0c41d5SAlan Somers struct zpool_handle; 47*7a0c41d5SAlan Somers typedef struct zpool_handle zpool_handle_t; 48*7a0c41d5SAlan Somers 49*7a0c41d5SAlan Somers struct nvlist; 50*7a0c41d5SAlan Somers typedef struct nvlist nvlist_t; 51*7a0c41d5SAlan Somers 52*7a0c41d5SAlan Somers class Vdev; 53*7a0c41d5SAlan Somers 54*7a0c41d5SAlan Somers /*============================= Class Definitions ============================*/ 55*7a0c41d5SAlan Somers /*------------------------------- VdevIterator -------------------------------*/ 56*7a0c41d5SAlan Somers typedef bool VdevCallback_t(Vdev &vdev, void *cbArg); 57*7a0c41d5SAlan Somers 58*7a0c41d5SAlan Somers /** 59*7a0c41d5SAlan Somers * \brief VdevIterator provides mechanisms for traversing and searching 60*7a0c41d5SAlan Somers * the leaf vdevs contained in a ZFS pool configuration. 61*7a0c41d5SAlan Somers */ 62*7a0c41d5SAlan Somers class VdevIterator 63*7a0c41d5SAlan Somers { 64*7a0c41d5SAlan Somers public: 65*7a0c41d5SAlan Somers /** 66*7a0c41d5SAlan Somers * \brief Instantiate a VdevIterator for the given ZFS pool. 67*7a0c41d5SAlan Somers * 68*7a0c41d5SAlan Somers * \param pool The ZFS pool to traverse/search. 69*7a0c41d5SAlan Somers */ 70*7a0c41d5SAlan Somers VdevIterator(zpool_handle_t *pool); 71*7a0c41d5SAlan Somers 72*7a0c41d5SAlan Somers /** 73*7a0c41d5SAlan Somers * \brief Instantiate a VdevIterator for the given ZFS pool. 74*7a0c41d5SAlan Somers * 75*7a0c41d5SAlan Somers * \param poolConfig The configuration data for the ZFS pool 76*7a0c41d5SAlan Somers * to traverse/search. 77*7a0c41d5SAlan Somers */ 78*7a0c41d5SAlan Somers VdevIterator(nvlist_t *poolConfig); 79*7a0c41d5SAlan Somers 80*7a0c41d5SAlan Somers /** 81*7a0c41d5SAlan Somers * \brief Reset this iterator's cursor so that Next() will 82*7a0c41d5SAlan Somers * report the first member of the pool. 83*7a0c41d5SAlan Somers */ 84*7a0c41d5SAlan Somers void Reset(); 85*7a0c41d5SAlan Somers 86*7a0c41d5SAlan Somers /** 87*7a0c41d5SAlan Somers * \brief Report the leaf vdev at this iterator's cursor and increment 88*7a0c41d5SAlan Somers * the cursor to the next leaf pool member. 89*7a0c41d5SAlan Somers */ 90*7a0c41d5SAlan Somers nvlist_t *Next(); 91*7a0c41d5SAlan Somers 92*7a0c41d5SAlan Somers /** 93*7a0c41d5SAlan Somers * \brief Traverse the entire pool configuration starting its 94*7a0c41d5SAlan Somers * first member, returning a vdev object with the given 95*7a0c41d5SAlan Somers * vdev GUID if found. 96*7a0c41d5SAlan Somers * 97*7a0c41d5SAlan Somers * \param vdevGUID The vdev GUID of the vdev object to find. 98*7a0c41d5SAlan Somers * 99*7a0c41d5SAlan Somers * \return A Vdev object for the matching vdev if found. Otherwise 100*7a0c41d5SAlan Somers * NULL. 101*7a0c41d5SAlan Somers * 102*7a0c41d5SAlan Somers * Upon return, the VdevIterator's cursor points to the vdev just 103*7a0c41d5SAlan Somers * past the returned vdev or end() if no matching vdev is found. 104*7a0c41d5SAlan Somers */ 105*7a0c41d5SAlan Somers nvlist_t *Find(DevdCtl::Guid vdevGUID); 106*7a0c41d5SAlan Somers 107*7a0c41d5SAlan Somers /** 108*7a0c41d5SAlan Somers * \brief Perform the specified operation on each leaf member of 109*7a0c41d5SAlan Somers * a pool's vdev membership. 110*7a0c41d5SAlan Somers * 111*7a0c41d5SAlan Somers * \param cb Callback function to execute for each member. 112*7a0c41d5SAlan Somers * \param cbArg Argument to pass to cb. 113*7a0c41d5SAlan Somers */ 114*7a0c41d5SAlan Somers void Each(VdevCallback_t *cb, void *cbArg); 115*7a0c41d5SAlan Somers 116*7a0c41d5SAlan Somers private: 117*7a0c41d5SAlan Somers nvlist_t *m_poolConfig; 118*7a0c41d5SAlan Somers std::list<nvlist_t *> m_vdevQueue; 119*7a0c41d5SAlan Somers }; 120*7a0c41d5SAlan Somers 121*7a0c41d5SAlan Somers #endif /* _VDEV_ITERATOR_H_ */ 122