-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathfsel.1
More file actions
104 lines (99 loc) · 2.15 KB
/
fsel.1
File metadata and controls
104 lines (99 loc) · 2.15 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
.\" Use: groff -man -Tutf8 fsel.1 | less
.\" Encoding: UTF-8
.TH FSEL 1 "2025-03-12" "v0.1" "File Paths Selector"
.SH NAME
fsel \- manage file lists for batch operations
.SH SYNOPSIS
.B fsel
[\fIOPTIONS\fP] [\fIPATHS...\fP]
.SH DESCRIPTION
\fBfsel\fP is a disk-based file list manager for Linux that handles file path storage, deduplication and retrieval. Designed for large-scale file operations with minimal memory usage. Treat it as a selection for a file manager. You pick up files from different places, then pass the selection to other commands for file operations.
.SH OPTIONS
.TP
.B \-q
Suppress informational messages.
.TP
.B \-s
Sort output alphabetically
.TP
.B \-c
Clear storage after output or clear selection when used without paths
.TP
.B \-f
Force operation ignoring existing lockfile
.TP
.B \-r
Replace existing selection with new paths
.TP
.B \-u
Force remove stale lockfile after confirmation
.TP
.B \-v
Validate the selection
.TP
.B \-l
Long format output (like ls -l)
.TP
.B \-h
Display this help message
.SH EXAMPLES
Add all config files:
.nf
.B $ fsel /etc/*.conf /usr/local/etc/**/*.cfg
.fi
Replace list from find output:
.nf
.B $ find . \-name "*.tmp" | fsel \-r \-v
.fi
Output sorted list to rsync:
.nf
.B $ fsel \-s | xargs \-I{} rsync \-av {} backup:/storage/
.fi
Clear selection:
.nf
.B $ fsel \-c
.fi
Emergency unlock:
.nf
.B $ fsel \-u
.B Other fsel acquired lock. Release existing lock? [Y/N] y
.fi
List with detailed information:
.nf
.B $ fsel \-l
.fi
.SH FILES
.TP
.B $TMPDIR/fsel_<UID>.tmp
Main storage file (user-specific, defaults to /tmp)
.TP
.B $TMPDIR/fsel_<UID>.idx
SHA-256 hash index (binary format)
.TP
.B $TMPDIR/fsel_<UID>.lock
User-specific operation lockfile
.SH SECURITY
All user files created with 0600 permissions. Lockfiles prevent concurrent modifications. SHA-256 hashing ensures path uniqueness.
.SH EXIT STATUS
.TP
.B 0
Success
.TP
.B 1
General error
.TP
.B 2
Invalid arguments
.TP
.B 3
Lockfile conflict
.SH SEE ALSO
.BR xargs (1),
.BR find (1),
.BR rsync (1)
.SH BUGS
Report issues at: \fIhttps://github.com/uwfmt/fsel/issues\fP
.SH AUTHOR
Alexander Grafov <[email protected]>
.SH LICENSE
GPLv3 License \- See /usr/share/licenses/fsel/LICENSE