-
Notifications
You must be signed in to change notification settings - Fork 0
/
xclipd.1
98 lines (98 loc) · 2 KB
/
xclipd.1
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
.Dd January 18, 2023
.Dt XCLIPD 1
.Os
.Sh NAME
.Nm xclipd ,
.Nm xclipin ,
.Nm xclipout ,
.Nm xclipowner
.Nd clipboard management utilities
.Sh SYNOPSIS
.Nm xclipd
.Nm xclipin
.Op Fl psw
.Op Fl t Ar target
.Op Ar file
.Nm xclipout
.Op Fl p
.Op Fl t Ar target
.Nm xclipowner
.Op Fl pw
.Sh DESCRIPTION
.Nm xclipd
maintains the contents of the
.Ic CLIPBOARD
selection, making it possible to close a window without losing the copied data.
.Pp
.Nm xclipd
also keeps the
.Ic PRIMARY
selection synchronized with the
.Ic CLIPBOARD
selection.
It makes possible that, whenever something is copied into the
.Ic CLIPBOARD
selection, the copied data can also be requested from the
.Ic PRIMARY
selection as well (but not the other way around).
.Pp
.Nm xclipd
does not daemonize itself;
therefore, it should be run in the background.
.Pp
.Nm xclipin
reads data from the given file or standard input and makes it available as the
.Ic STRING
target in the
.Ic CLIPBOARD
selection.
All leading and trailing space around the read content is ignored.
.Pp
.Nm xclipout
gets data available as the
.Ic STRING
target in the
.Ic CLIPBOARD
selection, and write it to the standard output.
.Pp
.Nm xclipowner
writes to the standard output a line containing the ID of the current owner of the
.Ic CLIPBOARD
selection.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl p
Use the
.Ic PRIMARY
selection, rather than the default
.Ic CLIPBOARD
selection.
.It Fl s
Do not ignore space characters around content read by
.Nm xclipin .
.It Fl t Ar target
Use the given
.Ar target ,
rather than the default
.Ic STRING
target.
.It Fl w
Wait/watch mode.
For
.Nm xclipin ,
wait until losing the selection, rather than forking into background.
For
.Nm xclipowner ,
run indefinitely, watching for each transition of the selection's ownership,
ignoring when the owner is a clipboard manager such as
.Nm xclipd .
.El
.Sh ENVIRONMENT
The following environment variables affect the execution of these utilities.
.Bl -tag -width Ds
.It Ev DISPLAY
The display to use.
.El
.Sh SEE ALSO
.Xr X 1