Whamcloud - gitweb
0acbb596068628c6eedea4699feb8e981fc0cefd
[fs/lustre-release.git] / lustre / utils / mount_utils.h
1 /*
2  * GPL HEADER START
3  *
4  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License version 2 only,
8  * as published by the Free Software Foundation.
9  *
10  * This program is distributed in the hope that it will be useful, 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) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
24  * Use is subject to license terms.
25  *
26  * Copyright (c) 2012, 2017, Intel Corporation.
27  */
28 /*
29  * This file is part of Lustre, http://www.lustre.org/
30  */
31
32 #ifndef _MOUNT_UTILS_H_
33 #define _MOUNT_UTILS_H_
34
35 /* Some of the userland headers for libzfs also require
36  * zfs/spl linux kernel headers, but including these pull
37  * in linux kernel headers which conflicts with the
38  * userland version of libcfs. So the solution is tell the
39  * libzfs user land headrs that the zfs/spl kernel headers
40  * are already included even if this is not the case.
41  */
42 #ifdef HAVE_ZFS_OSD
43 #define _SPL_ZFS_H
44 #define _SPL_SIGNAL_H
45 #endif
46 #include <ctype.h>
47 #include <errno.h>
48 #include <fcntl.h>
49 #include <limits.h>
50 #include <stdbool.h>
51 #include <stdlib.h>
52 #include <string.h>
53 #include <sys/types.h>
54 #include <sys/stat.h>
55
56 #include <libcfs/util/list.h>
57 #include <linux/lustre/lustre_param.h>
58 #ifdef HAVE_SERVER_SUPPORT
59 #include <linux/lustre/lustre_idl.h>
60 #include <linux/lustre/lustre_disk.h>
61 #endif
62
63 extern char *progname;
64 extern int verbose;
65 extern int failover;
66
67 #define vprint(fmt, arg...) if (verbose > 0) printf(fmt, ##arg)
68 #define verrprint(fmt, arg...) if (verbose >= 0) fprintf(stderr, fmt, ##arg)
69
70 /* mo_flags */
71 #define MO_IS_LOOP              0x01
72 #define MO_FORCEFORMAT          0x02
73 #define MO_FAILOVER             0x04
74 #define MO_DRYRUN               0x08
75 #define MO_QUOTA                0x10
76 #define MO_NOHOSTID_CHECK       0x20
77 #define MO_RENAME               0x40
78 #define MO_ERASE_ALL            0x80
79
80 #define MAX_LOOP_DEVICES        16
81 #define INDEX_UNASSIGNED        0xFFFF
82
83 /* Maximum length of on-disk parameters in the form key=<value> */
84 #define PARAM_MAX               4096
85
86 #ifdef HAVE_SERVER_SUPPORT
87 /* used to describe the options to format the lustre disk, not persistent */
88 struct mkfs_opts {
89         struct lustre_disk_data mo_ldd; /* to be written in MOUNT_DATA_FILE */
90         char            mo_device[128];   /* disk device name */
91         char            **mo_pool_vdevs;  /* list of pool vdevs */
92         char            mo_loopdev[128];  /* in case a loop dev is needed */
93         char            mo_mkfsopts[512]; /* options for backing-store mkfs */
94         char            *mo_mountopts;    /* mount options for backing fs */
95         long long       mo_device_kb;     /* in KB */
96         int             mo_blocksize_kb;  /* blocksize in KB */
97         int             mo_stripe_count;
98         int             mo_flags;
99         int             mo_mgs_failnodes;
100         int             mo_inode_size;
101 };
102 #endif
103
104 /* used to describe the options to mount the lustre disk */
105 struct mount_opts {
106 #ifdef HAVE_SERVER_SUPPORT
107         struct lustre_disk_data  mo_ldd;
108 #endif
109         char    *mo_orig_options;
110         char    *mo_usource;            /* user-specified mount device */
111         char    *mo_source;             /* our mount device name */
112         char     mo_target[PATH_MAX];   /* mount directory */
113 #ifdef HAVE_GSS
114         char     mo_skpath[PATH_MAX];   /* shared key file/directory */
115 #endif
116         int      mo_nomtab;
117         int      mo_fake;
118         int      mo_force;
119         int      mo_retry;
120         int      mo_have_mgsnid;
121         int      mo_md_stripe_cache_size;
122         int      mo_nosvc;
123         int      mo_max_sectors_kb;
124 };
125
126 #ifdef HAVE_SERVER_SUPPORT
127 int get_mountdata(char *, struct lustre_disk_data *);
128
129 static inline const char *mt_str(enum ldd_mount_type mt)
130 {
131         static const char * const mount_type_string[] = {
132                 "ext3",
133                 "ldiskfs",
134                 "smfs",
135                 "reiserfs",
136                 "ldiskfs2",
137                 "zfs",
138         };
139         return mount_type_string[mt];
140 }
141
142 static inline const char *mt_type(enum ldd_mount_type mt)
143 {
144         static const char * const mount_type_string[] = {
145                 "osd-ldiskfs",
146                 "osd-ldiskfs",
147                 "osd-smfs",
148                 "osd-reiserfs",
149                 "osd-ldiskfs",
150                 "osd-zfs",
151         };
152         return mount_type_string[mt];
153 }
154 #endif /* HAVE_SERVER_SUPPORT */
155
156 #define MT_STR(data)   mt_str((data)->ldd_mount_type)
157
158 #define IS_MDT(data)   ((data)->ldd_flags & LDD_F_SV_TYPE_MDT)
159 #define IS_OST(data)   ((data)->ldd_flags & LDD_F_SV_TYPE_OST)
160 #define IS_MGS(data)  ((data)->ldd_flags & LDD_F_SV_TYPE_MGS)
161 #define IS_SEPARATED_MGS(data)  ((data)->ldd_flags == LDD_F_SV_TYPE_MGS)
162 #define IS_SERVER(data) ((data)->ldd_flags & (LDD_F_SV_TYPE_MGS | \
163                           LDD_F_SV_TYPE_MDT | LDD_F_SV_TYPE_OST))
164
165
166 /* mkfs/mount helper functions */
167 void fatal(void);
168 int run_command_err(char *cmd, int cmdsz, char *error_msg);
169 int run_command(char *cmd, int cmdsz);
170 int add_param(char *buf, char *key, char *val);
171 int append_param(char *buf, char *key, char *val, char sep);
172 int get_param(char *buf, char *key, char **val);
173 char *strscat(char *dst, char *src, int buflen);
174 char *strscpy(char *dst, char *src, int buflen);
175 int check_mtab_entry(char *spec1, char *spec2, char *mntpt, char *type);
176 int update_mtab_entry(char *spec, char *mtpt, char *type, char *opts,
177                       int flags, int freq, int pass);
178 int update_utab_entry(struct mount_opts *mop);
179 int check_mountfsoptions(char *mountopts, char *wanted_mountopts);
180 void trim_mountfsoptions(char *s);
181 #ifdef HAVE_SERVER_SUPPORT
182 __u64 get_device_size(char* device);
183 int lustre_rename_fsname(struct mkfs_opts *mop, const char *mntpt,
184                          const char *oldname);
185
186 /* loopback helper functions */
187 int file_create(char *path, __u64 size);
188 int loop_format(struct mkfs_opts *mop);
189 int loop_setup(struct mkfs_opts *mop);
190 int loop_cleanup(struct mkfs_opts *mop);
191
192 /* generic target support */
193 int osd_write_ldd(struct mkfs_opts *mop);
194 int osd_read_ldd(char *dev, struct lustre_disk_data *ldd);
195 int osd_erase_ldd(struct mkfs_opts *mop, char *param);
196 void osd_print_ldd_params(struct mkfs_opts *mop);
197 int osd_is_lustre(char *dev, unsigned *mount_type);
198 int osd_make_lustre(struct mkfs_opts *mop);
199 int osd_prepare_lustre(struct mkfs_opts *mop,
200                        char *wanted_mountopts, size_t len);
201 int osd_fix_mountopts(struct mkfs_opts *mop, char *mountopts, size_t len);
202 int osd_tune_lustre(char *dev, struct mount_opts *mop);
203 int osd_label_lustre(struct mount_opts *mop);
204 int osd_rename_fsname(struct mkfs_opts *mop, const char *oldname);
205 int osd_enable_quota(struct mkfs_opts *mop);
206 int osd_init(void);
207 void osd_fini(void);
208
209 struct module_backfs_ops {
210         int     (*init)(void);
211         void    (*fini)(void);
212         int     (*read_ldd)(char *ds,  struct lustre_disk_data *ldd);
213         int     (*write_ldd)(struct mkfs_opts *mop);
214         int     (*erase_ldd)(struct mkfs_opts *mop, char *param);
215         void    (*print_ldd_params)(struct mkfs_opts *mop);
216         int     (*is_lustre)(char *dev, enum ldd_mount_type *mount_type);
217         int     (*make_lustre)(struct mkfs_opts *mop);
218         int     (*prepare_lustre)(struct mkfs_opts *mop,
219                                   char *wanted_mountopts, size_t len);
220         int     (*fix_mountopts)(struct mkfs_opts *mop,
221                                  char *mountopts, size_t len);
222         int     (*tune_lustre)(char *dev, struct mount_opts *mop);
223         int     (*label_lustre)(struct mount_opts *mop);
224         int     (*enable_quota)(struct mkfs_opts *mop);
225         int     (*rename_fsname)(struct mkfs_opts *mop, const char *oldname);
226         void   *dl_handle;
227 };
228
229 extern struct module_backfs_ops zfs_ops;
230 extern struct module_backfs_ops ldiskfs_ops;
231
232 struct module_backfs_ops *load_backfs_module(enum ldd_mount_type mount_type);
233 void unload_backfs_ops(struct module_backfs_ops *ops);
234 #endif
235
236 #ifdef HAVE_OPENSSL_SSK
237 int load_shared_keys(struct mount_opts *mop);
238 #else
239 static inline int load_shared_keys(struct mount_opts *mop)
240 {
241         return EOPNOTSUPP;
242 }
243 #endif
244 #endif