2 * Trivial ls for comparing two directories after running an rsync.
4 * Copyright (C) 2001, 2002 Martin Pool <mbp@samba.org>
5 * Copyright (C) 2003-2019 Wayne Davison
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 3 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License along
18 * with this program; if not, write to the Free Software Foundation, Inc.,
19 * 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA.
22 /* The problem with using the system's own ls is that some features
23 * have little quirks that make directories look different when for
24 * our purposes they're the same -- for example, the BSD braindamage
25 * about setting the mode on symlinks based on your current umask.
27 * All the filenames must be given on the command line -- tls does not
28 * even read directories, let alone recurse. The typical usage is
29 * "find|sort|xargs tls".
31 * The format is not exactly the same as any particular Unix ls(1).
33 * A key requirement for this program is that the output be "very
34 * reproducible." So we mask away information that can accidentally
39 #include "lib/sysxattrs.h"
43 /* These are to make syscall.o shut up. */
52 int preserve_perms = 0;
53 int preserve_executability = 0;
54 int preallocate_files = 0;
60 #ifdef HAVE_LINUX_XATTRS
61 #define XSTAT_ATTR "user.rsync.%stat"
63 #define XSTAT_ATTR "rsync.%stat"
66 static int stat_xattr(const char *fname, STRUCT_STAT *fst)
68 int mode, rdev_major, rdev_minor, uid, gid, len;
71 if (am_root >= 0 || IS_DEVICE(fst->st_mode) || IS_SPECIAL(fst->st_mode))
74 len = sys_lgetxattr(fname, XSTAT_ATTR, buf, sizeof buf - 1);
75 if (len >= (int)sizeof buf) {
80 if (errno == ENOTSUP || errno == ENOATTR)
82 if (errno == EPERM && S_ISLNK(fst->st_mode)) {
87 fprintf(stderr, "failed to read xattr %s for %s: %s\n",
88 XSTAT_ATTR, fname, strerror(errno));
93 if (sscanf(buf, "%o %d,%d %d:%d",
94 &mode, &rdev_major, &rdev_minor, &uid, &gid) != 5) {
95 fprintf(stderr, "Corrupt %s xattr attached to %s: \"%s\"\n",
96 XSTAT_ATTR, fname, buf);
100 #if _S_IFLNK != 0120000
101 if ((mode & (_S_IFMT)) == 0120000)
102 mode = (mode & ~(_S_IFMT)) | _S_IFLNK;
106 fst->st_rdev = MAKEDEV(rdev_major, rdev_minor);
115 static int display_atimes = 0;
117 static void failed(char const *what, char const *where)
119 fprintf(stderr, PROGRAM ": %s %s: %s\n",
120 what, where, strerror(errno));
124 static void storetime(char *dest, size_t destsize, time_t t, int nsecs)
128 struct tm *mt = gmtime(&t);
130 len = snprintf(dest, destsize,
131 " %04d-%02d-%02d %02d:%02d:%02d",
132 (int)mt->tm_year + 1900,
138 if (nsecs >= 0 && len >= 0)
139 snprintf(dest + len, destsize - len, ".%09d", nsecs);
141 int has_nsecs = nsecs >= 0 ? 1 : 0;
142 int len = MIN(20 + 10*has_nsecs, (int)destsize - 1);
143 memset(dest, ' ', len);
148 static void list_file(const char *fname)
151 char permbuf[PERMSTRING_SIZE];
157 if (do_lstat(fname, &buf) < 0)
158 failed("stat", fname);
159 #ifdef SUPPORT_XATTRS
161 stat_xattr(fname, &buf);
164 /* The size of anything but a regular file is probably not
165 * worth thinking about. */
166 if (!S_ISREG(buf.st_mode))
169 /* On some BSD platforms the mode bits of a symlink are
170 * undefined. Also it tends not to be possible to reset a
171 * symlink's mtime, so we default to ignoring it too. */
172 if (S_ISLNK(buf.st_mode)) {
174 buf.st_mode &= ~0777;
176 buf.st_mtime = (time_t)0;
178 buf.st_uid = buf.st_gid = 0;
179 strlcpy(linkbuf, " -> ", sizeof linkbuf);
180 /* const-cast required for silly UNICOS headers */
181 len = do_readlink((char*)fname, linkbuf+4, sizeof linkbuf - 4);
183 failed("do_readlink", fname);
185 /* it's not nul-terminated */
191 permstring(permbuf, buf.st_mode);
194 nsecs = (int)buf.ST_MTIME_NSEC;
198 storetime(mtimebuf, sizeof mtimebuf, buf.st_mtime, nsecs);
200 storetime(atimebuf, sizeof atimebuf, S_ISDIR(buf.st_mode) ? 0 : buf.st_atime, -1);
204 /* TODO: Perhaps escape special characters in fname? */
205 printf("%s ", permbuf);
207 if (S_ISCHR(buf.st_mode) || S_ISBLK(buf.st_mode)) {
209 (long)major(buf.st_rdev),
210 (long)minor(buf.st_rdev));
212 printf("%15s", do_big_num(buf.st_size, 1, NULL));
214 printf(" %6ld.%-6ld %6ld%s%s %s%s\n",
215 (long)buf.st_uid, (long)buf.st_gid, (long)buf.st_nlink,
216 mtimebuf, atimebuf, fname, linkbuf);
219 static struct poptOption long_options[] = {
220 /* longName, shortName, argInfo, argPtr, value, descrip, argDesc */
221 {"atimes", 'U', POPT_ARG_NONE, &display_atimes, 0, 0, 0},
222 {"link-times", 'l', POPT_ARG_NONE, &link_times, 0, 0, 0 },
223 {"link-owner", 'L', POPT_ARG_NONE, &link_owner, 0, 0, 0 },
224 #ifdef SUPPORT_XATTRS
225 {"fake-super", 'f', POPT_ARG_VAL, &am_root, -1, 0, 0 },
228 {"nsec", 's', POPT_ARG_NONE, &nsec_times, 0, 0, 0 },
230 {"help", 'h', POPT_ARG_NONE, 0, 'h', 0, 0 },
234 static void NORETURN tls_usage(int ret)
236 FILE *F = ret ? stderr : stdout;
237 fprintf(F,"usage: " PROGRAM " [OPTIONS] FILE ...\n");
238 fprintf(F,"Trivial file listing program for portably checking rsync\n");
239 fprintf(F,"\nOptions:\n");
240 fprintf(F," -U, --atimes display access (last-used) times\n");
241 fprintf(F," -l, --link-times display the time on a symlink\n");
242 fprintf(F," -L, --link-owner display the owner+group on a symlink\n");
243 #ifdef SUPPORT_XATTRS
244 fprintf(F," -f, --fake-super display attributes including fake-super xattrs\n");
246 fprintf(F," -h, --help show this help\n");
251 main(int argc, char *argv[])
254 const char **extra_args;
257 pc = poptGetContext(PROGRAM, argc, (const char **)argv,
259 while ((opt = poptGetNextOpt(pc)) != -1) {
266 poptBadOption(pc, POPT_BADOPTION_NOALIAS),
272 extra_args = poptGetArgs(pc);
273 if (!extra_args || *extra_args == NULL)
276 for (; *extra_args; extra_args++)
277 list_file(*extra_args);