lustre/include/uapi/linux/lustre/lustre_lfsck_user.h

   1 /*
   2  * GPL HEADER START
   3  *
   4  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License version 2 only,
   8  * as published by the Free Software Foundation.
   9
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU General Public License version 2 for more details.  A copy is
  14  * included in the COPYING file that accompanied this code.
  15
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program; if not, write to the Free Software
  18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  19  *
  20  * GPL HEADER END
  21  */
  22 /*
  23  * Copyright (c) 2012, 2017, Intel Corporation.
  24  */
  25 /*
  26  * lustre/include/lustre/lustre_lfsck_user.h
  27  *
  28  * Lustre LFSCK userspace interfaces.
  29  *
  30  * Author: Fan, Yong <fan.yong@intel.com>
  31  */
  32
  33 #ifndef _LUSTRE_LFSCK_USER_H
  34 # define _LUSTRE_LFSCK_USER_H
  35
  36 #include <linux/types.h>
  37 #include <linux/lustre/lustre_user.h>
  38
  39 /**
  40  * state machine:
  41  *
  42  *                                      LS_INIT
  43  *                                         |
  44  *                                   (lfsck|start)
  45  *                                         |
  46  *                                         v
  47  *                                 LS_SCANNING_PHASE1
  48  *                                      |       ^
  49  *                                      |       :
  50  *                                      | (lfsck:restart)
  51  *                                      |       :
  52  *                                      v       :
  53  *      -----------------------------------------------------------------
  54  *      |                   |^          |^         |^         |^        |^
  55  *      |                   |:          |:         |:         |:        |:
  56  *      v                   v:          v:         v:         v:        v:
  57  * LS_SCANNING_PHASE2   LS_FAILED  LS_STOPPED  LS_PAUSED LS_CRASHED LS_PARTIAL
  58  *                        (CO_)       (CO_)      (CO_)
  59  *      |       ^           ^:          ^:         ^:         ^:        ^:
  60  *      |       :           |:          |:         |:         |:        |:
  61  *      | (lfsck:restart)   |:          |:         |:         |:        |:
  62  *      v       :           |v          |v         |v         |v        |v
  63  *      -----------------------------------------------------------------
  64  *          |
  65  *          v
  66  *    LS_COMPLETED
  67  */
  68 enum lfsck_status {
  69         /* The lfsck file is new created, for new MDT, upgrading from old disk,
  70          * or re-creating the lfsck file manually.
  71          */
  72         LS_INIT                 = 0,
  73
  74         /* The first-step system scanning. The checked items during the phase1
  75          * scanning depends on the LFSCK type.
  76          */
  77         LS_SCANNING_PHASE1      = 1,
  78
  79         /* The second-step system scanning. The checked items during the phase2
  80          * scanning depends on the LFSCK type.
  81          */
  82         LS_SCANNING_PHASE2      = 2,
  83
  84         /* The LFSCK processing has completed for all objects. */
  85         LS_COMPLETED            = 3,
  86
  87         /* The LFSCK exited automatically for failure, will not auto restart. */
  88         LS_FAILED               = 4,
  89
  90         /* The LFSCK is stopped manually, will not auto restart. */
  91         LS_STOPPED              = 5,
  92
  93         /* LFSCK is paused automatically when umount,
  94          * will be restarted automatically when remount.
  95          */
  96         LS_PAUSED               = 6,
  97
  98         /* System crashed during the LFSCK,
  99          * will be restarted automatically after recovery.
 100          */
 101         LS_CRASHED              = 7,
 102
 103         /* Some OST/MDT failed during the LFSCK, or not join the LFSCK. */
 104         LS_PARTIAL              = 8,
 105
 106         /* The LFSCK is failed because its controller is failed. */
 107         LS_CO_FAILED            = 9,
 108
 109         /* The LFSCK is stopped because its controller is stopped. */
 110         LS_CO_STOPPED           = 10,
 111
 112         /* The LFSCK is paused because its controller is paused. */
 113         LS_CO_PAUSED            = 11,
 114
 115         LS_MAX
 116 };
 117
 118 static inline const char *lfsck_status2name(int status)
 119 {
 120         static const char * const lfsck_status_names[] = {
 121                 [LS_INIT]               = "init",
 122                 [LS_SCANNING_PHASE1]    = "scanning-phase1",
 123                 [LS_SCANNING_PHASE2]    = "scanning-phase2",
 124                 [LS_COMPLETED]          = "completed",
 125                 [LS_FAILED]             = "failed",
 126                 [LS_STOPPED]            = "stopped",
 127                 [LS_PAUSED]             = "paused",
 128                 [LS_CRASHED]            = "crashed",
 129                 [LS_PARTIAL]            = "partial",
 130                 [LS_CO_FAILED]          = "co-failed",
 131                 [LS_CO_STOPPED]         = "co-stopped",
 132                 [LS_CO_PAUSED]          = "co-paused"
 133         };
 134
 135         if (status < 0 || status >= LS_MAX)
 136                 return "unknown";
 137
 138         return lfsck_status_names[status];
 139 }
 140
 141 enum lfsck_param_flags {
 142         /* Reset LFSCK iterator position to the device beginning. */
 143         LPF_RESET               = 0x0001,
 144
 145         /* Exit when fail. */
 146         LPF_FAILOUT             = 0x0002,
 147
 148         /* Dryrun mode, only check without modification */
 149         LPF_DRYRUN              = 0x0004,
 150
 151         /* LFSCK runs on all targets. */
 152         LPF_ALL_TGT             = 0x0008,
 153
 154         /* Broadcast the command to other MDTs. Only valid on the sponsor MDT */
 155         LPF_BROADCAST           = 0x0010,
 156
 157         /* Handle orphan OST-objects. */
 158         LPF_OST_ORPHAN          = 0x0020,
 159
 160         /* Create OST-object for dangling LOV EA. */
 161         LPF_CREATE_OSTOBJ       = 0x0040,
 162
 163         /* Create MDT-object for dangling name entry. */
 164         LPF_CREATE_MDTOBJ       = 0x0080,
 165
 166         /* Do not return until the LFSCK not running. */
 167         LPF_WAIT                = 0x0100,
 168
 169         /* Delay to create OST-object for dangling LOV EA. */
 170         LPF_DELAY_CREATE_OSTOBJ = 0x0200,
 171 };
 172
 173 enum lfsck_type {
 174         /* For MDT and OST internal OSD consistency check/repair. */
 175         LFSCK_TYPE_SCRUB        = 0x0000,
 176
 177         /* For MDT-OST (layout, object) consistency check/repair. */
 178         LFSCK_TYPE_LAYOUT       = 0x0001,
 179
 180         /* For MDT (FID-in-dirent, linkEA) consistency check/repair. */
 181         LFSCK_TYPE_NAMESPACE    = 0x0004,
 182         LFSCK_TYPES_SUPPORTED   = (LFSCK_TYPE_SCRUB | LFSCK_TYPE_LAYOUT |
 183                                    LFSCK_TYPE_NAMESPACE),
 184         LFSCK_TYPES_DEF         = LFSCK_TYPES_SUPPORTED,
 185         LFSCK_TYPES_ALL         = ((__u16)(~0))
 186 };
 187
 188 #define LFSCK_VERSION_V1        1
 189 #define LFSCK_VERSION_V2        2
 190
 191 #define LFSCK_SPEED_NO_LIMIT    0
 192 #define LFSCK_SPEED_LIMIT_DEF   LFSCK_SPEED_NO_LIMIT
 193 #define LFSCK_ASYNC_WIN_DEFAULT 1024
 194 #define LFSCK_ASYNC_WIN_MAX     ((__u16)(~0))
 195 #define LFSCK_TYPE_BITS         16
 196
 197 enum lfsck_start_valid {
 198         LSV_SPEED_LIMIT         = 0x00000001,
 199         LSV_ERROR_HANDLE        = 0x00000002,
 200         LSV_DRYRUN              = 0x00000004,
 201         LSV_ASYNC_WINDOWS       = 0x00000008,
 202         LSV_CREATE_OSTOBJ       = 0x00000010,
 203         LSV_CREATE_MDTOBJ       = 0x00000020,
 204         LSV_DELAY_CREATE_OSTOBJ = 0x00000040,
 205 };
 206
 207 /* Arguments for starting lfsck. */
 208 struct lfsck_start {
 209         /* Which arguments are valid, see 'enum lfsck_start_valid'. */
 210         __u32   ls_valid;
 211
 212         /* How many items can be scanned at most per second. */
 213         __u32   ls_speed_limit;
 214
 215         /* For compatibility between user space tools and kernel service. */
 216         __u16   ls_version;
 217
 218         /* Which LFSCK components to be (have been) started. */
 219         __u16   ls_active;
 220
 221         /* Flags for the LFSCK, see 'enum lfsck_param_flags'. */
 222         __u16   ls_flags;
 223
 224         /* The windows size for async requests pipeline. */
 225         __u16   ls_async_windows;
 226 };
 227
 228 struct lfsck_stop {
 229         __u32   ls_status;
 230         __u16   ls_flags;
 231         __u16   ls_padding_1; /* For 64-bits aligned. */
 232         __u64   ls_padding_2;
 233 };
 234
 235 struct lfsck_query {
 236         __u16   lu_types;
 237         __u16   lu_flags;
 238         __u32   lu_mdts_count[LFSCK_TYPE_BITS][LS_MAX + 1];
 239         __u32   lu_osts_count[LFSCK_TYPE_BITS][LS_MAX + 1];
 240         __u64   lu_repaired[LFSCK_TYPE_BITS];
 241 };
 242
 243 #endif /* _LUSTRE_LFSCK_USER_H */