xref: /freebsd/usr.sbin/trim/trim.c (revision 328110da2661a8841f12000b99fea27ceacdd5b2)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
3  *
4  * Copyright (c) 2019 Eugene Grosbein <eugen@FreeBSD.org>.
5  * Contains code written by Alan Somers <asomers@FreeBSD.org>.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  * SUCH DAMAGE.
27  *
28  */
29 
30 #include <sys/disk.h>
31 #include <sys/ioctl.h>
32 #include <sys/stat.h>
33 
34 #include <err.h>
35 #include <errno.h>
36 #include <fcntl.h>
37 #include <libutil.h>
38 #include <limits.h>
39 #include <paths.h>
40 #include <stdbool.h>
41 #include <stdio.h>
42 #include <stdlib.h>
43 #include <string.h>
44 #include <sysexits.h>
45 #include <unistd.h>
46 
47 #include <sys/cdefs.h>
48 static bool	candelete(int fd);
49 static off_t	getsize(const char *path);
50 static int	opendev(const char *path, int flags);
51 static int	trim(const char *path, off_t offset, off_t length, bool dryrun, bool verbose);
52 static void	usage(const char *name);
53 
54 int
55 main(int argc, char **argv)
56 {
57 	off_t offset, length;
58 	uint64_t usz;
59 	int ch, error;
60 	bool dryrun, verbose;
61 	char *fname, *name;
62 
63 	error = 0;
64 	length = offset = 0;
65 	name = argv[0];
66 	dryrun = verbose = true;
67 
68 	while ((ch = getopt(argc, argv, "Nfl:o:qr:v")) != -1)
69 		switch (ch) {
70 		case 'N':
71 			dryrun = true;
72 			verbose = true;
73 			break;
74 		case 'f':
75 			dryrun = false;
76 			break;
77 		case 'l':
78 		case 'o':
79 			if (expand_number(optarg, &usz) == -1 ||
80 					(off_t)usz < 0 || (usz == 0 && ch == 'l'))
81 				errx(EX_USAGE,
82 					"invalid %s of the region: %s",
83 					ch == 'o' ? "offset" : "length",
84 					optarg);
85 			if (ch == 'o')
86 				offset = (off_t)usz;
87 			else
88 				length = (off_t)usz;
89 			break;
90 		case 'q':
91 			verbose = false;
92 			break;
93 		case 'r':
94 			if ((length = getsize(optarg)) == 0)
95 				errx(EX_USAGE,
96 					"invalid zero length reference file"
97 					" for the region: %s", optarg);
98 			break;
99 		case 'v':
100 			verbose = true;
101 			break;
102 		default:
103 			usage(name);
104 			/* NOTREACHED */
105 		}
106 
107 	/*
108 	 * Safety net: do not allow mistakes like
109 	 *
110 	 *	trim -f /dev/da0 -r rfile
111 	 *
112 	 * This would trim whole device then error on non-existing file -r.
113 	 * Following check prevents this while allowing this form still:
114 	 *
115 	 *	trim -f -- /dev/da0 -r rfile
116 	 */
117 
118 	if (strcmp(argv[optind-1], "--") != 0) {
119 		for (ch = optind; ch < argc; ch++)
120 			if (argv[ch][0] == '-')
121 				usage(name);
122 	}
123 
124 	argv += optind;
125 	argc -= optind;
126 
127 	if (argc < 1)
128 		usage(name);
129 
130 	if (dryrun)
131 		printf("dry run: add -f to actually perform the operation\n");
132 
133 	while ((fname = *argv++) != NULL)
134 		if (trim(fname, offset, length, dryrun, verbose) < 0)
135 			error++;
136 
137 	return (error ? EXIT_FAILURE : EXIT_SUCCESS);
138 }
139 
140 static bool
141 candelete(int fd)
142 {
143 	struct diocgattr_arg arg;
144 
145 	strlcpy(arg.name, "GEOM::candelete", sizeof(arg.name));
146 	arg.len = sizeof(arg.value.i);
147 	if (ioctl(fd, DIOCGATTR, &arg) == 0)
148 		return (arg.value.i != 0);
149 	else
150 		return (false);
151 }
152 
153 static int
154 opendev(const char *path, int flags)
155 {
156 	int fd;
157 	char *tstr;
158 
159 	if ((fd = open(path, flags)) < 0) {
160 		if (errno == ENOENT && path[0] != '/') {
161 			if (asprintf(&tstr, "%s%s", _PATH_DEV, path) < 0)
162 				errx(EX_OSERR, "no memory");
163 			fd = open(tstr, flags);
164 			free(tstr);
165 		}
166 	}
167 
168 	if (fd < 0)
169 		err(EX_NOINPUT, "open failed: %s", path);
170 
171 	return (fd);
172 }
173 
174 static off_t
175 getsize(const char *path)
176 {
177 	struct stat sb;
178 	off_t mediasize;
179 	int fd;
180 
181 	fd = opendev(path, O_RDONLY | O_DIRECT);
182 
183 	if (fstat(fd, &sb) < 0)
184 		err(EX_IOERR, "fstat failed: %s", path);
185 
186 	if (S_ISREG(sb.st_mode) || S_ISDIR(sb.st_mode)) {
187 		close(fd);
188 		return (sb.st_size);
189 	}
190 
191 	if (!S_ISCHR(sb.st_mode) && !S_ISBLK(sb.st_mode))
192 		errx(EX_DATAERR,
193 			"invalid type of the file "
194 			"(not regular, directory nor special device): %s",
195 			path);
196 
197 	if (ioctl(fd, DIOCGMEDIASIZE, &mediasize) < 0)
198 		err(EX_UNAVAILABLE,
199 			"ioctl(DIOCGMEDIASIZE) failed, probably not a disk: "
200 			"%s", path);
201 
202 	close(fd);
203 	return (mediasize);
204 }
205 
206 static int
207 trim(const char *path, off_t offset, off_t length, bool dryrun, bool verbose)
208 {
209 	off_t arg[2];
210 	int error, fd;
211 
212 	if (length == 0)
213 		length = getsize(path);
214 
215 	if (verbose)
216 		printf("trim %s offset %ju length %ju\n",
217 		    path, (uintmax_t)offset, (uintmax_t)length);
218 
219 	if (dryrun)
220 		return (0);
221 
222 	fd = opendev(path, O_RDWR | O_DIRECT);
223 	arg[0] = offset;
224 	arg[1] = length;
225 
226 	error = ioctl(fd, DIOCGDELETE, arg);
227 	if (error < 0) {
228 		if (errno == EOPNOTSUPP && verbose && !candelete(fd))
229 			warnx("%s: TRIM/UNMAP not supported by driver", path);
230 		else
231 			warn("ioctl(DIOCGDELETE) failed: %s", path);
232 	}
233 	close(fd);
234 	return (error);
235 }
236 
237 static void
238 usage(const char *name)
239 {
240 	(void)fprintf(stderr,
241 	    "usage: %s [-[lo] offset[K|k|M|m|G|g|T|t|P|p|E|e]] [-r rfile] [-Nfqv] device ...\n",
242 	    name);
243 	exit(EX_USAGE);
244 }
245