xref: /openbmc/linux/fs/nilfs2/sufile.h (revision a703018f)
1 /*
2  * sufile.h - NILFS segment usage file.
3  *
4  * Copyright (C) 2006-2008 Nippon Telegraph and Telephone Corporation.
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 as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
19  *
20  * Written by Koji Sato <koji@osrg.net>.
21  */
22 
23 #ifndef _NILFS_SUFILE_H
24 #define _NILFS_SUFILE_H
25 
26 #include <linux/fs.h>
27 #include <linux/buffer_head.h>
28 #include <linux/nilfs2_fs.h>
29 #include "mdt.h"
30 
31 #define NILFS_SUFILE_GFP	NILFS_MDT_GFP
32 
33 static inline unsigned long nilfs_sufile_get_nsegments(struct inode *sufile)
34 {
35 	return NILFS_MDT(sufile)->mi_nilfs->ns_nsegments;
36 }
37 
38 int nilfs_sufile_alloc(struct inode *, __u64 *);
39 int nilfs_sufile_get_segment_usage(struct inode *, __u64,
40 				   struct nilfs_segment_usage **,
41 				   struct buffer_head **);
42 void nilfs_sufile_put_segment_usage(struct inode *, __u64,
43 				    struct buffer_head *);
44 int nilfs_sufile_get_stat(struct inode *, struct nilfs_sustat *);
45 int nilfs_sufile_get_ncleansegs(struct inode *, unsigned long *);
46 ssize_t nilfs_sufile_get_suinfo(struct inode *, __u64, struct nilfs_suinfo *,
47 				size_t);
48 
49 int nilfs_sufile_update(struct inode *, __u64, int,
50 			void (*dofunc)(struct inode *, __u64,
51 				       struct buffer_head *,
52 				       struct buffer_head *));
53 void nilfs_sufile_do_cancel_free(struct inode *, __u64, struct buffer_head *,
54 				 struct buffer_head *);
55 void nilfs_sufile_do_free(struct inode *, __u64, struct buffer_head *,
56 			  struct buffer_head *);
57 void nilfs_sufile_do_set_error(struct inode *, __u64, struct buffer_head *,
58 			       struct buffer_head *);
59 
60 /**
61  * nilfs_sufile_cancel_free -
62  * @sufile: inode of segment usage file
63  * @segnum: segment number
64  *
65  * Description:
66  *
67  * Return Value: On success, 0 is returned. On error, one of the following
68  * negative error codes is returned.
69  *
70  * %-EIO - I/O error.
71  *
72  * %-ENOMEM - Insufficient amount of memory available.
73  */
74 static inline int nilfs_sufile_cancel_free(struct inode *sufile, __u64 segnum)
75 {
76 	return nilfs_sufile_update(sufile, segnum, 0,
77 				   nilfs_sufile_do_cancel_free);
78 }
79 
80 /**
81  * nilfs_sufile_free - free segment
82  * @sufile: inode of segment usage file
83  * @segnum: segment number to be freed
84  */
85 static inline int nilfs_sufile_free(struct inode *sufile, __u64 segnum)
86 {
87 	return nilfs_sufile_update(sufile, segnum, 0, nilfs_sufile_do_free);
88 }
89 
90 /**
91  * nilfs_sufile_set_error - mark a segment as erroneous
92  * @sufile: inode of segment usage file
93  * @segnum: segment number
94  *
95  * Description: nilfs_sufile_set_error() marks the segment specified by
96  * @segnum as erroneous. The error segment will never be used again.
97  *
98  * Return Value: On success, 0 is returned. On error, one of the following
99  * negative error codes is returned.
100  *
101  * %-EIO - I/O error.
102  *
103  * %-ENOMEM - Insufficient amount of memory available.
104  *
105  * %-EINVAL - Invalid segment usage number.
106  */
107 static inline int nilfs_sufile_set_error(struct inode *sufile, __u64 segnum)
108 {
109 	return nilfs_sufile_update(sufile, segnum, 0,
110 				   nilfs_sufile_do_set_error);
111 }
112 
113 #endif	/* _NILFS_SUFILE_H */
114