Whamcloud - gitweb
LU-9934 build: address issues raised by gcc7
[fs/lustre-release.git] / lustre / utils / lfs.c
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, but
11  * WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * General Public License version 2 for more details (a copy is included
14  * in the LICENSE file that accompanied this code).
15  *
16  * You should have received a copy of the GNU General Public License
17  * version 2 along with this program; If not, see
18  * http://www.gnu.org/licenses/gpl-2.0.html
19  *
20  * GPL HEADER END
21  */
22 /*
23  * Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved.
24  * Use is subject to license terms.
25  *
26  * Copyright (c) 2011, 2017, Intel Corporation.
27  */
28 /*
29  * This file is part of Lustre, http://www.lustre.org/
30  * Lustre is a trademark of Sun Microsystems, Inc.
31  *
32  * lustre/utils/lfs.c
33  *
34  * Author: Peter J. Braam <braam@clusterfs.com>
35  * Author: Phil Schwan <phil@clusterfs.com>
36  * Author: Robert Read <rread@clusterfs.com>
37  */
38
39 /* for O_DIRECTORY */
40 #ifndef _GNU_SOURCE
41 #define _GNU_SOURCE
42 #endif
43
44 #include <stdlib.h>
45 #include <stdio.h>
46 #include <inttypes.h>
47 #include <getopt.h>
48 #include <string.h>
49 #include <mntent.h>
50 #include <unistd.h>
51 #include <errno.h>
52 #include <err.h>
53 #include <pwd.h>
54 #include <grp.h>
55 #include <sys/ioctl.h>
56 #include <sys/quota.h>
57 #include <sys/time.h>
58 #include <sys/types.h>
59 #include <sys/stat.h>
60 #include <fcntl.h>
61 #include <dirent.h>
62 #include <time.h>
63 #include <ctype.h>
64 #include "lfs_project.h"
65
66 #include <libcfs/util/string.h>
67 #include <libcfs/util/ioctl.h>
68 #include <libcfs/util/parser.h>
69 #include <lustre/lustreapi.h>
70 #include <linux/lustre/lustre_ver.h>
71 #include <linux/lustre/lustre_param.h>
72
73 #ifndef ARRAY_SIZE
74 # define ARRAY_SIZE(a) ((sizeof(a)) / (sizeof((a)[0])))
75 #endif /* !ARRAY_SIZE */
76
77 /* all functions */
78 static int lfs_find(int argc, char **argv);
79 static int lfs_getstripe(int argc, char **argv);
80 static int lfs_getdirstripe(int argc, char **argv);
81 static int lfs_setdirstripe(int argc, char **argv);
82 static int lfs_rmentry(int argc, char **argv);
83 static int lfs_osts(int argc, char **argv);
84 static int lfs_mdts(int argc, char **argv);
85 static int lfs_df(int argc, char **argv);
86 static int lfs_getname(int argc, char **argv);
87 static int lfs_check(int argc, char **argv);
88 #ifdef HAVE_SYS_QUOTA_H
89 static int lfs_setquota(int argc, char **argv);
90 static int lfs_quota(int argc, char **argv);
91 static int lfs_project(int argc, char **argv);
92 #endif
93 static int lfs_flushctx(int argc, char **argv);
94 static int lfs_cp(int argc, char **argv);
95 static int lfs_ls(int argc, char **argv);
96 static int lfs_poollist(int argc, char **argv);
97 static int lfs_changelog(int argc, char **argv);
98 static int lfs_changelog_clear(int argc, char **argv);
99 static int lfs_fid2path(int argc, char **argv);
100 static int lfs_path2fid(int argc, char **argv);
101 static int lfs_data_version(int argc, char **argv);
102 static int lfs_hsm_state(int argc, char **argv);
103 static int lfs_hsm_set(int argc, char **argv);
104 static int lfs_hsm_clear(int argc, char **argv);
105 static int lfs_hsm_action(int argc, char **argv);
106 static int lfs_hsm_archive(int argc, char **argv);
107 static int lfs_hsm_restore(int argc, char **argv);
108 static int lfs_hsm_release(int argc, char **argv);
109 static int lfs_hsm_remove(int argc, char **argv);
110 static int lfs_hsm_cancel(int argc, char **argv);
111 static int lfs_swap_layouts(int argc, char **argv);
112 static int lfs_mv(int argc, char **argv);
113 static int lfs_ladvise(int argc, char **argv);
114 static int lfs_mirror(int argc, char **argv);
115 static int lfs_mirror_list_commands(int argc, char **argv);
116 static int lfs_list_commands(int argc, char **argv);
117 static inline int lfs_mirror_resync(int argc, char **argv);
118
119 enum setstripe_origin {
120         SO_SETSTRIPE,
121         SO_MIGRATE,
122         SO_MIRROR_CREATE,
123         SO_MIRROR_EXTEND
124 };
125 static int lfs_setstripe0(int argc, char **argv, enum setstripe_origin opc);
126
127 static inline int lfs_setstripe(int argc, char **argv)
128 {
129         return lfs_setstripe0(argc, argv, SO_SETSTRIPE);
130 }
131 static inline int lfs_setstripe_migrate(int argc, char **argv)
132 {
133         return lfs_setstripe0(argc, argv, SO_MIGRATE);
134 }
135 static inline int lfs_mirror_create(int argc, char **argv)
136 {
137         return lfs_setstripe0(argc, argv, SO_MIRROR_CREATE);
138 }
139 static inline int lfs_mirror_extend(int argc, char **argv)
140 {
141         return lfs_setstripe0(argc, argv, SO_MIRROR_EXTEND);
142 }
143
144 /* Setstripe and migrate share mostly the same parameters */
145 #define SSM_CMD_COMMON(cmd) \
146         "usage: "cmd" [--component-end|-E <comp_end>]\n"                \
147         "                 [--stripe-count|-c <stripe_count>]\n"         \
148         "                 [--stripe-index|-i <start_ost_idx>]\n"        \
149         "                 [--stripe-size|-S <stripe_size>]\n"           \
150         "                 [--layout|-L <pattern>]\n"            \
151         "                 [--pool|-p <pool_name>]\n"                    \
152         "                 [--ost|-o <ost_indices>]\n"
153
154 #define SSM_HELP_COMMON \
155         "\tstripe_count: Number of OSTs to stripe over (0=fs default, -1 all)\n" \
156         "\tstart_ost_idx: OST index of first stripe (-1=default round robin)\n"\
157         "\tstripe_size:  Number of bytes on each OST (0=fs default)\n" \
158         "\t              Can be specified with K, M or G (for KB, MB, GB\n" \
159         "\t              respectively)\n"                               \
160         "\tpool_name:    Name of OST pool to use (default none)\n"      \
161         "\tlayout:       stripe pattern type: raid0, mdt (default raid0)\n"\
162         "\tost_indices:  List of OST indices, can be repeated multiple times\n"\
163         "\t              Indices be specified in a format of:\n"        \
164         "\t                -o <ost_1>,<ost_i>-<ost_j>,<ost_n>\n"        \
165         "\t              Or:\n"                                         \
166         "\t                -o <ost_1> -o <ost_i>-<ost_j> -o <ost_n>\n"  \
167         "\t              If --pool is set with --ost, then the OSTs\n"  \
168         "\t              must be the members of the pool.\n"            \
169         "\tcomp_end:     Extent end of component, start after previous end.\n"\
170         "\t              Can be specified with K, M or G (for KB, MB, GB\n" \
171         "\t              respectively, -1 for EOF). Must be a multiple of\n"\
172         "\t              stripe_size.\n"
173
174 #define MIRROR_CREATE_HELP                                                     \
175         "\tmirror_count: Number of mirrors to be created with the upcoming\n"  \
176         "\t              setstripe layout options\n"                           \
177         "\t              It defaults to 1 if not specified; if specified,\n"   \
178         "\t              it must follow the option without a space.\n"         \
179         "\t              The option can also be repeated multiple times to\n"  \
180         "\t              separate mirrors that have different layouts.\n"      \
181         "\tsetstripe options: Mirror layout\n"                                 \
182         "\t              It can be a plain layout or a composite layout.\n"    \
183         "\t              If not specified, the stripe options inherited\n"     \
184         "\t              from the previous component will be used.\n"          \
185         "\tparent:       Use default stripe options from parent directory\n"   \
186         "\tflags:        set flags to the component of the current mirror.\n"  \
187         "\t              Only \"prefer\" flag is supported so far.\n"
188
189 #define MIRROR_EXTEND_HELP                                                     \
190         MIRROR_CREATE_HELP                                                     \
191         "\tvictim_file:  The layout of victim_file will be split and used\n"   \
192         "\t              as a mirror added to the mirrored file.\n"            \
193         "\tno-verify:    This option indicates not to verify the mirror(s)\n"  \
194         "\t              from victim file(s) in case the victim file(s)\n"     \
195         "\t              contains the same data as the original mirrored\n"    \
196         "\t              file.\n"
197
198 #define MIRROR_EXTEND_USAGE                                                    \
199         "                 <--mirror-count|-N[mirror_count]>\n"                 \
200         "                 [setstripe options|--parent|-f <victim_file>]\n"     \
201         "                 [--no-verify]\n"
202
203 #define SETSTRIPE_USAGE                                                 \
204         SSM_CMD_COMMON("setstripe")                                     \
205         MIRROR_EXTEND_USAGE                                             \
206         "                 <directory|filename>\n"                       \
207         SSM_HELP_COMMON                                                 \
208         MIRROR_EXTEND_HELP
209
210 #define MIGRATE_USAGE                                                   \
211         SSM_CMD_COMMON("migrate  ")                                     \
212         "                 [--block|-b]\n"                               \
213         "                 [--non-block|-n]\n"                           \
214         "                 <filename>\n"                                 \
215         SSM_HELP_COMMON                                                 \
216         "\n"                                                            \
217         "\tblock:        Block file access during data migration (default)\n" \
218         "\tnon-block:    Abort migrations if concurrent access is detected\n" \
219
220 #define SETDIRSTRIPE_USAGE                                      \
221         "               [--mdt-count|-c stripe_count>\n"        \
222         "               [--mdt-index|-i mdt_index]\n"           \
223         "               [--mdt-hash|-H mdt_hash]\n"             \
224         "               [--default|-D] [--mode|-m mode] <dir>\n"        \
225         "\tstripe_count: stripe count of the striped directory\n"       \
226         "\tmdt_index: MDT index of first stripe\n"                      \
227         "\tmdt_hash:  hash type of the striped directory. mdt types:\n" \
228         "       fnv_1a_64 FNV-1a hash algorithm (default)\n"            \
229         "       all_char  sum of characters % MDT_COUNT (not recommended)\n" \
230         "\tdefault_stripe: set default dirstripe of the directory\n"    \
231         "\tmode: the mode of the directory\n"
232
233 /**
234  * command_t mirror_cmdlist - lfs mirror commands.
235  */
236 command_t mirror_cmdlist[] = {
237         { .pc_name = "create", .pc_func = lfs_mirror_create,
238           .pc_help = "Create a mirrored file.\n"
239                 "usage: lfs mirror create "
240                 "<--mirror-count|-N[mirror_count]> "
241                 "[setstripe options|--parent] ... <filename|directory>\n"
242           MIRROR_CREATE_HELP },
243         { .pc_name = "extend", .pc_func = lfs_mirror_extend,
244           .pc_help = "Extend a mirrored file.\n"
245                 "usage: lfs mirror extend "
246                 "<--mirror-count|-N[mirror_count]> [--no-verify] "
247                 "[setstripe options|--parent|-f <victim_file>] ... <filename>\n"
248           MIRROR_EXTEND_HELP },
249         { .pc_name = "resync", .pc_func = lfs_mirror_resync,
250           .pc_help = "Resynchronizes out-of-sync mirrored file(s).\n"
251                 "usage: lfs mirror resync [--only <mirror_id[,...]>] "
252                 "<mirrored file> [<mirrored file2>...]\n"},
253         { .pc_name = "--list-commands", .pc_func = lfs_mirror_list_commands,
254           .pc_help = "list commands supported by lfs mirror"},
255         { .pc_name = "help", .pc_func = Parser_help, .pc_help = "help" },
256         { .pc_name = "exit", .pc_func = Parser_quit, .pc_help = "quit" },
257         { .pc_name = "quit", .pc_func = Parser_quit, .pc_help = "quit" },
258         { .pc_help = NULL }
259 };
260
261 /* all available commands */
262 command_t cmdlist[] = {
263         {"setstripe", lfs_setstripe, 0,
264          "To create a file with specified striping/composite layout, or\n"
265          "create/replace the default layout on an existing directory:\n"
266          SSM_CMD_COMMON("setstripe")
267          "                 <directory|filename>\n"
268          " or\n"
269          "To add component(s) to an existing composite file:\n"
270          SSM_CMD_COMMON("setstripe --component-add")
271          SSM_HELP_COMMON
272          "To totally delete the default striping from an existing directory:\n"
273          "usage: setstripe -d <directory>\n"
274          " or\n"
275          "To delete the last component(s) from an existing composite file\n"
276          "(note that this will also delete any data in those components):\n"
277          "usage: setstripe --component-del [--component-id|-I <comp_id>]\n"
278          "                               [--component-flags|-F <comp_flags>]\n"
279          "                               <filename>\n"
280          "\tcomp_id:     Unique component ID to delete\n"
281          "\tcomp_flags:  'init' indicating all instantiated components\n"
282          "\t             '^init' indicating all uninstantiated components\n"
283          "\t-I and -F cannot be specified at the same time\n"},
284         {"getstripe", lfs_getstripe, 0,
285          "To list the striping info for a given file or files in a\n"
286          "directory or recursively for all files in a directory tree.\n"
287          "usage: getstripe [--ost|-O <uuid>] [--quiet|-q] [--verbose|-v]\n"
288          "                 [--stripe-count|-c] [--stripe-index|-i]\n"
289          "                 [--pool|-p] [--stripe-size|-S] [--directory|-d]\n"
290          "                 [--mdt|-m] [--recursive|-r] [--raw|-R] [--yaml|-y]\n"
291          "                 [--layout|-L] [--fid|-F] [--generation|-g]\n"
292          "                 [--component-id[=comp_id]|-I[comp_id]]\n"
293          "                 [--component-flags[=comp_flags]]\n"
294          "                 [--component-count]\n"
295          "                 [--component-start[=[+-]comp_start]]\n"
296          "                 [--component-end[=[+-]comp_end]|-E[[+-]comp_end]]\n"
297          "                 <directory|filename> ..."},
298         {"setdirstripe", lfs_setdirstripe, 0,
299          "To create a striped directory on a specified MDT. This can only\n"
300          "be done on MDT0 with the right of administrator.\n"
301          "usage: setdirstripe [OPTION] <directory>\n"
302          SETDIRSTRIPE_USAGE},
303         {"getdirstripe", lfs_getdirstripe, 0,
304          "To list the striping info for a given directory\n"
305          "or recursively for all directories in a directory tree.\n"
306          "usage: getdirstripe [--obd|-O <uuid>] [--mdt-count|-c]\n"
307          "                    [--mdt-index|-i] [--mdt-hash|-t]\n"
308          "                    [--recursive|-r] [--yaml|-y]\n"
309          "                    [--default|-D] <dir> ..."},
310         {"mkdir", lfs_setdirstripe, 0,
311          "To create a striped directory on a specified MDT. This can only\n"
312          "be done on MDT0 with the right of administrator.\n"
313          "usage: mkdir [OPTION] <directory>\n"
314          SETDIRSTRIPE_USAGE},
315         {"rm_entry", lfs_rmentry, 0,
316          "To remove the name entry of the remote directory. Note: This\n"
317          "command will only delete the name entry, i.e. the remote directory\n"
318          "will become inaccessable after this command. This can only be done\n"
319          "by the administrator\n"
320          "usage: rm_entry <dir>\n"},
321         {"pool_list", lfs_poollist, 0,
322          "List pools or pool OSTs\n"
323          "usage: pool_list <fsname>[.<pool>] | <pathname>\n"},
324         {"find", lfs_find, 0,
325          "find files matching given attributes recursively in directory tree.\n"
326          "usage: find <directory|filename> ...\n"
327          "     [[!] --atime|-A [+-]N] [[!] --ctime|-C [+-]N]\n"
328          "     [[!] --mtime|-M [+-]N] [[!] --mdt|-m <uuid|index,...>]\n"
329          "     [--maxdepth|-D N] [[!] --name|-n <pattern>]\n"
330          "     [[!] --ost|-O <uuid|index,...>] [--print|-p] [--print0|-P]\n"
331          "     [[!] --size|-s [+-]N[bkMGTPE]]\n"
332          "     [[!] --stripe-count|-c [+-]<stripes>]\n"
333          "     [[!] --stripe-index|-i <index,...>]\n"
334          "     [[!] --stripe-size|-S [+-]N[kMGT]] [[!] --type|-t <filetype>]\n"
335          "     [[!] --gid|-g|--group|-G <gid>|<gname>]\n"
336          "     [[!] --uid|-u|--user|-U <uid>|<uname>] [[!] --pool <pool>]\n"
337          "     [[!] --projid <projid>]\n"
338          "     [[!] --layout|-L released,raid0,mdt]\n"
339          "     [[!] --component-count [+-]<comp_cnt>]\n"
340          "     [[!] --component-start [+-]N[kMGTPE]]\n"
341          "     [[!] --component-end|-E [+-]N[kMGTPE]]\n"
342          "     [[!] --component-flags <comp_flags>]\n"
343          "     [[!] --mdt-count|-T [+-]<stripes>]\n"
344          "     [[!] --mdt-hash|-H <hashtype>\n"
345          "\t !: used before an option indicates 'NOT' requested attribute\n"
346          "\t -: used before a value indicates less than requested value\n"
347          "\t +: used before a value indicates more than requested value\n"
348          "\tmdt-hash:   hash type of the striped directory.\n"
349          "\t            fnv_1a_64 FNV-1a hash algorithm\n"
350          "\t            all_char  sum of characters % MDT_COUNT\n"},
351         {"check", lfs_check, 0,
352          "Display the status of MDS or OSTs (as specified in the command)\n"
353          "or all the servers (MDS and OSTs).\n"
354          "usage: check <osts|mds|servers>"},
355         {"osts", lfs_osts, 0, "list OSTs connected to client "
356          "[for specified path only]\n" "usage: osts [path]"},
357         {"mdts", lfs_mdts, 0, "list MDTs connected to client "
358          "[for specified path only]\n" "usage: mdts [path]"},
359         {"df", lfs_df, 0,
360          "report filesystem disk space usage or inodes usage"
361          "of each MDS and all OSDs or a batch belonging to a specific pool .\n"
362          "Usage: df [-i] [-h] [--lazy|-l] [--pool|-p <fsname>[.<pool>] [path]"},
363         {"getname", lfs_getname, 0, "list instances and specified mount points "
364          "[for specified path only]\n"
365          "Usage: getname [-h]|[path ...] "},
366 #ifdef HAVE_SYS_QUOTA_H
367         {"setquota", lfs_setquota, 0, "Set filesystem quotas.\n"
368          "usage: setquota <-u|-g|-p> <uname>|<uid>|<gname>|<gid>|<projid>\n"
369          "                -b <block-softlimit> -B <block-hardlimit>\n"
370          "                -i <inode-softlimit> -I <inode-hardlimit> <filesystem>\n"
371          "       setquota <-u|--user|-g|--group|-p|--projid> <uname>|<uid>|<gname>|<gid>|<projid>\n"
372          "                [--block-softlimit <block-softlimit>]\n"
373          "                [--block-hardlimit <block-hardlimit>]\n"
374          "                [--inode-softlimit <inode-softlimit>]\n"
375          "                [--inode-hardlimit <inode-hardlimit>] <filesystem>\n"
376          "       setquota [-t] <-u|--user|-g|--group|-p|--projid>\n"
377          "                [--block-grace <block-grace>]\n"
378          "                [--inode-grace <inode-grace>] <filesystem>\n"
379          "       -b can be used instead of --block-softlimit/--block-grace\n"
380          "       -B can be used instead of --block-hardlimit\n"
381          "       -i can be used instead of --inode-softlimit/--inode-grace\n"
382          "       -I can be used instead of --inode-hardlimit\n\n"
383          "Note: The total quota space will be split into many qunits and\n"
384          "      balanced over all server targets, the minimal qunit size is\n"
385          "      1M bytes for block space and 1K inodes for inode space.\n\n"
386          "      Quota space rebalancing process will stop when this mininum\n"
387          "      value is reached. As a result, quota exceeded can be returned\n"
388          "      while many targets still have 1MB or 1K inodes of spare\n"
389          "      quota space."},
390         {"quota", lfs_quota, 0, "Display disk usage and limits.\n"
391          "usage: quota [-q] [-v] [-h] [-o <obd_uuid>|-i <mdt_idx>|-I "
392                        "<ost_idx>]\n"
393          "             [<-u|-g|-p> <uname>|<uid>|<gname>|<gid>|<projid>] <filesystem>\n"
394          "       quota [-o <obd_uuid>|-i <mdt_idx>|-I <ost_idx>] -t <-u|-g|-p> <filesystem>"},
395         {"project", lfs_project, 0,
396          "Change or list project attribute for specified file or directory.\n"
397          "usage: project [-d|-r] <file|directory...>\n"
398          "         list project ID and flags on file(s) or directories\n"
399          "       project [-p id] [-s] [-r] <file|directory...>\n"
400          "         set project ID and/or inherit flag for specified file(s) or directories\n"
401          "       project -c [-d|-r [-p id] [-0]] <file|directory...>\n"
402          "         check project ID and flags on file(s) or directories, print outliers\n"
403          "       project -C [-r] [-k] <file|directory...>\n"
404          "         clear the project inherit flag and ID on the file or directory\n"
405         },
406 #endif
407         {"flushctx", lfs_flushctx, 0, "Flush security context for current user.\n"
408          "usage: flushctx [-k] [mountpoint...]"},
409         {"cp", lfs_cp, 0,
410          "Remote user copy files and directories.\n"
411          "usage: cp [OPTION]... [-T] SOURCE DEST\n\tcp [OPTION]... SOURCE... DIRECTORY\n\tcp [OPTION]... -t DIRECTORY SOURCE..."},
412         {"ls", lfs_ls, 0,
413          "Remote user list directory contents.\n"
414          "usage: ls [OPTION]... [FILE]..."},
415         {"changelog", lfs_changelog, 0,
416          "Show the metadata changes on an MDT."
417          "\nusage: changelog <mdtname> [startrec [endrec]]"},
418         {"changelog_clear", lfs_changelog_clear, 0,
419          "Indicate that old changelog records up to <endrec> are no longer of "
420          "interest to consumer <id>, allowing the system to free up space.\n"
421          "An <endrec> of 0 means all records.\n"
422          "usage: changelog_clear <mdtname> <id> <endrec>"},
423         {"fid2path", lfs_fid2path, 0,
424          "Resolve the full path(s) for given FID(s). For a specific hardlink "
425          "specify link number <linkno>.\n"
426         /* "For a historical link name, specify changelog record <recno>.\n" */
427          "usage: fid2path [--link <linkno>] <fsname|rootpath> <fid> ..."
428                 /* [ --rec <recno> ] */ },
429         {"path2fid", lfs_path2fid, 0, "Display the fid(s) for a given path(s).\n"
430          "usage: path2fid [--parents] <path> ..."},
431         {"data_version", lfs_data_version, 0, "Display file data version for "
432          "a given path.\n" "usage: data_version -[n|r|w] <path>"},
433         {"hsm_state", lfs_hsm_state, 0, "Display the HSM information (states, "
434          "undergoing actions) for given files.\n usage: hsm_state <file> ..."},
435         {"hsm_set", lfs_hsm_set, 0, "Set HSM user flag on specified files.\n"
436          "usage: hsm_set [--norelease] [--noarchive] [--dirty] [--exists] "
437          "[--archived] [--lost] [--archive-id NUM] <file> ..."},
438         {"hsm_clear", lfs_hsm_clear, 0, "Clear HSM user flag on specified "
439          "files.\n"
440          "usage: hsm_clear [--norelease] [--noarchive] [--dirty] [--exists] "
441          "[--archived] [--lost] <file> ..."},
442         {"hsm_action", lfs_hsm_action, 0, "Display current HSM request for "
443          "given files.\n" "usage: hsm_action <file> ..."},
444         {"hsm_archive", lfs_hsm_archive, 0,
445          "Archive file to external storage.\n"
446          "usage: hsm_archive [--filelist FILELIST] [--data DATA] [--archive NUM] "
447          "<file> ..."},
448         {"hsm_restore", lfs_hsm_restore, 0,
449          "Restore file from external storage.\n"
450          "usage: hsm_restore [--filelist FILELIST] [--data DATA] <file> ..."},
451         {"hsm_release", lfs_hsm_release, 0,
452          "Release files from Lustre.\n"
453          "usage: hsm_release [--filelist FILELIST] [--data DATA] <file> ..."},
454         {"hsm_remove", lfs_hsm_remove, 0,
455          "Remove file copy from external storage.\n"
456          "usage: hsm_remove [--filelist FILELIST] [--data DATA] "
457          "[--archive NUM]\n"
458          "                  (FILE [FILE ...] | "
459          "--mntpath MOUNTPATH FID [FID ...])\n"
460          "\n"
461          "Note: To remove an archived copy of a file already deleted from a "
462          "Lustre FS, the\n"
463          "--mntpath option and a list of FIDs must be specified"
464         },
465         {"hsm_cancel", lfs_hsm_cancel, 0,
466          "Cancel requests related to specified files.\n"
467          "usage: hsm_cancel [--filelist FILELIST] [--data DATA] <file> ..."},
468         {"swap_layouts", lfs_swap_layouts, 0, "Swap layouts between 2 files.\n"
469          "usage: swap_layouts <path1> <path2>"},
470         {"migrate", lfs_setstripe_migrate, 0,
471          "migrate a directory between MDTs.\n"
472          "usage: migrate --mdt-index <mdt_idx> [--verbose|-v] "
473          "<directory>\n"
474          "\tmdt_idx:      index of the destination MDT\n"
475          "\n"
476          "migrate file objects from one OST "
477          "layout\nto another (may be not safe with concurent writes).\n"
478          "usage: migrate  "
479          "[--stripe-count|-c] <stripe_count>\n"
480          "              [--stripe-index|-i] <start_ost_index>\n"
481          "              [--stripe-size|-S] <stripe_size>\n"
482          "              [--pool|-p] <pool_name>\n"
483          "              [--ost-list|-o] <ost_indices>\n"
484          "              [--block|-b]\n"
485          "              [--non-block|-n]\n"
486          "              <file|directory>\n"
487          "\tstripe_count:     number of OSTs to stripe a file over\n"
488          "\tstripe_ost_index: index of the first OST to stripe a file over\n"
489          "\tstripe_size:      number of bytes to store before moving to the next OST\n"
490          "\tpool_name:        name of the predefined pool of OSTs\n"
491          "\tost_indices:      OSTs to stripe over, in order\n"
492          "\tblock:            wait for the operation to return before continuing\n"
493          "\tnon-block:        do not wait for the operation to return.\n"},
494         {"mv", lfs_mv, 0,
495          "To move directories between MDTs. This command is deprecated, "
496          "use \"migrate\" instead.\n"
497          "usage: mv <directory|filename> [--mdt-index|-M] <mdt_index> "
498          "[--verbose|-v]\n"},
499         {"ladvise", lfs_ladvise, 0,
500          "Provide servers with advice about access patterns for a file.\n"
501          "usage: ladvise [--advice|-a ADVICE] [--start|-s START[kMGT]]\n"
502          "               [--background|-b] [--unset|-u]\n\n"
503          "               {[--end|-e END[kMGT]] | [--length|-l LENGTH[kMGT]]}\n"
504          "               {[--mode|-m [READ,WRITE]}\n"
505          "               <file> ...\n"},
506         {"mirror", lfs_mirror, mirror_cmdlist,
507          "lfs commands used to manage files with mirrored components:\n"
508          "lfs mirror create - create a mirrored file or directory\n"
509          "lfs mirror extend - add mirror(s) to an existing file\n"
510          "lfs mirror split  - split a mirror from an existing mirrored file\n"
511          "lfs mirror resync - resynchronize an out-of-sync mirrored file\n"
512          "lfs mirror verify - verify a mirrored file\n"},
513         {"help", Parser_help, 0, "help"},
514         {"exit", Parser_quit, 0, "quit"},
515         {"quit", Parser_quit, 0, "quit"},
516         {"--version", Parser_version, 0,
517          "output build version of the utility and exit"},
518         {"--list-commands", lfs_list_commands, 0,
519          "list commands supported by the utility and exit"},
520         { 0, 0, 0, NULL }
521 };
522
523
524 static int check_hashtype(const char *hashtype)
525 {
526         int i;
527
528         for (i = LMV_HASH_TYPE_ALL_CHARS; i < LMV_HASH_TYPE_MAX; i++)
529                 if (strcmp(hashtype, mdt_hash_name[i]) == 0)
530                         return i;
531
532         return 0;
533 }
534
535
536 static const char *error_loc = "syserror";
537
538 enum {
539         MIGRATION_NONBLOCK      = 1 << 0,
540         MIGRATION_MIRROR        = 1 << 1,
541 };
542
543 static int lfs_component_create(char *fname, int open_flags, mode_t open_mode,
544                                 struct llapi_layout *layout);
545
546 static int
547 migrate_open_files(const char *name, const struct llapi_stripe_param *param,
548                    struct llapi_layout *layout, int *fd_src, int *fd_tgt)
549 {
550         int                      fd = -1;
551         int                      fdv = -1;
552         int                      mdt_index;
553         int                      random_value;
554         char                     parent[PATH_MAX];
555         char                     volatile_file[PATH_MAX];
556         char                    *ptr;
557         int                      rc;
558         struct stat              st;
559         struct stat              stv;
560
561         if (param == NULL && layout == NULL) {
562                 error_loc = "layout information";
563                 return -EINVAL;
564         }
565
566         /* search for file directory pathname */
567         if (strlen(name) > sizeof(parent) - 1) {
568                 error_loc = "source file name";
569                 return -ERANGE;
570         }
571
572         strncpy(parent, name, sizeof(parent));
573         ptr = strrchr(parent, '/');
574         if (ptr == NULL) {
575                 if (getcwd(parent, sizeof(parent)) == NULL) {
576                         error_loc = "getcwd";
577                         return -errno;
578                 }
579         } else {
580                 if (ptr == parent) /* leading '/' */
581                         ptr = parent + 1;
582                 *ptr = '\0';
583         }
584
585         /* open file, direct io */
586         /* even if the file is only read, WR mode is nedeed to allow
587          * layout swap on fd */
588         fd = open(name, O_RDWR | O_DIRECT);
589         if (fd < 0) {
590                 rc = -errno;
591                 error_loc = "cannot open source file";
592                 return rc;
593         }
594
595         rc = llapi_file_fget_mdtidx(fd, &mdt_index);
596         if (rc < 0) {
597                 error_loc = "cannot get MDT index";
598                 goto out;
599         }
600
601         do {
602                 int open_flags = O_WRONLY | O_CREAT | O_EXCL | O_NOFOLLOW;
603                 mode_t open_mode = S_IRUSR | S_IWUSR;
604
605                 random_value = random();
606                 rc = snprintf(volatile_file, sizeof(volatile_file),
607                               "%s/%s:%.4X:%.4X", parent, LUSTRE_VOLATILE_HDR,
608                               mdt_index, random_value);
609                 if (rc >= sizeof(volatile_file)) {
610                         rc = -ENAMETOOLONG;
611                         break;
612                 }
613
614                 /* create, open a volatile file, use caching (ie no directio) */
615                 if (param != NULL)
616                         fdv = llapi_file_open_param(volatile_file, open_flags,
617                                                     open_mode, param);
618                 else
619                         fdv = lfs_component_create(volatile_file, open_flags,
620                                                    open_mode, layout);
621         } while (fdv < 0 && (rc = fdv) == -EEXIST);
622
623         if (rc < 0) {
624                 error_loc = "cannot create volatile file";
625                 goto out;
626         }
627
628         /* In case the MDT does not support creation of volatile files
629          * we should try to unlink it. */
630         (void)unlink(volatile_file);
631
632         /* Not-owner (root?) special case.
633          * Need to set owner/group of volatile file like original.
634          * This will allow to pass related check during layout_swap.
635          */
636         rc = fstat(fd, &st);
637         if (rc != 0) {
638                 rc = -errno;
639                 error_loc = "cannot stat source file";
640                 goto out;
641         }
642
643         rc = fstat(fdv, &stv);
644         if (rc != 0) {
645                 rc = -errno;
646                 error_loc = "cannot stat volatile";
647                 goto out;
648         }
649
650         if (st.st_uid != stv.st_uid || st.st_gid != stv.st_gid) {
651                 rc = fchown(fdv, st.st_uid, st.st_gid);
652                 if (rc != 0) {
653                         rc = -errno;
654                         error_loc = "cannot change ownwership of volatile";
655                         goto out;
656                 }
657         }
658
659 out:
660         if (rc < 0) {
661                 if (fd > 0)
662                         close(fd);
663                 if (fdv > 0)
664                         close(fdv);
665         } else {
666                 *fd_src = fd;
667                 *fd_tgt = fdv;
668                 error_loc = NULL;
669         }
670         return rc;
671 }
672
673 static int migrate_copy_data(int fd_src, int fd_dst, int (*check_file)(int))
674 {
675         struct llapi_layout *layout;
676         size_t   buf_size = 4 * 1024 * 1024;
677         void    *buf = NULL;
678         ssize_t  rsize = -1;
679         ssize_t  wsize = 0;
680         size_t   rpos = 0;
681         size_t   wpos = 0;
682         off_t    bufoff = 0;
683         int      rc;
684
685         layout = llapi_layout_get_by_fd(fd_src, 0);
686         if (layout != NULL) {
687                 uint64_t stripe_size;
688
689                 rc = llapi_layout_stripe_size_get(layout, &stripe_size);
690                 if (rc == 0)
691                         buf_size = stripe_size;
692
693                 llapi_layout_free(layout);
694         }
695
696         /* Use a page-aligned buffer for direct I/O */
697         rc = posix_memalign(&buf, getpagesize(), buf_size);
698         if (rc != 0)
699                 return -rc;
700
701         while (1) {
702                 /* read new data only if we have written all
703                  * previously read data */
704                 if (wpos == rpos) {
705                         if (check_file) {
706                                 rc = check_file(fd_src);
707                                 if (rc < 0)
708                                         break;
709                         }
710
711                         rsize = read(fd_src, buf, buf_size);
712                         if (rsize < 0) {
713                                 rc = -errno;
714                                 break;
715                         }
716                         rpos += rsize;
717                         bufoff = 0;
718                 }
719                 /* eof ? */
720                 if (rsize == 0)
721                         break;
722
723                 wsize = write(fd_dst, buf + bufoff, rpos - wpos);
724                 if (wsize < 0) {
725                         rc = -errno;
726                         break;
727                 }
728                 wpos += wsize;
729                 bufoff += wsize;
730         }
731
732         if (rc == 0) {
733                 rc = fsync(fd_dst);
734                 if (rc < 0)
735                         rc = -errno;
736         }
737
738         free(buf);
739         return rc;
740 }
741
742 static int migrate_copy_timestamps(int fd, int fdv)
743 {
744         struct stat st;
745
746         if (fstat(fd, &st) == 0) {
747                 struct timeval tv[2] = {
748                         {.tv_sec = st.st_atime},
749                         {.tv_sec = st.st_mtime}
750                 };
751
752                 return futimes(fdv, tv);
753         }
754
755         return -errno;
756 }
757
758 static int migrate_block(int fd, int fdv)
759 {
760         __u64   dv1;
761         int     gid;
762         int     rc;
763         int     rc2;
764
765         rc = llapi_get_data_version(fd, &dv1, LL_DV_RD_FLUSH);
766         if (rc < 0) {
767                 error_loc = "cannot get dataversion";
768                 return rc;
769         }
770
771         do
772                 gid = random();
773         while (gid == 0);
774
775         /* The grouplock blocks all concurrent accesses to the file.
776          * It has to be taken after llapi_get_data_version as it would
777          * block it too. */
778         rc = llapi_group_lock(fd, gid);
779         if (rc < 0) {
780                 error_loc = "cannot get group lock";
781                 return rc;
782         }
783
784         rc = migrate_copy_data(fd, fdv, NULL);
785         if (rc < 0) {
786                 error_loc = "data copy failed";
787                 goto out_unlock;
788         }
789
790         /* Make sure we keep original atime/mtime values */
791         rc = migrate_copy_timestamps(fd, fdv);
792         if (rc < 0) {
793                 error_loc = "timestamp copy failed";
794                 goto out_unlock;
795         }
796
797         /* swap layouts
798          * for a migration we need to check data version on file did
799          * not change.
800          *
801          * Pass in gid=0 since we already own grouplock. */
802         rc = llapi_fswap_layouts_grouplock(fd, fdv, dv1, 0, 0,
803                                            SWAP_LAYOUTS_CHECK_DV1);
804         if (rc == -EAGAIN) {
805                 error_loc = "file changed";
806                 goto out_unlock;
807         } else if (rc < 0) {
808                 error_loc = "cannot swap layout";
809                 goto out_unlock;
810         }
811
812 out_unlock:
813         rc2 = llapi_group_unlock(fd, gid);
814         if (rc2 < 0 && rc == 0) {
815                 error_loc = "unlock group lock";
816                 rc = rc2;
817         }
818
819         return rc;
820 }
821
822 /**
823  * Internal helper for migrate_copy_data(). Check lease and report error if
824  * need be.
825  *
826  * \param[in]  fd           File descriptor on which to check the lease.
827  *
828  * \retval 0       Migration can keep on going.
829  * \retval -errno  Error occurred, abort migration.
830  */
831 static int check_lease(int fd)
832 {
833         int rc;
834
835         rc = llapi_lease_check(fd);
836         if (rc > 0)
837                 return 0; /* llapi_check_lease returns > 0 on success. */
838
839         return -EBUSY;
840 }
841
842 static int migrate_nonblock(int fd, int fdv)
843 {
844         __u64   dv1;
845         __u64   dv2;
846         int     rc;
847
848         rc = llapi_get_data_version(fd, &dv1, LL_DV_RD_FLUSH);
849         if (rc < 0) {
850                 error_loc = "cannot get data version";
851                 return rc;
852         }
853
854         rc = migrate_copy_data(fd, fdv, check_lease);
855         if (rc < 0) {
856                 error_loc = "data copy failed";
857                 return rc;
858         }
859
860         rc = llapi_get_data_version(fd, &dv2, LL_DV_RD_FLUSH);
861         if (rc != 0) {
862                 error_loc = "cannot get data version";
863                 return rc;
864         }
865
866         if (dv1 != dv2) {
867                 rc = -EAGAIN;
868                 error_loc = "source file changed";
869                 return rc;
870         }
871
872         /* Make sure we keep original atime/mtime values */
873         rc = migrate_copy_timestamps(fd, fdv);
874         if (rc < 0) {
875                 error_loc = "timestamp copy failed";
876                 return rc;
877         }
878
879         return 0;
880 }
881
882 static int lfs_component_set(char *fname, int comp_id,
883                              __u32 flags, __u32 neg_flags)
884 {
885         __u32 ids[2];
886         __u32 flags_array[2];
887         size_t count = 0;
888         int rc;
889
890         if (flags) {
891                 ids[count] = comp_id;
892                 flags_array[count] = flags;
893                 ++count;
894         }
895
896         if (neg_flags) {
897                 ids[count] = comp_id;
898                 flags_array[count] = neg_flags | LCME_FL_NEG;
899                 ++count;
900         }
901
902         rc = llapi_layout_file_comp_set(fname, ids, flags_array, count);
903         if (rc)
904                 fprintf(stderr,
905                         "%s: cannot change the flags of component '%#x' of file '%s': %x / ^(%x)\n",
906                         progname, comp_id, fname, flags, neg_flags);
907
908         return rc;
909 }
910
911 static int lfs_component_del(char *fname, __u32 comp_id,
912                              __u32 flags, __u32 neg_flags)
913 {
914         int     rc = 0;
915
916         if (flags && neg_flags)
917                 return -EINVAL;
918
919         if (!flags && neg_flags)
920                 flags = neg_flags | LCME_FL_NEG;
921
922         if ((flags && comp_id) || (!flags && !comp_id))
923                 return -EINVAL;
924
925         /* LCME_FL_INIT is the only supported flag in PFL */
926         if (flags) {
927                 if (flags & ~LCME_KNOWN_FLAGS) {
928                         fprintf(stderr,
929                                 "%s setstripe: unknown flags %#x\n",
930                                 progname, flags);
931                         return -EINVAL;
932                 }
933         } else if (comp_id > LCME_ID_MAX) {
934                 fprintf(stderr, "%s setstripe: invalid component id %u\n",
935                         progname, comp_id);
936                 return -EINVAL;
937         }
938
939         rc = llapi_layout_file_comp_del(fname, comp_id, flags);
940         if (rc)
941                 fprintf(stderr,
942                         "%s setstripe: cannot delete component %#x from '%s': %s\n",
943                         progname, comp_id, fname, strerror(errno));
944         return rc;
945 }
946
947 static int lfs_component_add(char *fname, struct llapi_layout *layout)
948 {
949         int     rc;
950
951         if (layout == NULL)
952                 return -EINVAL;
953
954         rc = llapi_layout_file_comp_add(fname, layout);
955         if (rc)
956                 fprintf(stderr, "Add layout component(s) to %s failed. %s\n",
957                         fname, strerror(errno));
958         return rc;
959 }
960
961 static int lfs_component_create(char *fname, int open_flags, mode_t open_mode,
962                                 struct llapi_layout *layout)
963 {
964         struct stat     st;
965         int     fd;
966
967         if (layout == NULL)
968                 return -EINVAL;
969
970         fd = lstat(fname, &st);
971         if (fd == 0 && S_ISDIR(st.st_mode))
972                 open_flags = O_DIRECTORY | O_RDONLY;
973
974         fd = llapi_layout_file_open(fname, open_flags, open_mode, layout);
975         if (fd < 0)
976                 fprintf(stderr, "%s: cannot %s '%s': %s\n", progname,
977                         S_ISDIR(st.st_mode) ?
978                                 "set default composite layout for" :
979                                 "create composite file",
980                         fname, strerror(errno));
981         return fd;
982 }
983
984 static int lfs_migrate(char *name, __u64 migration_flags,
985                        struct llapi_stripe_param *param,
986                        struct llapi_layout *layout)
987 {
988         int fd = -1;
989         int fdv = -1;
990         int rc;
991
992         rc = migrate_open_files(name, param, layout, &fd, &fdv);
993         if (rc < 0)
994                 goto out;
995
996         if (!(migration_flags & MIGRATION_NONBLOCK)) {
997                 /* Blocking mode (forced if servers do not support file lease).
998                  * It is also the default mode, since we cannot distinguish
999                  * between a broken lease and a server that does not support
1000                  * atomic swap/close (LU-6785) */
1001                 rc = migrate_block(fd, fdv);
1002                 goto out;
1003         }
1004
1005         rc = llapi_lease_get(fd, LL_LEASE_RDLCK);
1006         if (rc < 0) {
1007                 error_loc = "cannot get lease";
1008                 goto out;
1009         }
1010
1011         rc = migrate_nonblock(fd, fdv);
1012         if (rc < 0) {
1013                 llapi_lease_put(fd);
1014                 goto out;
1015         }
1016
1017         /* Atomically put lease, swap layouts and close.
1018          * for a migration we need to check data version on file did
1019          * not change. */
1020         rc = llapi_fswap_layouts(fd, fdv, 0, 0,
1021                                  migration_flags & MIGRATION_MIRROR ?
1022                                  MERGE_LAYOUTS_CLOSE : SWAP_LAYOUTS_CLOSE);
1023         if (rc < 0) {
1024                 error_loc = "cannot swap layout";
1025                 goto out;
1026         }
1027
1028 out:
1029         if (fd >= 0)
1030                 close(fd);
1031
1032         if (fdv >= 0)
1033                 close(fdv);
1034
1035         if (rc < 0)
1036                 fprintf(stderr, "error: %s: %s: %s: %s\n",
1037                         progname, name, error_loc, strerror(-rc));
1038         return rc;
1039 }
1040
1041 static int comp_str2flags(char *string, __u32 *flags, __u32 *neg_flags)
1042 {
1043         char *name;
1044
1045         if (string == NULL)
1046                 return -EINVAL;
1047
1048         *flags = 0;
1049         *neg_flags = 0;
1050         for (name = strtok(string, ","); name; name = strtok(NULL, ",")) {
1051                 bool found = false;
1052                 int i;
1053
1054                 for (i = 0; i < ARRAY_SIZE(comp_flags_table); i++) {
1055                         __u32 comp_flag = comp_flags_table[i].cfn_flag;
1056                         const char *comp_name = comp_flags_table[i].cfn_name;
1057
1058                         if (strcmp(name, comp_name) == 0) {
1059                                 *flags |= comp_flag;
1060                                 found = true;
1061                         } else if (strncmp(name, "^", 1) == 0 &&
1062                                    strcmp(name + 1, comp_name) == 0) {
1063                                 *neg_flags |= comp_flag;
1064                                 found = true;
1065                         }
1066                 }
1067                 if (!found) {
1068                         llapi_printf(LLAPI_MSG_ERROR,
1069                                      "%s: component flag '%s' not supported\n",
1070                                      progname, name);
1071                         return -EINVAL;
1072                 }
1073         }
1074
1075         if (!*flags && !*neg_flags)
1076                 return -EINVAL;
1077
1078         /* don't allow to set and exclude the same flag */
1079         if (*flags & *neg_flags)
1080                 return -EINVAL;
1081
1082         return 0;
1083 }
1084
1085 /**
1086  * struct mirror_args - Command-line arguments for mirror(s).
1087  * @m_count:  Number of mirrors to be created with this layout.
1088  * @m_flags:  Mirror level flags, only 'prefer' is supported.
1089  * @m_layout: Mirror layout.
1090  * @m_file:   A victim file. Its layout will be split and used as a mirror.
1091  * @m_next:   Point to the next node of the list.
1092  *
1093  * Command-line arguments for mirror(s) will be parsed and stored in
1094  * a linked list that consists of this structure.
1095  */
1096 struct mirror_args {
1097         __u32                   m_count;
1098         __u32                   m_flags;
1099         struct llapi_layout     *m_layout;
1100         const char              *m_file;
1101         struct mirror_args      *m_next;
1102 };
1103
1104 static int mirror_sanity_check_flags(struct llapi_layout *layout, void *unused)
1105 {
1106         uint32_t flags;
1107         int rc;
1108
1109         rc = llapi_layout_comp_flags_get(layout, &flags);
1110         if (rc)
1111                 return -errno;
1112
1113         if (flags & LCME_FL_NEG) {
1114                 fprintf(stderr, "error: %s: negative flags are not supported\n",
1115                         progname);
1116                 return -EINVAL;
1117         }
1118
1119         if (flags & LCME_FL_STALE) {
1120                 fprintf(stderr, "error: %s: setting '%s' is not supported\n",
1121                         progname, comp_flags_table[LCME_FL_STALE].cfn_name);
1122                 return -EINVAL;
1123         }
1124
1125         return LLAPI_LAYOUT_ITER_CONT;
1126 }
1127
1128 static inline int mirror_sanity_check_one(struct llapi_layout *layout)
1129 {
1130         uint64_t start, end;
1131         uint64_t pattern;
1132         int rc;
1133
1134         /* LU-10112: do not support dom+flr in phase 1 */
1135         rc = llapi_layout_comp_use(layout, LLAPI_LAYOUT_COMP_USE_FIRST);
1136         if (rc)
1137                 return -errno;
1138
1139         rc = llapi_layout_pattern_get(layout, &pattern);
1140         if (rc)
1141                 return -errno;
1142
1143         if (pattern == LOV_PATTERN_MDT || pattern == LLAPI_LAYOUT_MDT) {
1144                 fprintf(stderr, "error: %s: doesn't support dom+flr for now\n",
1145                         progname);
1146                 return -ENOTSUP;
1147         }
1148
1149         rc = llapi_layout_comp_use(layout, LLAPI_LAYOUT_COMP_USE_LAST);
1150         if (rc)
1151                 return -errno;
1152
1153         rc = llapi_layout_comp_extent_get(layout, &start, &end);
1154         if (rc)
1155                 return -errno;
1156
1157         if (end != LUSTRE_EOF) {
1158                 fprintf(stderr, "error: %s: mirror layout doesn't reach eof\n",
1159                         progname);
1160                 return -EINVAL;
1161         }
1162
1163         rc = llapi_layout_comp_iterate(layout, mirror_sanity_check_flags, NULL);
1164         return rc;
1165 }
1166
1167 /**
1168  * enum mirror_flags - Flags for extending a mirrored file.
1169  * @NO_VERIFY: Indicates not to verify the mirror(s) from victim file(s)
1170  *             in case the victim file(s) contains the same data as the
1171  *             original mirrored file.
1172  *
1173  * Flags for extending a mirrored file.
1174  */
1175 enum mirror_flags {
1176         NO_VERIFY       = 0x1,
1177 };
1178
1179 /**
1180  * mirror_create_sanity_check() - Check mirror list.
1181  * @list:  A linked list that stores the mirror arguments.
1182  *
1183  * This function does a sanity check on @list for creating
1184  * a mirrored file.
1185  *
1186  * Return: 0 on success or a negative error code on failure.
1187  */
1188 static int mirror_create_sanity_check(const char *fname,
1189                                       struct mirror_args *list)
1190 {
1191         int rc = 0;
1192         bool has_m_file = false;
1193         bool has_m_layout = false;
1194
1195         if (list == NULL)
1196                 return -EINVAL;
1197
1198         if (fname) {
1199                 struct llapi_layout *layout;
1200
1201                 layout = llapi_layout_get_by_path(fname, 0);
1202                 if (!layout) {
1203                         fprintf(stderr,
1204                                 "error: %s: file '%s' couldn't get layout\n",
1205                                 progname, fname);
1206                         return -ENODATA;
1207                 }
1208
1209                 rc = mirror_sanity_check_one(layout);
1210                 llapi_layout_free(layout);
1211
1212                 if (rc)
1213                         return rc;
1214         }
1215
1216         while (list != NULL) {
1217                 if (list->m_file != NULL) {
1218                         has_m_file = true;
1219                         llapi_layout_free(list->m_layout);
1220
1221                         list->m_layout =
1222                                 llapi_layout_get_by_path(list->m_file, 0);
1223                         if (list->m_layout == NULL) {
1224                                 fprintf(stderr,
1225                                         "error: %s: file '%s' has no layout\n",
1226                                         progname, list->m_file);
1227                                 return -ENODATA;
1228                         }
1229                 } else {
1230                         has_m_layout = true;
1231                         if (list->m_layout == NULL) {
1232                                 fprintf(stderr, "error: %s: no mirror layout\n",
1233                                         progname);
1234                                 return -EINVAL;
1235                         }
1236                 }
1237
1238                 rc = mirror_sanity_check_one(list->m_layout);
1239                 if (rc)
1240                         return rc;
1241
1242                 list = list->m_next;
1243         }
1244
1245         if (has_m_file && has_m_layout) {
1246                 fprintf(stderr, "error: %s: -f <victim_file> option should not "
1247                         "be specified with setstripe options or "
1248                         "--parent option\n", progname);
1249                 return -EINVAL;
1250         }
1251
1252         return 0;
1253 }
1254
1255 static int mirror_set_flags(struct llapi_layout *layout, void *cbdata)
1256 {
1257         __u32 mirror_flags = *(__u32 *)cbdata;
1258         uint32_t flags;
1259         int rc;
1260
1261         rc = llapi_layout_comp_flags_get(layout, &flags);
1262         if (rc < 0)
1263                 return rc;
1264
1265         if (!flags) {
1266                 rc = llapi_layout_comp_flags_set(layout, mirror_flags);
1267                 if (rc)
1268                         return rc;
1269         }
1270
1271         return LLAPI_LAYOUT_ITER_CONT;
1272 }
1273
1274 /**
1275  * mirror_create() - Create a mirrored file.
1276  * @fname:        The file to be created.
1277  * @mirror_list:  A linked list that stores the mirror arguments.
1278  *
1279  * This function creates a mirrored file @fname with the mirror(s)
1280  * from @mirror_list.
1281  *
1282  * Return: 0 on success or a negative error code on failure.
1283  */
1284 static int mirror_create(char *fname, struct mirror_args *mirror_list)
1285 {
1286         struct llapi_layout *layout = NULL;
1287         struct mirror_args *cur_mirror = NULL;
1288         uint16_t mirror_count = 0;
1289         int i = 0;
1290         int rc = 0;
1291
1292         rc = mirror_create_sanity_check(NULL, mirror_list);
1293         if (rc)
1294                 return rc;
1295
1296         cur_mirror = mirror_list;
1297         while (cur_mirror != NULL) {
1298                 rc = llapi_layout_comp_iterate(cur_mirror->m_layout,
1299                                                mirror_set_flags,
1300                                                &cur_mirror->m_flags);
1301                 if (rc) {
1302                         rc = -errno;
1303                         fprintf(stderr, "%s: failed to set mirror flags\n",
1304                                 progname);
1305                         goto error;
1306                 }
1307
1308                 for (i = 0; i < cur_mirror->m_count; i++) {
1309                         rc = llapi_layout_merge(&layout, cur_mirror->m_layout);
1310                         if (rc) {
1311                                 rc = -errno;
1312                                 fprintf(stderr, "error: %s: "
1313                                         "merge layout failed: %s\n",
1314                                         progname, strerror(errno));
1315                                 goto error;
1316                         }
1317                 }
1318                 mirror_count += cur_mirror->m_count;
1319                 cur_mirror = cur_mirror->m_next;
1320         }
1321
1322         rc = llapi_layout_mirror_count_set(layout, mirror_count);
1323         if (rc) {
1324                 rc = -errno;
1325                 fprintf(stderr, "error: %s: set mirror count failed: %s\n",
1326                         progname, strerror(errno));
1327                 goto error;
1328         }
1329
1330         rc = lfs_component_create(fname, O_CREAT | O_WRONLY, 0644,
1331                                   layout);
1332         if (rc >= 0) {
1333                 close(rc);
1334                 rc = 0;
1335         }
1336
1337 error:
1338         llapi_layout_free(layout);
1339         return rc;
1340 }
1341
1342 /**
1343  * Compare files and check lease on @fd.
1344  *
1345  * \retval bytes number of bytes are the same
1346  */
1347 static ssize_t mirror_file_compare(int fd, int fdv)
1348 {
1349         const size_t buflen = 4 * 1024 * 1024; /* 4M */
1350         void *buf;
1351         ssize_t bytes_done = 0;
1352         ssize_t bytes_read = 0;
1353
1354         buf = malloc(buflen * 2);
1355         if (!buf)
1356                 return -ENOMEM;
1357
1358         while (1) {
1359                 if (!llapi_lease_check(fd)) {
1360                         bytes_done = -EBUSY;
1361                         break;
1362                 }
1363
1364                 bytes_read = read(fd, buf, buflen);
1365                 if (bytes_read <= 0)
1366                         break;
1367
1368                 if (bytes_read != read(fdv, buf + buflen, buflen))
1369                         break;
1370
1371                 /* XXX: should compute the checksum on each buffer and then
1372                  * compare checksum to avoid cache collision */
1373                 if (memcmp(buf, buf + buflen, bytes_read))
1374                         break;
1375
1376                 bytes_done += bytes_read;
1377         }
1378
1379         free(buf);
1380
1381         return bytes_done;
1382 }
1383
1384 static int mirror_extend_file(const char *fname, const char *victim_file,
1385                               enum mirror_flags mirror_flags)
1386 {
1387         int fd = -1;
1388         int fdv = -1;
1389         struct stat stbuf;
1390         struct stat stbuf_v;
1391         int rc;
1392
1393         fd = open(fname, O_RDWR);
1394         if (fd < 0) {
1395                 error_loc = "open source file";
1396                 rc = -errno;
1397                 goto out;
1398         }
1399
1400         fdv = open(victim_file, O_RDWR);
1401         if (fdv < 0) {
1402                 error_loc = "open target file";
1403                 rc = -errno;
1404                 goto out;
1405         }
1406
1407         if (fstat(fd, &stbuf) || fstat(fdv, &stbuf_v)) {
1408                 error_loc = "stat source or target file";
1409                 rc = -errno;
1410                 goto out;
1411         }
1412
1413         if (stbuf.st_dev != stbuf_v.st_dev) {
1414                 error_loc = "stat source and target file";
1415                 rc = -EXDEV;
1416                 goto out;
1417         }
1418
1419         /* mirrors should be of the same size */
1420         if (stbuf.st_size != stbuf_v.st_size) {
1421                 error_loc = "file sizes don't match";
1422                 rc = -EINVAL;
1423                 goto out;
1424         }
1425
1426         rc = llapi_lease_get(fd, LL_LEASE_RDLCK);
1427         if (rc < 0) {
1428                 error_loc = "cannot get lease";
1429                 goto out;
1430         }
1431
1432         if (!(mirror_flags & NO_VERIFY)) {
1433                 ssize_t ret;
1434                 /* mirrors should have the same contents */
1435                 ret = mirror_file_compare(fd, fdv);
1436                 if (ret != stbuf.st_size) {
1437                         error_loc = "file busy or contents don't match";
1438                         rc = ret < 0 ? ret : -EINVAL;
1439                         goto out;
1440                 }
1441         }
1442
1443         /* Get rid of caching pages from clients */
1444         rc = llapi_file_flush(fd);
1445         if (rc < 0) {
1446                 error_loc = "cannot get data version";
1447                 return rc;
1448         }
1449
1450         rc = llapi_file_flush(fdv);
1451         if (rc < 0) {
1452                 error_loc = "cannot get data version";
1453                 return rc;
1454
1455         }
1456
1457         /* Make sure we keep original atime/mtime values */
1458         rc = migrate_copy_timestamps(fd, fdv);
1459
1460         /* Atomically put lease, swap layouts and close.
1461          * for a migration we need to check data version on file did
1462          * not change. */
1463         rc = llapi_fswap_layouts(fd, fdv, 0, 0, MERGE_LAYOUTS_CLOSE);
1464         if (rc < 0) {
1465                 error_loc = "cannot swap layout";
1466                 goto out;
1467         }
1468
1469 out:
1470         if (fd >= 0)
1471                 close(fd);
1472
1473         if (fdv >= 0)
1474                 close(fdv);
1475
1476         if (!rc)
1477                 (void) unlink(victim_file);
1478
1479         if (rc < 0)
1480                 fprintf(stderr, "error: %s: %s: %s: %s\n",
1481                         progname, fname, error_loc, strerror(-rc));
1482         return rc;
1483 }
1484
1485 static int mirror_extend(char *fname, struct mirror_args *mirror_list,
1486                          enum mirror_flags mirror_flags)
1487 {
1488         int rc;
1489
1490         rc = mirror_create_sanity_check(fname, mirror_list);
1491         if (rc)
1492                 return rc;
1493
1494         while (mirror_list) {
1495                 if (mirror_list->m_file != NULL) {
1496                         rc = mirror_extend_file(fname, mirror_list->m_file,
1497                                                 mirror_flags);
1498                 } else {
1499                         __u32 mirror_count = mirror_list->m_count;
1500
1501                         while (mirror_count > 0) {
1502                                 rc = lfs_migrate(fname,
1503                                         MIGRATION_NONBLOCK | MIGRATION_MIRROR,
1504                                         NULL, mirror_list->m_layout);
1505                                 if (rc)
1506                                         break;
1507
1508                                 --mirror_count;
1509                         }
1510                 }
1511                 if (rc)
1512                         break;
1513
1514                 mirror_list = mirror_list->m_next;
1515         }
1516
1517         return rc;
1518 }
1519
1520 /**
1521  * Parse a string containing an target index list into an array of integers.
1522  *
1523  * The input string contains a comma delimited list of individual
1524  * indices and ranges, for example "1,2-4,7". Add the indices into the
1525  * \a tgts array and remove duplicates.
1526  *
1527  * \param[out] tgts    array to store indices in
1528  * \param[in] size     size of \a tgts array
1529  * \param[in] offset   starting index in \a tgts
1530  * \param[in] arg      string containing OST index list
1531  *
1532  * \retval positive    number of indices in \a tgts
1533  * \retval -EINVAL     unable to parse \a arg
1534  */
1535 static int parse_targets(__u32 *tgts, int size, int offset, char *arg)
1536 {
1537         int rc;
1538         int nr = offset;
1539         int slots = size - offset;
1540         char *ptr = NULL;
1541         bool end_of_loop;
1542
1543         if (arg == NULL)
1544                 return -EINVAL;
1545
1546         end_of_loop = false;
1547         while (!end_of_loop) {
1548                 int start_index;
1549                 int end_index;
1550                 int i;
1551                 char *endptr = NULL;
1552
1553                 rc = -EINVAL;
1554
1555                 ptr = strchrnul(arg, ',');
1556
1557                 end_of_loop = *ptr == '\0';
1558                 *ptr = '\0';
1559
1560                 start_index = strtol(arg, &endptr, 0);
1561                 if (endptr == arg) /* no data at all */
1562                         break;
1563                 if (*endptr != '-' && *endptr != '\0') /* has invalid data */
1564                         break;
1565
1566                 end_index = start_index;
1567                 if (*endptr == '-') {
1568                         end_index = strtol(endptr + 1, &endptr, 0);
1569                         if (*endptr != '\0')
1570                                 break;
1571                         if (end_index < start_index)
1572                                 break;
1573                 }
1574
1575                 for (i = start_index; i <= end_index && slots > 0; i++) {
1576                         int j;
1577
1578                         /* remove duplicate */
1579                         for (j = 0; j < offset; j++) {
1580                                 if (tgts[j] == i)
1581                                         break;
1582                         }
1583                         if (j == offset) { /* no duplicate */
1584                                 tgts[nr++] = i;
1585                                 --slots;
1586                         }
1587                 }
1588                 if (slots == 0 && i < end_index)
1589                         break;
1590
1591                 *ptr = ',';
1592                 arg = ++ptr;
1593                 offset = nr;
1594                 rc = 0;
1595         }
1596         if (!end_of_loop && ptr != NULL)
1597                 *ptr = ',';
1598
1599         return rc < 0 ? rc : nr;
1600 }
1601
1602 struct lfs_setstripe_args {
1603         unsigned long long       lsa_comp_end;
1604         unsigned long long       lsa_stripe_size;
1605         long long                lsa_stripe_count;
1606         long long                lsa_stripe_off;
1607         __u32                    lsa_comp_flags;
1608         __u32                    lsa_comp_neg_flags;
1609         unsigned long long       lsa_pattern;
1610         int                      lsa_nr_tgts;
1611         __u32                   *lsa_tgts;
1612         char                    *lsa_pool_name;
1613 };
1614
1615 static inline void setstripe_args_init(struct lfs_setstripe_args *lsa)
1616 {
1617         memset(lsa, 0, sizeof(*lsa));
1618
1619         lsa->lsa_stripe_size = LLAPI_LAYOUT_DEFAULT;
1620         lsa->lsa_stripe_count = LLAPI_LAYOUT_DEFAULT;
1621         lsa->lsa_stripe_off = LLAPI_LAYOUT_DEFAULT;
1622         lsa->lsa_pattern = LLAPI_LAYOUT_RAID0;
1623         lsa->lsa_pool_name = NULL;
1624 }
1625
1626 /**
1627  * setstripe_args_init_inherit() - Initialize and inherit stripe options.
1628  * @lsa: Stripe options to be initialized and inherited.
1629  *
1630  * This function initializes stripe options in @lsa and inherit
1631  * stripe_size, stripe_count and OST pool_name options.
1632  *
1633  * Return: void.
1634  */
1635 static inline void setstripe_args_init_inherit(struct lfs_setstripe_args *lsa)
1636 {
1637         unsigned long long stripe_size;
1638         long long stripe_count;
1639         char *pool_name = NULL;
1640
1641         stripe_size = lsa->lsa_stripe_size;
1642         stripe_count = lsa->lsa_stripe_count;
1643         pool_name = lsa->lsa_pool_name;
1644
1645         setstripe_args_init(lsa);
1646
1647         lsa->lsa_stripe_size = stripe_size;
1648         lsa->lsa_stripe_count = stripe_count;
1649         lsa->lsa_pool_name = pool_name;
1650 }
1651
1652 static inline bool setstripe_args_specified(struct lfs_setstripe_args *lsa)
1653 {
1654         return (lsa->lsa_stripe_size != LLAPI_LAYOUT_DEFAULT ||
1655                 lsa->lsa_stripe_count != LLAPI_LAYOUT_DEFAULT ||
1656                 lsa->lsa_stripe_off != LLAPI_LAYOUT_DEFAULT ||
1657                 lsa->lsa_pattern != LLAPI_LAYOUT_RAID0 ||
1658                 lsa->lsa_pool_name != NULL ||
1659                 lsa->lsa_comp_end != 0);
1660 }
1661
1662 /**
1663  * comp_args_to_layout() - Create or extend a composite layout.
1664  * @composite:       Pointer to the composite layout.
1665  * @lsa:             Stripe options for the new component.
1666  *
1667  * This function creates or extends a composite layout by adding a new
1668  * component with stripe options from @lsa.
1669  *
1670  * Return: 0 on success or an error code on failure.
1671  */
1672 static int comp_args_to_layout(struct llapi_layout **composite,
1673                                struct lfs_setstripe_args *lsa)
1674 {
1675         struct llapi_layout *layout = *composite;
1676         uint64_t prev_end = 0;
1677         int i = 0, rc;
1678
1679         if (layout == NULL) {
1680                 layout = llapi_layout_alloc();
1681                 if (layout == NULL) {
1682                         fprintf(stderr, "Alloc llapi_layout failed. %s\n",
1683                                 strerror(errno));
1684                         return -ENOMEM;
1685                 }
1686                 *composite = layout;
1687         } else {
1688                 uint64_t start;
1689
1690                 /* Get current component extent, current component
1691                  * must be the tail component. */
1692                 rc = llapi_layout_comp_extent_get(layout, &start, &prev_end);
1693                 if (rc) {
1694                         fprintf(stderr, "Get comp extent failed. %s\n",
1695                                 strerror(errno));
1696                         return rc;
1697                 }
1698
1699                 rc = llapi_layout_comp_add(layout);
1700                 if (rc) {
1701                         fprintf(stderr, "Add component failed. %s\n",
1702                                 strerror(errno));
1703                         return rc;
1704                 }
1705         }
1706
1707         rc = llapi_layout_comp_extent_set(layout, prev_end, lsa->lsa_comp_end);
1708         if (rc) {
1709                 fprintf(stderr, "Set extent [%lu, %llu) failed. %s\n",
1710                         prev_end, lsa->lsa_comp_end, strerror(errno));
1711                 return rc;
1712         }
1713
1714         /* Data-on-MDT component setting */
1715         if (lsa->lsa_pattern == LLAPI_LAYOUT_MDT) {
1716                 /* In case of Data-on-MDT patterns the only extra option
1717                  * applicable is stripe size option. */
1718                 if (lsa->lsa_stripe_count != LLAPI_LAYOUT_DEFAULT) {
1719                         fprintf(stderr, "Option 'stripe-count' can't be "
1720                                 "specified with Data-on-MDT component: %lld\n",
1721                                 lsa->lsa_stripe_count);
1722                         return -EINVAL;
1723                 }
1724                 if (lsa->lsa_stripe_size != LLAPI_LAYOUT_DEFAULT) {
1725                         fprintf(stderr, "Option 'stripe-size' can't be "
1726                                 "specified with Data-on-MDT component: %llu\n",
1727                                 lsa->lsa_stripe_size);
1728                         return -EINVAL;
1729                 }
1730                 if (lsa->lsa_nr_tgts != 0) {
1731                         fprintf(stderr, "Option 'ost-list' can't be specified "
1732                                 "with Data-on-MDT component: '%i'\n",
1733                                 lsa->lsa_nr_tgts);
1734                         return -EINVAL;
1735                 }
1736                 if (lsa->lsa_stripe_off != LLAPI_LAYOUT_DEFAULT) {
1737                         fprintf(stderr, "Option 'stripe-offset' can't be "
1738                                 "specified with Data-on-MDT component: %lld\n",
1739                                 lsa->lsa_stripe_off);
1740                         return -EINVAL;
1741                 }
1742                 if (lsa->lsa_pool_name != 0) {
1743                         fprintf(stderr, "Option 'pool' can't be specified "
1744                                 "with Data-on-MDT component: '%s'\n",
1745                                 lsa->lsa_pool_name);
1746                         return -EINVAL;
1747                 }
1748
1749                 rc = llapi_layout_pattern_set(layout, lsa->lsa_pattern);
1750                 if (rc) {
1751                         fprintf(stderr, "Set stripe pattern %#llx failed. %s\n",
1752                                 lsa->lsa_pattern, strerror(errno));
1753                         return rc;
1754                 }
1755                 /* Data-on-MDT component has always single stripe up to end */
1756                 lsa->lsa_stripe_size = lsa->lsa_comp_end;
1757         }
1758
1759         rc = llapi_layout_stripe_size_set(layout, lsa->lsa_stripe_size);
1760         if (rc) {
1761                 fprintf(stderr, "Set stripe size %llu failed: %s\n",
1762                         lsa->lsa_stripe_size, strerror(errno));
1763                 return rc;
1764         }
1765
1766         rc = llapi_layout_stripe_count_set(layout, lsa->lsa_stripe_count);
1767         if (rc) {
1768                 fprintf(stderr, "Set stripe count %lld failed: %s\n",
1769                         lsa->lsa_stripe_count, strerror(errno));
1770                 return rc;
1771         }
1772
1773         rc = llapi_layout_comp_flags_set(layout, lsa->lsa_comp_flags);
1774         if (rc) {
1775                 fprintf(stderr, "Set flags 0x%x failed: %s\n",
1776                         lsa->lsa_comp_flags, strerror(errno));
1777                 return rc;
1778         }
1779
1780         if (lsa->lsa_pool_name != NULL) {
1781                 rc = llapi_layout_pool_name_set(layout, lsa->lsa_pool_name);
1782                 if (rc) {
1783                         fprintf(stderr, "Set pool name: %s failed. %s\n",
1784                                 lsa->lsa_pool_name, strerror(errno));
1785                         return rc;
1786                 }
1787         } else {
1788                 rc = llapi_layout_pool_name_set(layout, "");
1789                 if (rc) {
1790                         fprintf(stderr, "Clear pool name failed: %s\n",
1791                                 strerror(errno));
1792                         return rc;
1793                 }
1794         }
1795
1796         if (lsa->lsa_nr_tgts > 0) {
1797                 if (lsa->lsa_stripe_count > 0 &&
1798                     lsa->lsa_stripe_count != LLAPI_LAYOUT_DEFAULT &&
1799                     lsa->lsa_stripe_count != LLAPI_LAYOUT_WIDE &&
1800                     lsa->lsa_nr_tgts != lsa->lsa_stripe_count) {
1801                         fprintf(stderr, "stripe_count(%lld) != nr_osts(%d)\n",
1802                                 lsa->lsa_stripe_count, lsa->lsa_nr_tgts);
1803                         return -EINVAL;
1804                 }
1805                 for (i = 0; i < lsa->lsa_nr_tgts; i++) {
1806                         rc = llapi_layout_ost_index_set(layout, i,
1807                                                         lsa->lsa_tgts[i]);
1808                         if (rc)
1809                                 break;
1810                 }
1811         } else if (lsa->lsa_stripe_off != LLAPI_LAYOUT_DEFAULT) {
1812                 rc = llapi_layout_ost_index_set(layout, 0, lsa->lsa_stripe_off);
1813         }
1814         if (rc) {
1815                 fprintf(stderr, "Set ost index %d failed. %s\n",
1816                         i, strerror(errno));
1817                 return rc;
1818         }
1819
1820         return 0;
1821 }
1822
1823 /* In 'lfs setstripe --component-add' mode, we need to fetch the extent
1824  * end of the last component in the existing file, and adjust the
1825  * first extent start of the components to be added accordingly. */
1826 static int adjust_first_extent(char *fname, struct llapi_layout *layout)
1827 {
1828         struct llapi_layout *head;
1829         uint64_t start, end, stripe_size, prev_end = 0;
1830         int rc;
1831
1832         if (layout == NULL) {
1833                 fprintf(stderr,
1834                         "%s setstripe: layout must be specified\n",
1835                         progname);
1836                 return -EINVAL;
1837         }
1838
1839         errno = 0;
1840         head = llapi_layout_get_by_path(fname, 0);
1841         if (head == NULL) {
1842                 fprintf(stderr,
1843                         "%s setstripe: cannot read layout from '%s': %s\n",
1844                         progname, fname, strerror(errno));
1845                 return -EINVAL;
1846         } else if (errno == ENODATA) {
1847                 /* file without LOVEA, this component-add will be turned
1848                  * into a component-create. */
1849                 llapi_layout_free(head);
1850                 return -ENODATA;
1851         } else if (!llapi_layout_is_composite(head)) {
1852                 fprintf(stderr, "%s setstripe: '%s' not a composite file\n",
1853                         progname, fname);
1854                 llapi_layout_free(head);
1855                 return -EINVAL;
1856         }
1857
1858         rc = llapi_layout_comp_extent_get(head, &start, &prev_end);
1859         if (rc) {
1860                 fprintf(stderr, "%s setstripe: cannot get prev extent: %s\n",
1861                         progname, strerror(errno));
1862                 llapi_layout_free(head);
1863                 return rc;
1864         }
1865
1866         llapi_layout_free(head);
1867
1868         /* Make sure we use the first component of the layout to be added. */
1869         rc = llapi_layout_comp_use(layout, LLAPI_LAYOUT_COMP_USE_FIRST);
1870         if (rc < 0) {
1871                 fprintf(stderr,
1872                         "%s setstripe: cannot move component cursor: %s\n",
1873                         progname, strerror(errno));
1874                 return rc;
1875         }
1876
1877         rc = llapi_layout_comp_extent_get(layout, &start, &end);
1878         if (rc) {
1879                 fprintf(stderr, "%s setstripe: cannot get extent: %s\n",
1880                         progname, strerror(errno));
1881                 return rc;
1882         }
1883
1884         if (start > prev_end || end <= prev_end) {
1885                 fprintf(stderr,
1886                         "%s setstripe: first extent [%lu, %lu) not adjacent with extent end %lu\n",
1887                         progname, start, end, prev_end);
1888                 return -EINVAL;
1889         }
1890
1891         rc = llapi_layout_stripe_size_get(layout, &stripe_size);
1892         if (rc) {
1893                 fprintf(stderr, "%s setstripe: cannot get stripe size: %s\n",
1894                         progname, strerror(errno));
1895                 return rc;
1896         }
1897
1898         if (stripe_size != LLAPI_LAYOUT_DEFAULT &&
1899             (prev_end & (stripe_size - 1))) {
1900                 fprintf(stderr,
1901                         "%s setstripe: stripe size %lu not aligned with %lu\n",
1902                         progname, stripe_size, prev_end);
1903                 return -EINVAL;
1904         }
1905
1906         rc = llapi_layout_comp_extent_set(layout, prev_end, end);
1907         if (rc) {
1908                 fprintf(stderr,
1909                         "%s setstripe: cannot set component extent [%lu, %lu): %s\n",
1910                         progname, prev_end, end, strerror(errno));
1911                 return rc;
1912         }
1913
1914         return 0;
1915 }
1916
1917 static inline bool arg_is_eof(char *arg)
1918 {
1919         return !strncmp(arg, "-1", strlen("-1")) ||
1920                !strncmp(arg, "EOF", strlen("EOF")) ||
1921                !strncmp(arg, "eof", strlen("eof"));
1922 }
1923
1924 /**
1925  * lfs_mirror_alloc() - Allocate a mirror argument structure.
1926  *
1927  * Return: Valid mirror_args pointer on success and
1928  *         NULL if memory allocation fails.
1929  */
1930 static struct mirror_args *lfs_mirror_alloc(void)
1931 {
1932         struct mirror_args *mirror = NULL;
1933
1934         while (1) {
1935                 mirror = calloc(1, sizeof(*mirror));
1936                 if (mirror != NULL)
1937                         break;
1938
1939                 sleep(1);
1940         }
1941
1942         return mirror;
1943 }
1944
1945 /**
1946  * lfs_mirror_free() - Free memory allocated for a mirror argument
1947  *                     structure.
1948  * @mirror: Previously allocated mirror argument structure by
1949  *          lfs_mirror_alloc().
1950  *
1951  * Free memory allocated for @mirror.
1952  *
1953  * Return: void.
1954  */
1955 static void lfs_mirror_free(struct mirror_args *mirror)
1956 {
1957         if (mirror->m_layout != NULL)
1958                 llapi_layout_free(mirror->m_layout);
1959         free(mirror);
1960 }
1961
1962 /**
1963  * lfs_mirror_list_free() - Free memory allocated for a mirror list.
1964  * @mirror_list: Previously allocated mirror list.
1965  *
1966  * Free memory allocated for @mirror_list.
1967  *
1968  * Return: void.
1969  */
1970 static void lfs_mirror_list_free(struct mirror_args *mirror_list)
1971 {
1972         struct mirror_args *next_mirror = NULL;
1973
1974         while (mirror_list != NULL) {
1975                 next_mirror = mirror_list->m_next;
1976                 lfs_mirror_free(mirror_list);
1977                 mirror_list = next_mirror;
1978         }
1979 }
1980
1981 enum {
1982         LFS_POOL_OPT = 3,
1983         LFS_COMP_COUNT_OPT,
1984         LFS_COMP_START_OPT,
1985         LFS_COMP_FLAGS_OPT,
1986         LFS_COMP_DEL_OPT,
1987         LFS_COMP_SET_OPT,
1988         LFS_COMP_ADD_OPT,
1989         LFS_COMP_USE_PARENT_OPT,
1990         LFS_COMP_NO_VERIFY_OPT,
1991         LFS_PROJID_OPT,
1992         LFS_MIRROR_FLAGS_OPT,
1993 };
1994
1995 /* functions */
1996 static int lfs_setstripe0(int argc, char **argv, enum setstripe_origin opc)
1997 {
1998         struct lfs_setstripe_args        lsa;
1999         struct llapi_stripe_param       *param = NULL;
2000         struct find_param                migrate_mdt_param = {
2001                 .fp_max_depth = -1,
2002                 .fp_mdt_index = -1,
2003         };
2004         char                            *fname;
2005         int                              result;
2006         int                              result2 = 0;
2007         char                            *end;
2008         int                              c;
2009         int                              delete = 0;
2010         char                            *mdt_idx_arg = NULL;
2011         unsigned long long               size_units = 1;
2012         bool                             migrate_mode = false;
2013         bool                             migration_block = false;
2014         __u64                            migration_flags = 0;
2015         __u32                            osts[LOV_MAX_STRIPE_COUNT] = { 0 };
2016         int                              comp_del = 0, comp_set = 0;
2017         int                              comp_add = 0;
2018         __u32                            comp_id = 0;
2019         struct llapi_layout             *layout = NULL;
2020         struct llapi_layout             **lpp = &layout;
2021         bool                             mirror_mode = false;
2022         bool                             has_m_file = false;
2023         __u32                            mirror_count = 0;
2024         enum mirror_flags                mirror_flags = 0;
2025         struct mirror_args              *mirror_list = NULL;
2026         struct mirror_args              *new_mirror = NULL;
2027         struct mirror_args              *last_mirror = NULL;
2028         char                             cmd[PATH_MAX];
2029
2030         struct option long_opts[] = {
2031                 /* --block is only valid in migrate mode */
2032         { .val = 'b',   .name = "block",        .has_arg = no_argument},
2033         { .val = LFS_COMP_ADD_OPT,
2034                         .name = "comp-add",     .has_arg = no_argument},
2035         { .val = LFS_COMP_ADD_OPT,
2036                         .name = "component-add",
2037                                                 .has_arg = no_argument},
2038         { .val = LFS_COMP_DEL_OPT,
2039                         .name = "comp-del",     .has_arg = no_argument},
2040         { .val = LFS_COMP_DEL_OPT,
2041                         .name = "component-del",
2042                                                 .has_arg = no_argument},
2043         { .val = LFS_COMP_FLAGS_OPT,
2044                         .name = "comp-flags",   .has_arg = required_argument},
2045         { .val = LFS_COMP_FLAGS_OPT,
2046                         .name = "component-flags",
2047                                                 .has_arg = required_argument},
2048         { .val = LFS_COMP_SET_OPT,
2049                         .name = "comp-set",     .has_arg = no_argument},
2050         { .val = LFS_COMP_SET_OPT,
2051                         .name = "component-set",
2052                                                 .has_arg = no_argument},
2053         { .val = LFS_COMP_USE_PARENT_OPT,
2054                         .name = "parent",       .has_arg = no_argument},
2055         { .val = LFS_COMP_NO_VERIFY_OPT,
2056                         .name = "no-verify",    .has_arg = no_argument},
2057         { .val = LFS_MIRROR_FLAGS_OPT,
2058                         .name = "flags",        .has_arg = required_argument},
2059         { .val = 'c',   .name = "stripe-count", .has_arg = required_argument},
2060         { .val = 'c',   .name = "stripe_count", .has_arg = required_argument},
2061         { .val = 'd',   .name = "delete",       .has_arg = no_argument},
2062         { .val = 'E',   .name = "comp-end",     .has_arg = required_argument},
2063         { .val = 'E',   .name = "component-end",
2064                                                 .has_arg = required_argument},
2065         { .val = 'f',   .name = "file",         .has_arg = required_argument },
2066         /* dirstripe {"mdt-hash",     required_argument, 0, 'H'}, */
2067         { .val = 'i',   .name = "stripe-index", .has_arg = required_argument},
2068         { .val = 'i',   .name = "stripe_index", .has_arg = required_argument},
2069         { .val = 'I',   .name = "comp-id",      .has_arg = required_argument},
2070         { .val = 'I',   .name = "component-id", .has_arg = required_argument},
2071         { .val = 'L',   .name = "layout",       .has_arg = required_argument },
2072         { .val = 'm',   .name = "mdt",          .has_arg = required_argument},
2073         { .val = 'm',   .name = "mdt-index",    .has_arg = required_argument},
2074         { .val = 'm',   .name = "mdt_index",    .has_arg = required_argument},
2075         { .val = 'N',   .name = "mirror-count", .has_arg = optional_argument},
2076         /* --non-block is only valid in migrate mode */
2077         { .val = 'n',   .name = "non-block",    .has_arg = no_argument},
2078         { .val = 'o',   .name = "ost",          .has_arg = required_argument},
2079 #if LUSTRE_VERSION_CODE < OBD_OCD_VERSION(3, 0, 53, 0)
2080         { .val = 'o',   .name = "ost-list",     .has_arg = required_argument },
2081         { .val = 'o',   .name = "ost_list",     .has_arg = required_argument },
2082 #endif
2083         { .val = 'p',   .name = "pool",         .has_arg = required_argument },
2084         { .val = 'S',   .name = "stripe-size",  .has_arg = required_argument },
2085         { .val = 'S',   .name = "stripe_size",  .has_arg = required_argument },
2086         /* dirstripe {"mdt-count",    required_argument, 0, 'T'}, */
2087         /* --verbose is only valid in migrate mode */
2088         { .val = 'v',   .name = "verbose",      .has_arg = no_argument },
2089         { .name = NULL } };
2090
2091         setstripe_args_init(&lsa);
2092
2093         migrate_mode = (opc == SO_MIGRATE);
2094         mirror_mode = (opc == SO_MIRROR_CREATE || opc == SO_MIRROR_EXTEND);
2095
2096         snprintf(cmd, sizeof(cmd), "%s %s", progname, argv[0]);
2097         progname = cmd;
2098         while ((c = getopt_long(argc, argv, "bc:dE:f:i:I:m:N::no:p:L:s:S:v",
2099                                 long_opts, NULL)) >= 0) {
2100                 switch (c) {
2101                 case 0:
2102                         /* Long options. */
2103                         break;
2104                 case LFS_COMP_ADD_OPT:
2105                         comp_add = 1;
2106                         break;
2107                 case LFS_COMP_DEL_OPT:
2108                         comp_del = 1;
2109                         break;
2110                 case LFS_COMP_FLAGS_OPT:
2111                         result = comp_str2flags(optarg, &lsa.lsa_comp_flags,
2112                                                 &lsa.lsa_comp_neg_flags);
2113                         if (result != 0)
2114                                 goto usage_error;
2115                         if (mirror_mode && lsa.lsa_comp_neg_flags) {
2116                                 fprintf(stderr, "%s: inverted flags are not supported\n",
2117                                         progname);
2118                                 goto usage_error;
2119                         }
2120                         if (lsa.lsa_comp_neg_flags & LCME_FL_STALE) {
2121                                 fprintf(stderr,
2122                                         "%s: cannot clear 'stale' flags from component. Please use lfs-mirror-resync(1) instead\n",
2123                                         progname);
2124                                 result = -EINVAL;
2125                                 goto error;
2126                         }
2127
2128                         break;
2129                 case LFS_COMP_SET_OPT:
2130                         comp_set = 1;
2131                         break;
2132                 case LFS_COMP_USE_PARENT_OPT:
2133                         if (!mirror_mode) {
2134                                 fprintf(stderr, "error: %s: --parent must be "
2135                                         "specified with --mirror-count|-N "
2136                                         "option\n", progname);
2137                                 goto usage_error;
2138                         }
2139                         setstripe_args_init(&lsa);
2140                         break;
2141                 case LFS_COMP_NO_VERIFY_OPT:
2142                         mirror_flags |= NO_VERIFY;
2143                         break;
2144                 case LFS_MIRROR_FLAGS_OPT: {
2145                         __u32 flags;
2146
2147                         if (!mirror_mode || !last_mirror) {
2148                                 fprintf(stderr, "error: %s: --flags must be specified with --mirror-count|-N option\n",
2149                                         progname);
2150                                 goto usage_error;
2151                         }
2152
2153                         result = comp_str2flags(optarg, &last_mirror->m_flags,
2154                                                 &flags);
2155                         if (result != 0)
2156                                 goto usage_error;
2157
2158                         if (flags) {
2159                                 fprintf(stderr, "%s: inverted flags are not supported\n",
2160                                         progname);
2161                                 result = -EINVAL;
2162                                 goto usage_error;
2163                         }
2164                         if (last_mirror->m_flags & ~LCME_USER_FLAGS) {
2165                                 fprintf(stderr,
2166                                         "%s: unsupported mirror flags: %s\n",
2167                                         progname, optarg);
2168                                 result = -EINVAL;
2169                                 goto error;
2170                         }
2171                         break;
2172                 }
2173                 case 'b':
2174                         if (!migrate_mode) {
2175                                 fprintf(stderr,
2176                                         "%s %s: -b|--block valid only for migrate command\n",
2177                                         progname, argv[0]);
2178                                 goto usage_error;
2179                         }
2180                         migration_block = true;
2181                         break;
2182                 case 'c':
2183                         lsa.lsa_stripe_count = strtoul(optarg, &end, 0);
2184                         if (*end != '\0') {
2185                                 fprintf(stderr,
2186                                         "%s %s: invalid stripe count '%s'\n",
2187                                         progname, argv[0], optarg);
2188                                 goto usage_error;
2189                         }
2190
2191                         if (lsa.lsa_stripe_count == -1)
2192                                 lsa.lsa_stripe_count = LLAPI_LAYOUT_WIDE;
2193                         break;
2194                 case 'd':
2195                         /* delete the default striping pattern */
2196                         delete = 1;
2197                         break;
2198                 case 'E':
2199                         if (lsa.lsa_comp_end != 0) {
2200                                 result = comp_args_to_layout(lpp, &lsa);
2201                                 if (result) {
2202                                         fprintf(stderr,
2203                                                 "%s %s: invalid layout\n",
2204                                                 progname, argv[0]);
2205                                         goto usage_error;
2206                                 }
2207
2208                                 setstripe_args_init_inherit(&lsa);
2209                         }
2210
2211                         if (arg_is_eof(optarg)) {
2212                                 lsa.lsa_comp_end = LUSTRE_EOF;
2213                         } else {
2214                                 result = llapi_parse_size(optarg,
2215                                                         &lsa.lsa_comp_end,
2216                                                         &size_units, 0);
2217                                 if (result) {
2218                                         fprintf(stderr,
2219                                                 "%s %s: invalid component end '%s'\n",
2220                                                 progname, argv[0], optarg);
2221                                         goto usage_error;
2222                                 }
2223                         }
2224                         break;
2225                 case 'i':
2226                         lsa.lsa_stripe_off = strtol(optarg, &end, 0);
2227                         if (*end != '\0') {
2228                                 fprintf(stderr,
2229                                         "%s %s: invalid stripe offset '%s'\n",
2230                                         progname, argv[0], optarg);
2231                                 goto usage_error;
2232                         }
2233                         if (lsa.lsa_stripe_off == -1)
2234                                 lsa.lsa_stripe_off = LLAPI_LAYOUT_DEFAULT;
2235                         break;
2236                 case 'I':
2237                         comp_id = strtoul(optarg, &end, 0);
2238                         if (*end != '\0' || comp_id == 0 ||
2239                             comp_id > LCME_ID_MAX) {
2240                                 fprintf(stderr,
2241                                         "%s %s: invalid component ID '%s'\n",
2242                                         progname, argv[0], optarg);
2243                                 goto usage_error;
2244                         }
2245                         break;
2246                 case 'f':
2247                         if (opc != SO_MIRROR_EXTEND) {
2248                                 fprintf(stderr,
2249                                         "error: %s: invalid option: %s\n",
2250                                         progname, argv[optopt + 1]);
2251                                 goto usage_error;
2252                         }
2253                         if (last_mirror == NULL) {
2254                                 fprintf(stderr, "error: %s: '-N' must exist "
2255                                         "in front of '%s'\n",
2256                                         progname, argv[optopt + 1]);
2257                                 goto usage_error;
2258                         }
2259
2260                         last_mirror->m_file = optarg;
2261                         last_mirror->m_count = 1;
2262                         has_m_file = true;
2263                         break;
2264                 case 'L':
2265                         if (strcmp(argv[optind - 1], "mdt") == 0) {
2266                                 /* Can be only the first component */
2267                                 if (layout != NULL) {
2268                                         result = -EINVAL;
2269                                         fprintf(stderr, "error: 'mdt' layout "
2270                                                 "can be only the first one\n");
2271                                         goto error;
2272                                 }
2273                                 if (lsa.lsa_comp_end > (1ULL << 30)) { /* 1Gb */
2274                                         result = -EFBIG;
2275                                         fprintf(stderr, "error: 'mdt' layout "
2276                                                 "size is too big\n");
2277                                         goto error;
2278                                 }
2279                                 lsa.lsa_pattern = LLAPI_LAYOUT_MDT;
2280                         } else if (strcmp(argv[optind - 1], "raid0") != 0) {
2281                                 result = -EINVAL;
2282                                 fprintf(stderr, "error: layout '%s' is "
2283                                         "unknown, supported layouts are: "
2284                                         "'mdt', 'raid0'\n", argv[optind]);
2285                                 goto error;
2286                         }
2287                         break;
2288                 case 'm':
2289                         if (!migrate_mode) {
2290                                 fprintf(stderr,
2291                                         "%s %s: -m|--mdt-index valid only for migrate command\n",
2292                                         progname, argv[0]);
2293                                 goto usage_error;
2294                         }
2295                         mdt_idx_arg = optarg;
2296                         break;
2297                 case 'n':
2298                         if (!migrate_mode) {
2299                                 fprintf(stderr,
2300                                         "%s %s: -n|--non-block valid only for migrate command\n",
2301                                         progname, argv[0]);
2302                                 goto usage_error;
2303                         }
2304                         migration_flags |= MIGRATION_NONBLOCK;
2305                         break;
2306                 case 'N':
2307                         if (opc == SO_SETSTRIPE) {
2308                                 opc = SO_MIRROR_CREATE;
2309                                 mirror_mode = true;
2310                         }
2311                         mirror_count = 1;
2312                         if (optarg != NULL) {
2313                                 mirror_count = strtoul(optarg, &end, 0);
2314                                 if (*end != '\0' || mirror_count == 0) {
2315                                         fprintf(stderr,
2316                                                 "error: %s: bad mirror count: %s\n",
2317                                                 progname, optarg);
2318                                         result = -EINVAL;
2319                                         goto error;
2320                                 }
2321                         }
2322
2323                         new_mirror = lfs_mirror_alloc();
2324                         new_mirror->m_count = mirror_count;
2325
2326                         if (mirror_list == NULL)
2327                                 mirror_list = new_mirror;
2328
2329                         if (last_mirror != NULL) {
2330                                 /* wrap up last mirror */
2331                                 if (lsa.lsa_comp_end == 0)
2332                                         lsa.lsa_comp_end = LUSTRE_EOF;
2333
2334                                 result = comp_args_to_layout(lpp, &lsa);
2335                                 if (result) {
2336                                         lfs_mirror_free(new_mirror);
2337                                         goto error;
2338                                 }
2339
2340                                 setstripe_args_init_inherit(&lsa);
2341
2342                                 last_mirror->m_next = new_mirror;
2343                         }
2344
2345                         last_mirror = new_mirror;
2346                         lpp = &last_mirror->m_layout;
2347                         break;
2348                 case 'o':
2349                         lsa.lsa_nr_tgts = parse_targets(osts,
2350                                                 sizeof(osts) / sizeof(__u32),
2351                                                 lsa.lsa_nr_tgts, optarg);
2352                         if (lsa.lsa_nr_tgts < 0) {
2353                                 fprintf(stderr,
2354                                         "%s %s: invalid OST target(s) '%s'\n",
2355                                         progname, argv[0], optarg);
2356                                 goto usage_error;
2357                         }
2358
2359                         lsa.lsa_tgts = osts;
2360                         if (lsa.lsa_stripe_off == LLAPI_LAYOUT_DEFAULT)
2361                                 lsa.lsa_stripe_off = osts[0];
2362                         break;
2363                 case 'p':
2364                         if (optarg == NULL)
2365                                 goto usage_error;
2366                         lsa.lsa_pool_name = optarg;
2367                         break;
2368                 case 'S':
2369                         result = llapi_parse_size(optarg, &lsa.lsa_stripe_size,
2370                                                   &size_units, 0);
2371                         if (result) {
2372                                 fprintf(stderr,
2373                                         "%s %s: invalid stripe size '%s'\n",
2374                                         progname, argv[0], optarg);
2375                                 goto usage_error;
2376                         }
2377                         break;
2378                 case 'v':
2379                         if (!migrate_mode) {
2380                                 fprintf(stderr,
2381                                         "%s %s: -v|--verbose valid only for migrate command\n",
2382                                         progname, argv[0]);
2383                                 goto usage_error;
2384                         }
2385                         migrate_mdt_param.fp_verbose = VERBOSE_DETAIL;
2386                         break;
2387                 default:
2388                         fprintf(stderr, "%s %s: unrecognized option '%s'\n",
2389                                 progname, argv[0], argv[optind - 1]);
2390                         goto usage_error;
2391                 }
2392         }
2393
2394         fname = argv[optind];
2395
2396         if (optind == argc) {
2397                 fprintf(stderr, "%s %s: FILE must be specified\n",
2398                         progname, argv[0]);
2399                 goto usage_error;
2400         }
2401
2402         if (mirror_mode && mirror_count == 0) {
2403                 fprintf(stderr,
2404                         "error: %s: --mirror-count|-N option is required\n",
2405                         progname);
2406                 result = -EINVAL;
2407                 goto error;
2408         }
2409
2410         if (mirror_mode) {
2411                 if (lsa.lsa_comp_end == 0)
2412                         lsa.lsa_comp_end = LUSTRE_EOF;
2413         }
2414
2415         if (lsa.lsa_comp_end != 0) {
2416                 result = comp_args_to_layout(lpp, &lsa);
2417                 if (result)
2418                         goto error;
2419         }
2420
2421         if (mirror_flags & NO_VERIFY) {
2422                 if (opc != SO_MIRROR_EXTEND) {
2423                         fprintf(stderr,
2424                                 "error: %s: --no-verify is valid only for lfs mirror extend command\n",
2425                                 progname);
2426                         result = -EINVAL;
2427                         goto error;
2428                 } else if (!has_m_file) {
2429                         fprintf(stderr,
2430                                 "error: %s: --no-verify must be specified with -f <victim_file> option\n",
2431                                 progname);
2432                         result = -EINVAL;
2433                         goto error;
2434                 }
2435         }
2436
2437         /* Only LCME_FL_INIT flags is used in PFL, and it shouldn't be
2438          * altered by user space tool, so we don't need to support the
2439          * --component-set for this moment. */
2440         if (comp_set && !comp_id) {
2441                 fprintf(stderr, "%s %s: --component-set doesn't have component-id set\n",
2442                         progname, argv[0]);
2443                 goto usage_error;
2444         }
2445
2446         if ((delete + comp_set + comp_del + comp_add) > 1) {
2447                 fprintf(stderr,
2448                         "%s %s: options --component-set, --component-del, --component-add and -d are mutually exclusive\n",
2449                         progname, argv[0]);
2450                 goto usage_error;
2451         }
2452
2453         if (delete && (setstripe_args_specified(&lsa) || comp_id != 0 ||
2454                        lsa.lsa_comp_flags != 0 || layout != NULL)) {
2455                 fprintf(stderr,
2456                         "%s %s: option -d is mutually exclusive with -s, -c, -o, -p, -I, -F and -E options\n",
2457                         progname, argv[0]);
2458                 goto usage_error;
2459         }
2460
2461         if ((comp_set || comp_del) &&
2462             (setstripe_args_specified(&lsa) || layout != NULL)) {
2463                 fprintf(stderr,
2464                         "%s %s: options --component-del and --component-set are mutually exclusive when used with -c, -E, -o, -p, or -s\n",
2465                         progname, argv[0]);
2466                 goto usage_error;
2467         }
2468
2469         if (comp_del && comp_id != 0 && lsa.lsa_comp_flags != 0) {
2470                 fprintf(stderr,
2471                         "%s %s: options -I and -F are mutually exclusive when used with --component-del\n",
2472                         progname, argv[0]);
2473                 goto usage_error;
2474         }
2475
2476         if (comp_add || comp_del) {
2477                 struct stat st;
2478
2479                 result = lstat(fname, &st);
2480                 if (result == 0 && S_ISDIR(st.st_mode)) {
2481                         fprintf(stderr,
2482                                 "%s setstripe: cannot use --component-add or --component-del for directory\n",
2483                                 progname);
2484                         goto usage_error;
2485                 }
2486
2487                 if (mirror_mode) {
2488                         fprintf(stderr, "error: %s: can't use --component-add "
2489                                 "or --component-del for mirror operation\n",
2490                                 progname);
2491                         goto usage_error;
2492                 }
2493         }
2494
2495         if (comp_add) {
2496                 if (layout == NULL) {
2497                         fprintf(stderr,
2498                                 "%s %s: option -E must be specified with --component-add\n",
2499                                 progname, argv[0]);
2500                         goto usage_error;
2501                 }
2502
2503                 result = adjust_first_extent(fname, layout);
2504                 if (result == -ENODATA)
2505                         comp_add = 0;
2506                 else if (result != 0)
2507                         goto error;
2508         }
2509
2510         if (mdt_idx_arg != NULL && optind > 3) {
2511                 fprintf(stderr,
2512                         "%s %s: option -m cannot be used with other options\n",
2513                         progname, argv[0]);
2514                 goto usage_error;
2515         }
2516
2517         if ((migration_flags & MIGRATION_NONBLOCK) && migration_block) {
2518                 fprintf(stderr,
2519                         "%s %s: options --non-block and --block are mutually exclusive\n",
2520                         progname, argv[0]);
2521                 goto usage_error;
2522         }
2523
2524         if (!comp_del && !comp_set && comp_id != 0) {
2525                 fprintf(stderr,
2526                         "%s %s: option -I can only be used with --component-del\n",
2527                         progname, argv[0]);
2528                 goto usage_error;
2529         }
2530
2531         if (mdt_idx_arg != NULL) {
2532                 /* initialize migrate mdt parameters */
2533                 migrate_mdt_param.fp_mdt_index = strtoul(mdt_idx_arg, &end, 0);
2534                 if (*end != '\0') {
2535                         fprintf(stderr, "%s %s: invalid MDT index '%s'\n",
2536                                 progname, argv[0], mdt_idx_arg);
2537                         goto usage_error;
2538                 }
2539                 migrate_mdt_param.fp_migrate = 1;
2540         } else if (layout == NULL) {
2541                 /* initialize stripe parameters */
2542                 param = calloc(1, offsetof(typeof(*param),
2543                                lsp_osts[lsa.lsa_nr_tgts]));
2544                 if (param == NULL) {
2545                         fprintf(stderr,
2546                                 "%s %s: cannot allocate memory for parameters: %s\n",
2547                                 progname, argv[0], strerror(ENOMEM));
2548                         result = -ENOMEM;
2549                         goto error;
2550                 }
2551
2552                 if (lsa.lsa_stripe_size != LLAPI_LAYOUT_DEFAULT)
2553                         param->lsp_stripe_size = lsa.lsa_stripe_size;
2554                 if (lsa.lsa_stripe_count != LLAPI_LAYOUT_DEFAULT) {
2555                         if (lsa.lsa_stripe_count == LLAPI_LAYOUT_WIDE)
2556                                 param->lsp_stripe_count = -1;
2557                         else
2558                                 param->lsp_stripe_count = lsa.lsa_stripe_count;
2559                 }
2560                 if (lsa.lsa_stripe_off == LLAPI_LAYOUT_DEFAULT)
2561                         param->lsp_stripe_offset = -1;
2562                 else
2563                         param->lsp_stripe_offset = lsa.lsa_stripe_off;
2564                 param->lsp_pool = lsa.lsa_pool_name;
2565                 param->lsp_is_specific = false;
2566                 if (lsa.lsa_nr_tgts > 0) {
2567                         if (lsa.lsa_stripe_count > 0 &&
2568                             lsa.lsa_stripe_count != LLAPI_LAYOUT_DEFAULT &&
2569                             lsa.lsa_stripe_count != LLAPI_LAYOUT_WIDE &&
2570                             lsa.lsa_nr_tgts != lsa.lsa_stripe_count) {
2571                                 fprintf(stderr, "error: %s: stripe count %lld "
2572                                         "doesn't match the number of OSTs: %d\n"
2573                                         , argv[0], lsa.lsa_stripe_count,
2574                                         lsa.lsa_nr_tgts);
2575                                 free(param);
2576                                 goto usage_error;
2577                         }
2578
2579                         param->lsp_is_specific = true;
2580                         param->lsp_stripe_count = lsa.lsa_nr_tgts;
2581                         memcpy(param->lsp_osts, osts,
2582                                sizeof(*osts) * lsa.lsa_nr_tgts);
2583                 }
2584         }
2585
2586         for (fname = argv[optind]; fname != NULL; fname = argv[++optind]) {
2587                 if (mdt_idx_arg != NULL) {
2588                         result = llapi_migrate_mdt(fname, &migrate_mdt_param);
2589                 } else if (migrate_mode) {
2590                         result = lfs_migrate(fname, migration_flags, param,
2591                                              layout);
2592                 } else if (comp_set != 0) {
2593                         result = lfs_component_set(fname, comp_id,
2594                                                    lsa.lsa_comp_flags,
2595                                                    lsa.lsa_comp_neg_flags);
2596                 } else if (comp_del != 0) {
2597                         result = lfs_component_del(fname, comp_id,
2598                                                    lsa.lsa_comp_flags,
2599                                                    lsa.lsa_comp_neg_flags);
2600                 } else if (comp_add != 0) {
2601                         result = lfs_component_add(fname, layout);
2602                 } else if (opc == SO_MIRROR_CREATE) {
2603                         result = mirror_create(fname, mirror_list);
2604                 } else if (opc == SO_MIRROR_EXTEND) {
2605                         result = mirror_extend(fname, mirror_list,
2606                                                mirror_flags);
2607                 } else if (layout != NULL) {
2608                         result = lfs_component_create(fname, O_CREAT | O_WRONLY,
2609                                                       0644, layout);
2610                         if (result >= 0) {
2611                                 close(result);
2612                                 result = 0;
2613                         }
2614                 } else {
2615                         result = llapi_file_open_param(fname,
2616                                                        O_CREAT | O_WRONLY,
2617                                                        0644, param);
2618                         if (result >= 0) {
2619                                 close(result);
2620                                 result = 0;
2621                         }
2622                 }
2623                 if (result) {
2624                         /* Save the first error encountered. */
2625                         if (result2 == 0)
2626                                 result2 = result;
2627                         continue;
2628                 }
2629         }
2630
2631         free(param);
2632         llapi_layout_free(layout);
2633         lfs_mirror_list_free(mirror_list);
2634         return result2;
2635 usage_error:
2636         result = CMD_HELP;
2637 error:
2638         llapi_layout_free(layout);
2639         lfs_mirror_list_free(mirror_list);
2640         return result;
2641 }
2642
2643 static int lfs_poollist(int argc, char **argv)
2644 {
2645         if (argc != 2)
2646                 return CMD_HELP;
2647
2648         return llapi_poollist(argv[1]);
2649 }
2650
2651 static int set_time(time_t *time, time_t *set, char *str)
2652 {
2653         time_t t;
2654         int res = 0;
2655
2656         if (str[0] == '+')
2657                 res = 1;
2658         else if (str[0] == '-')
2659                 res = -1;
2660
2661         if (res)
2662                 str++;
2663
2664         t = strtol(str, NULL, 0);
2665         if (*time < t * 24 * 60 * 60) {
2666                 if (res)
2667                         str--;
2668                 fprintf(stderr, "Wrong time '%s' is specified.\n", str);
2669                 return INT_MAX;
2670         }
2671
2672         *set = *time - t * 24 * 60 * 60;
2673         return res;
2674 }
2675 static int name2uid(unsigned int *id, const char *name)
2676 {
2677         struct passwd *passwd;
2678
2679         passwd = getpwnam(name);
2680         if (passwd == NULL)
2681                 return -ENOENT;
2682         *id = passwd->pw_uid;
2683
2684         return 0;
2685 }
2686
2687 static int name2gid(unsigned int *id, const char *name)
2688 {
2689         struct group *group;
2690
2691         group = getgrnam(name);
2692         if (group == NULL)
2693                 return -ENOENT;
2694         *id = group->gr_gid;
2695
2696         return 0;
2697 }
2698
2699 static inline int name2projid(unsigned int *id, const char *name)
2700 {
2701         return -ENOTSUP;
2702 }
2703
2704 static int uid2name(char **name, unsigned int id)
2705 {
2706         struct passwd *passwd;
2707
2708         passwd = getpwuid(id);
2709         if (passwd == NULL)
2710                 return -ENOENT;
2711         *name = passwd->pw_name;
2712
2713         return 0;
2714 }
2715
2716 static inline int gid2name(char **name, unsigned int id)
2717 {
2718         struct group *group;
2719
2720         group = getgrgid(id);
2721         if (group == NULL)
2722                 return -ENOENT;
2723         *name = group->gr_name;
2724
2725         return 0;
2726 }
2727
2728 static int name2layout(__u32 *layout, char *name)
2729 {
2730         char *ptr, *layout_name;
2731
2732         *layout = 0;
2733         for (ptr = name; ; ptr = NULL) {
2734                 layout_name = strtok(ptr, ",");
2735                 if (layout_name == NULL)
2736                         break;
2737                 if (strcmp(layout_name, "released") == 0)
2738                         *layout |= LOV_PATTERN_F_RELEASED;
2739                 else if (strcmp(layout_name, "raid0") == 0)
2740                         *layout |= LOV_PATTERN_RAID0;
2741                 else if (strcmp(layout_name, "mdt") == 0)
2742                         *layout |= LOV_PATTERN_MDT;
2743                 else
2744                         return -1;
2745         }
2746         return 0;
2747 }
2748
2749 static int lfs_find(int argc, char **argv)
2750 {
2751         int c, rc;
2752         int ret = 0;
2753         time_t t;
2754         struct find_param param = {
2755                 .fp_max_depth = -1,
2756                 .fp_quiet = 1,
2757         };
2758         struct option long_opts[] = {
2759         { .val = 'A',   .name = "atime",        .has_arg = required_argument },
2760         { .val = LFS_COMP_COUNT_OPT,
2761                         .name = "comp-count",   .has_arg = required_argument },
2762         { .val = LFS_COMP_COUNT_OPT,
2763                         .name = "component-count",
2764                                                 .has_arg = required_argument },
2765         { .val = LFS_COMP_FLAGS_OPT,
2766                         .name = "comp-flags",   .has_arg = required_argument },
2767         { .val = LFS_COMP_FLAGS_OPT,
2768                         .name = "component-flags",
2769                                                 .has_arg = required_argument },
2770         { .val = LFS_COMP_START_OPT,
2771                         .name = "comp-start",   .has_arg = required_argument },
2772         { .val = LFS_COMP_START_OPT,
2773                         .name = "component-start",
2774                                                 .has_arg = required_argument },
2775         { .val = 'c',   .name = "stripe-count", .has_arg = required_argument },
2776         { .val = 'c',   .name = "stripe_count", .has_arg = required_argument },
2777         { .val = 'C',   .name = "ctime",        .has_arg = required_argument },
2778         { .val = 'D',   .name = "maxdepth",     .has_arg = required_argument },
2779         { .val = 'E',   .name = "comp-end",     .has_arg = required_argument },
2780         { .val = 'E',   .name = "component-end",
2781                                                 .has_arg = required_argument },
2782         { .val = 'g',   .name = "gid",          .has_arg = required_argument },
2783         { .val = 'G',   .name = "group",        .has_arg = required_argument },
2784         { .val = 'H',   .name = "mdt-hash",     .has_arg = required_argument },
2785         { .val = 'i',   .name = "stripe-index", .has_arg = required_argument },
2786         { .val = 'i',   .name = "stripe_index", .has_arg = required_argument },
2787         /*{"component-id", required_argument, 0, 'I'},*/
2788         { .val = 'L',   .name = "layout",       .has_arg = required_argument },
2789         { .val = 'm',   .name = "mdt",          .has_arg = required_argument },
2790         { .val = 'm',   .name = "mdt-index",    .has_arg = required_argument },
2791         { .val = 'm',   .name = "mdt_index",    .has_arg = required_argument },
2792         { .val = 'M',   .name = "mtime",        .has_arg = required_argument },
2793         { .val = 'n',   .name = "name",         .has_arg = required_argument },
2794      /* reserve {"or",           no_argument,     , 0, 'o'}, to match find(1) */
2795         { .val = 'O',   .name = "obd",          .has_arg = required_argument },
2796         { .val = 'O',   .name = "ost",          .has_arg = required_argument },
2797         /* no short option for pool, p/P already used */
2798         { .val = LFS_POOL_OPT,
2799                         .name = "pool",         .has_arg = required_argument },
2800         { .val = 'p',   .name = "print0",       .has_arg = no_argument },
2801         { .val = 'P',   .name = "print",        .has_arg = no_argument },
2802         { .val = LFS_PROJID_OPT,
2803                         .name = "projid",       .has_arg = required_argument },
2804         { .val = 's',   .name = "size",         .has_arg = required_argument },
2805         { .val = 'S',   .name = "stripe-size",  .has_arg = required_argument },
2806         { .val = 'S',   .name = "stripe_size",  .has_arg = required_argument },
2807         { .val = 't',   .name = "type",         .has_arg = required_argument },
2808         { .val = 'T',   .name = "mdt-count",    .has_arg = required_argument },
2809         { .val = 'u',   .name = "uid",          .has_arg = required_argument },
2810         { .val = 'U',   .name = "user",         .has_arg = required_argument },
2811         { .name = NULL } };
2812         int pathstart = -1;
2813         int pathend = -1;
2814         int neg_opt = 0;
2815         time_t *xtime;
2816         int *xsign;
2817         int isoption;
2818         char *endptr;
2819
2820         time(&t);
2821
2822         /* when getopt_long_only() hits '!' it returns 1, puts "!" in optarg */
2823         while ((c = getopt_long_only(argc, argv,
2824                         "-A:c:C:D:E:g:G:H:i:L:m:M:n:O:Ppqrs:S:t:T:u:U:v",
2825                         long_opts, NULL)) >= 0) {
2826                 xtime = NULL;
2827                 xsign = NULL;
2828                 if (neg_opt)
2829                         --neg_opt;
2830                 /* '!' is part of option */
2831                 /* when getopt_long_only() finds a string which is not
2832                  * an option nor a known option argument it returns 1
2833                  * in that case if we already have found pathstart and pathend
2834                  * (i.e. we have the list of pathnames),
2835                  * the only supported value is "!"
2836                  */
2837                 isoption = (c != 1) || (strcmp(optarg, "!") == 0);
2838                 if (!isoption && pathend != -1) {
2839                         fprintf(stderr, "err: %s: filename|dirname must either "
2840                                         "precede options or follow options\n",
2841                                         argv[0]);
2842                         ret = CMD_HELP;
2843                         goto err;
2844                 }
2845                 if (!isoption && pathstart == -1)
2846                         pathstart = optind - 1;
2847                 if (isoption && pathstart != -1 && pathend == -1)
2848                         pathend = optind - 2;
2849                 switch (c) {
2850                 case 0:
2851                         /* Long options. */
2852                         break;
2853                 case 1:
2854                         /* unknown; opt is "!" or path component,
2855                          * checking done above.
2856                          */
2857                         if (strcmp(optarg, "!") == 0)
2858                                 neg_opt = 2;
2859                         break;
2860                 case 'A':
2861                         xtime = &param.fp_atime;
2862                         xsign = &param.fp_asign;
2863                         param.fp_exclude_atime = !!neg_opt;
2864                         /* no break, this falls through to 'C' for ctime */
2865                 case 'C':
2866                         if (c == 'C') {
2867                                 xtime = &param.fp_ctime;
2868                                 xsign = &param.fp_csign;
2869                                 param.fp_exclude_ctime = !!neg_opt;
2870                         }
2871                         /* no break, this falls through to 'M' for mtime */
2872                 case 'M':
2873                         if (c == 'M') {
2874                                 xtime = &param.fp_mtime;
2875                                 xsign = &param.fp_msign;
2876                                 param.fp_exclude_mtime = !!neg_opt;
2877                         }
2878                         rc = set_time(&t, xtime, optarg);
2879                         if (rc == INT_MAX) {
2880                                 ret = -1;
2881                                 goto err;
2882                         }
2883                         if (rc)
2884                                 *xsign = rc;
2885                         break;
2886                 case LFS_COMP_COUNT_OPT:
2887                         if (optarg[0] == '+') {
2888                                 param.fp_comp_count_sign = -1;
2889                                 optarg++;
2890                         } else if (optarg[0] == '-') {
2891                                 param.fp_comp_count_sign =  1;
2892                                 optarg++;
2893                         }
2894
2895                         param.fp_comp_count = strtoul(optarg, &endptr, 0);
2896                         if (*endptr != '\0') {
2897                                 fprintf(stderr, "error: bad component count "
2898                                         "'%s'\n", optarg);
2899                                 goto err;
2900                         }
2901                         param.fp_check_comp_count = 1;
2902                         param.fp_exclude_comp_count = !!neg_opt;
2903                         break;
2904                 case LFS_COMP_FLAGS_OPT:
2905                         rc = comp_str2flags(optarg, &param.fp_comp_flags,
2906                                             &param.fp_comp_neg_flags);
2907                         if (rc) {
2908                                 fprintf(stderr, "error: bad component flags "
2909                                         "'%s'\n", optarg);
2910                                 goto err;
2911                         }
2912                         param.fp_check_comp_flags = 1;
2913                         if (neg_opt) {
2914                                 __u32 flags = param.fp_comp_neg_flags;
2915                                 param.fp_comp_neg_flags = param.fp_comp_flags;
2916                                 param.fp_comp_flags = flags;
2917                         }
2918                         break;
2919                 case LFS_COMP_START_OPT:
2920                         if (optarg[0] == '+') {
2921                                 param.fp_comp_start_sign = -1;
2922                                 optarg++;
2923                         } else if (optarg[0] == '-') {
2924                                 param.fp_comp_start_sign =  1;
2925                                 optarg++;
2926                         }
2927
2928                         rc = llapi_parse_size(optarg, &param.fp_comp_start,
2929                                               &param.fp_comp_start_units, 0);
2930                         if (rc) {
2931                                 fprintf(stderr, "error: bad component start "
2932                                         "'%s'\n", optarg);
2933                                 goto err;
2934                         }
2935                         param.fp_check_comp_start = 1;
2936                         param.fp_exclude_comp_start = !!neg_opt;
2937                         break;
2938                 case 'c':
2939                         if (optarg[0] == '+') {
2940                                 param.fp_stripe_count_sign = -1;
2941                                 optarg++;
2942                         } else if (optarg[0] == '-') {
2943                                 param.fp_stripe_count_sign =  1;
2944                                 optarg++;
2945                         }
2946
2947                         param.fp_stripe_count = strtoul(optarg, &endptr, 0);
2948                         if (*endptr != '\0') {
2949                                 fprintf(stderr,"error: bad stripe_count '%s'\n",
2950                                         optarg);
2951                                 ret = -1;
2952                                 goto err;
2953                         }
2954                         param.fp_check_stripe_count = 1;
2955                         param.fp_exclude_stripe_count = !!neg_opt;
2956                         break;
2957                 case 'D':
2958                         param.fp_max_depth = strtol(optarg, 0, 0);
2959                         break;
2960                 case 'E':
2961                         if (optarg[0] == '+') {
2962                                 param.fp_comp_end_sign = -1;
2963                                 optarg++;
2964                         } else if (optarg[0] == '-') {
2965                                 param.fp_comp_end_sign =  1;
2966                                 optarg++;
2967                         }
2968
2969                         if (arg_is_eof(optarg)) {
2970                                 param.fp_comp_end = LUSTRE_EOF;
2971                                 param.fp_comp_end_units = 1;
2972                                 rc = 0;
2973                         } else {
2974                                 rc = llapi_parse_size(optarg,
2975                                                 &param.fp_comp_end,
2976                                                 &param.fp_comp_end_units, 0);
2977                         }
2978                         if (rc) {
2979                                 fprintf(stderr, "error: bad component end "
2980                                         "'%s'\n", optarg);
2981                                 goto err;
2982                         }
2983                         param.fp_check_comp_end = 1;
2984                         param.fp_exclude_comp_end = !!neg_opt;
2985                         break;
2986                 case 'g':
2987                 case 'G':
2988                         rc = name2gid(&param.fp_gid, optarg);
2989                         if (rc) {
2990                                 param.fp_gid = strtoul(optarg, &endptr, 10);
2991                                 if (*endptr != '\0') {
2992                                         fprintf(stderr, "Group/GID: %s cannot "
2993                                                 "be found.\n", optarg);
2994                                         ret = -1;
2995                                         goto err;
2996                                 }
2997                         }
2998                         param.fp_exclude_gid = !!neg_opt;
2999                         param.fp_check_gid = 1;
3000                         break;
3001                 case 'H':
3002                         param.fp_hash_type = check_hashtype(optarg);
3003                         if (param.fp_hash_type == 0) {
3004                                 fprintf(stderr, "error: bad hash_type '%s'\n",
3005                                         optarg);
3006                                 ret = -1;
3007                                 goto err;
3008                         }
3009                         param.fp_check_hash_type = 1;
3010                         param.fp_exclude_hash_type = !!neg_opt;
3011                         break;
3012                 case 'L':
3013                         ret = name2layout(&param.fp_layout, optarg);
3014                         if (ret)
3015                                 goto err;
3016                         param.fp_exclude_layout = !!neg_opt;
3017                         param.fp_check_layout = 1;
3018                         break;
3019                 case 'u':
3020                 case 'U':
3021                         rc = name2uid(&param.fp_uid, optarg);
3022                         if (rc) {
3023                                 param.fp_uid = strtoul(optarg, &endptr, 10);
3024                                 if (*endptr != '\0') {
3025                                         fprintf(stderr, "User/UID: %s cannot "
3026                                                 "be found.\n", optarg);
3027                                         ret = -1;
3028                                         goto err;
3029                                 }
3030                         }
3031                         param.fp_exclude_uid = !!neg_opt;
3032                         param.fp_check_uid = 1;
3033                         break;
3034                 case LFS_POOL_OPT:
3035                         if (strlen(optarg) > LOV_MAXPOOLNAME) {
3036                                 fprintf(stderr,
3037                                         "Pool name %s is too long"