1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Copyright (C) International Business Machines Corp., 2000-2004
9 * note: file system in transition to aggregate/fileset:
11 * file system mount is interpreted as the mount of aggregate,
12 * if not already mounted, and mount of the single/only fileset in
15 * a file system/aggregate is represented by an internal inode
16 * (aka mount inode) initialized with aggregate superblock;
17 * each vfs represents a fileset, and points to its "fileset inode
18 * allocation map inode" (aka fileset inode):
19 * (an aggregate itself is structured recursively as a filset:
20 * an internal vfs is constructed and points to its "fileset inode
21 * allocation map inode" (aka aggregate inode) where each inode
22 * represents a fileset inode) so that inode number is mapped to
23 * on-disk inode in uniform way at both aggregate and fileset level;
25 * each vnode/inode of a fileset is linked to its vfs (to facilitate
26 * per fileset inode operations, e.g., unmount of a fileset, etc.);
27 * each inode points to the mount inode (to facilitate access to
28 * per aggregate information, e.g., block size, etc.) as well as
33 * mntvfs -> fileset ipimap+ -> aggregate ipbmap -> aggregate ipaimap;
34 * fileset vfs -> vp(1) <-> ... <-> vp(n) <->vproot;
38 #include <linux/buffer_head.h>
39 #include <linux/blkdev.h>
40 #include <linux/log2.h>
42 #include "jfs_incore.h"
43 #include "jfs_filsys.h"
44 #include "jfs_superblock.h"
47 #include "jfs_metapage.h"
48 #include "jfs_debug.h"
54 static int chkSuper(struct super_block *);
55 static int logMOUNT(struct super_block *sb);
60 * FUNCTION: vfs_mount()
62 * PARAMETER: sb - super block
64 * RETURN: -EBUSY - device already mounted or open for write
65 * -EBUSY - cvrdvp already mounted;
66 * -EBUSY - mount table full
67 * -ENOTDIR- cvrdvp not directory on a device mount
68 * -ENXIO - device open failure
70 int jfs_mount(struct super_block *sb)
72 int rc = 0; /* Return code */
73 struct jfs_sb_info *sbi = JFS_SBI(sb);
74 struct inode *ipaimap = NULL;
75 struct inode *ipaimap2 = NULL;
76 struct inode *ipimap = NULL;
77 struct inode *ipbmap = NULL;
80 * read/validate superblock
81 * (initialize mount inode from the superblock)
83 if ((rc = chkSuper(sb))) {
87 ipaimap = diReadSpecial(sb, AGGREGATE_I, 0);
88 if (ipaimap == NULL) {
89 jfs_err("jfs_mount: Failed to read AGGREGATE_I");
93 sbi->ipaimap = ipaimap;
95 jfs_info("jfs_mount: ipaimap:0x%p", ipaimap);
98 * initialize aggregate inode allocation map
100 if ((rc = diMount(ipaimap))) {
101 jfs_err("jfs_mount: diMount(ipaimap) failed w/rc = %d", rc);
106 * open aggregate block allocation map
108 ipbmap = diReadSpecial(sb, BMAP_I, 0);
109 if (ipbmap == NULL) {
114 jfs_info("jfs_mount: ipbmap:0x%p", ipbmap);
116 sbi->ipbmap = ipbmap;
119 * initialize aggregate block allocation map
121 if ((rc = dbMount(ipbmap))) {
122 jfs_err("jfs_mount: dbMount failed w/rc = %d", rc);
127 * open the secondary aggregate inode allocation map
129 * This is a duplicate of the aggregate inode allocation map.
131 * hand craft a vfs in the same fashion as we did to read ipaimap.
132 * By adding INOSPEREXT (32) to the inode number, we are telling
133 * diReadSpecial that we are reading from the secondary aggregate
134 * inode table. This also creates a unique entry in the inode hash
137 if ((sbi->mntflag & JFS_BAD_SAIT) == 0) {
138 ipaimap2 = diReadSpecial(sb, AGGREGATE_I, 1);
140 jfs_err("jfs_mount: Failed to read AGGREGATE_I");
144 sbi->ipaimap2 = ipaimap2;
146 jfs_info("jfs_mount: ipaimap2:0x%p", ipaimap2);
149 * initialize secondary aggregate inode allocation map
151 if ((rc = diMount(ipaimap2))) {
152 jfs_err("jfs_mount: diMount(ipaimap2) failed, rc = %d",
157 /* Secondary aggregate inode table is not valid */
158 sbi->ipaimap2 = NULL;
161 * mount (the only/single) fileset
164 * open fileset inode allocation map (aka fileset inode)
166 ipimap = diReadSpecial(sb, FILESYSTEM_I, 0);
167 if (ipimap == NULL) {
168 jfs_err("jfs_mount: Failed to read FILESYSTEM_I");
169 /* open fileset secondary inode allocation map */
173 jfs_info("jfs_mount: ipimap:0x%p", ipimap);
175 /* map further access of per fileset inodes by the fileset inode */
176 sbi->ipimap = ipimap;
178 /* initialize fileset inode allocation map */
179 if ((rc = diMount(ipimap))) {
180 jfs_err("jfs_mount: diMount failed w/rc = %d", rc);
189 errout41: /* close fileset inode allocation map inode */
190 diFreeSpecial(ipimap);
192 errout40: /* fileset closed */
194 /* close secondary aggregate inode allocation map */
196 diUnmount(ipaimap2, 1);
197 diFreeSpecial(ipaimap2);
202 /* close aggregate block allocation map */
203 dbUnmount(ipbmap, 1);
204 diFreeSpecial(ipbmap);
206 errout22: /* close aggregate inode allocation map */
208 diUnmount(ipaimap, 1);
210 errout21: /* close aggregate inodes */
211 diFreeSpecial(ipaimap);
212 errout20: /* aggregate closed */
217 jfs_err("Mount JFS Failure: %d", rc);
223 * NAME: jfs_mount_rw(sb, remount)
225 * FUNCTION: Completes read-write mount, or remounts read-only volume
228 int jfs_mount_rw(struct super_block *sb, int remount)
230 struct jfs_sb_info *sbi = JFS_SBI(sb);
234 * If we are re-mounting a previously read-only volume, we want to
235 * re-read the inode and block maps, since fsck.jfs may have updated
239 if (chkSuper(sb) || (sbi->state != FM_CLEAN))
242 truncate_inode_pages(sbi->ipimap->i_mapping, 0);
243 truncate_inode_pages(sbi->ipbmap->i_mapping, 0);
244 diUnmount(sbi->ipimap, 1);
245 if ((rc = diMount(sbi->ipimap))) {
246 jfs_err("jfs_mount_rw: diMount failed!");
250 dbUnmount(sbi->ipbmap, 1);
251 if ((rc = dbMount(sbi->ipbmap))) {
252 jfs_err("jfs_mount_rw: dbMount failed!");
258 * open/initialize log
260 if ((rc = lmLogOpen(sb)))
264 * update file system superblock;
266 if ((rc = updateSuper(sb, FM_MOUNT))) {
267 jfs_err("jfs_mount: updateSuper failed w/rc = %d", rc);
273 * write MOUNT log record of the file system
283 * validate the superblock of the file system to be mounted and
284 * get the file system parameters.
287 * 0 with fragsize set if check successful
288 * error code if not successful
290 static int chkSuper(struct super_block *sb)
293 struct jfs_sb_info *sbi = JFS_SBI(sb);
294 struct jfs_superblock *j_sb;
295 struct buffer_head *bh;
296 int AIM_bytesize, AIT_bytesize;
297 int expected_AIM_bytesize, expected_AIT_bytesize;
298 s64 AIM_byte_addr, AIT_byte_addr, fsckwsp_addr;
299 s64 byte_addr_diff0, byte_addr_diff1;
302 if ((rc = readSuper(sb, &bh)))
304 j_sb = (struct jfs_superblock *)bh->b_data;
307 * validate superblock
309 /* validate fs signature */
310 if (strncmp(j_sb->s_magic, JFS_MAGIC, 4) ||
311 le32_to_cpu(j_sb->s_version) > JFS_VERSION) {
316 bsize = le32_to_cpu(j_sb->s_bsize);
318 if (bsize != PSIZE) {
319 jfs_err("Currently only 4K block size supported!");
325 jfs_info("superblock: flag:0x%08x state:0x%08x size:0x%Lx",
326 le32_to_cpu(j_sb->s_flag), le32_to_cpu(j_sb->s_state),
327 (unsigned long long) le64_to_cpu(j_sb->s_size));
329 /* validate the descriptors for Secondary AIM and AIT */
330 if ((j_sb->s_flag & cpu_to_le32(JFS_BAD_SAIT)) !=
331 cpu_to_le32(JFS_BAD_SAIT)) {
332 expected_AIM_bytesize = 2 * PSIZE;
333 AIM_bytesize = lengthPXD(&(j_sb->s_aim2)) * bsize;
334 expected_AIT_bytesize = 4 * PSIZE;
335 AIT_bytesize = lengthPXD(&(j_sb->s_ait2)) * bsize;
336 AIM_byte_addr = addressPXD(&(j_sb->s_aim2)) * bsize;
337 AIT_byte_addr = addressPXD(&(j_sb->s_ait2)) * bsize;
338 byte_addr_diff0 = AIT_byte_addr - AIM_byte_addr;
339 fsckwsp_addr = addressPXD(&(j_sb->s_fsckpxd)) * bsize;
340 byte_addr_diff1 = fsckwsp_addr - AIT_byte_addr;
341 if ((AIM_bytesize != expected_AIM_bytesize) ||
342 (AIT_bytesize != expected_AIT_bytesize) ||
343 (byte_addr_diff0 != AIM_bytesize) ||
344 (byte_addr_diff1 <= AIT_bytesize))
345 j_sb->s_flag |= cpu_to_le32(JFS_BAD_SAIT);
348 if ((j_sb->s_flag & cpu_to_le32(JFS_GROUPCOMMIT)) !=
349 cpu_to_le32(JFS_GROUPCOMMIT))
350 j_sb->s_flag |= cpu_to_le32(JFS_GROUPCOMMIT);
352 /* validate fs state */
353 if (j_sb->s_state != cpu_to_le32(FM_CLEAN) &&
355 jfs_err("jfs_mount: Mount Failure: File System Dirty.");
360 sbi->state = le32_to_cpu(j_sb->s_state);
361 sbi->mntflag = le32_to_cpu(j_sb->s_flag);
364 * JFS always does I/O by 4K pages. Don't tell the buffer cache
365 * that we use anything else (leave s_blocksize alone).
368 sbi->l2bsize = le16_to_cpu(j_sb->s_l2bsize);
370 /* check some fields for possible corruption */
371 if (sbi->l2bsize != ilog2((u32)bsize) ||
373 le32_to_cpu(j_sb->s_state) > FM_STATE_MAX) {
375 jfs_err("jfs_mount: Mount Failure: superblock is corrupt!");
380 * For now, ignore s_pbsize, l2bfactor. All I/O going through buffer
383 sbi->nbperpage = PSIZE >> sbi->l2bsize;
384 sbi->l2nbperpage = L2PSIZE - sbi->l2bsize;
385 sbi->l2niperblk = sbi->l2bsize - L2DISIZE;
386 if (sbi->mntflag & JFS_INLINELOG)
387 sbi->logpxd = j_sb->s_logpxd;
389 sbi->logdev = new_decode_dev(le32_to_cpu(j_sb->s_logdev));
390 uuid_copy(&sbi->uuid, &j_sb->s_uuid);
391 uuid_copy(&sbi->loguuid, &j_sb->s_loguuid);
393 sbi->fsckpxd = j_sb->s_fsckpxd;
394 sbi->ait2 = j_sb->s_ait2;
405 * update synchronously superblock if it is mounted read-write.
407 int updateSuper(struct super_block *sb, uint state)
409 struct jfs_superblock *j_sb;
410 struct jfs_sb_info *sbi = JFS_SBI(sb);
411 struct buffer_head *bh;
414 if (sbi->flag & JFS_NOINTEGRITY) {
415 if (state == FM_DIRTY) {
416 sbi->p_state = state;
418 } else if (state == FM_MOUNT) {
419 sbi->p_state = sbi->state;
421 } else if (state == FM_CLEAN) {
422 state = sbi->p_state;
424 jfs_err("updateSuper: bad state");
425 } else if (sbi->state == FM_DIRTY)
428 if ((rc = readSuper(sb, &bh)))
431 j_sb = (struct jfs_superblock *)bh->b_data;
433 j_sb->s_state = cpu_to_le32(state);
436 if (state == FM_MOUNT) {
437 /* record log's dev_t and mount serial number */
438 j_sb->s_logdev = cpu_to_le32(new_encode_dev(sbi->log->bdev->bd_dev));
439 j_sb->s_logserial = cpu_to_le32(sbi->log->serial);
440 } else if (state == FM_CLEAN) {
442 * If this volume is shared with OS/2, OS/2 will need to
443 * recalculate DASD usage, since we don't deal with it.
445 if (j_sb->s_flag & cpu_to_le32(JFS_DASD_ENABLED))
446 j_sb->s_flag |= cpu_to_le32(JFS_DASD_PRIME);
449 mark_buffer_dirty(bh);
450 sync_dirty_buffer(bh);
460 * read superblock by raw sector address
462 int readSuper(struct super_block *sb, struct buffer_head **bpp)
464 /* read in primary superblock */
465 *bpp = sb_bread(sb, SUPER1_OFF >> sb->s_blocksize_bits);
469 /* read in secondary/replicated superblock */
470 *bpp = sb_bread(sb, SUPER2_OFF >> sb->s_blocksize_bits);
481 * function: write a MOUNT log record for file system.
483 * MOUNT record keeps logredo() from processing log records
484 * for this file system past this point in log.
485 * it is harmless if mount fails.
487 * note: MOUNT record is at aggregate level, not at fileset level,
488 * since log records of previous mounts of a fileset
489 * (e.g., AFTER record of extent allocation) have to be processed
490 * to update block allocation map at aggregate level.
492 static int logMOUNT(struct super_block *sb)
494 struct jfs_log *log = JFS_SBI(sb)->log;
499 lrd.type = cpu_to_le16(LOG_MOUNT);
501 lrd.aggregate = cpu_to_le32(new_encode_dev(sb->s_bdev->bd_dev));
502 lmLog(log, NULL, &lrd, NULL);