Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
YANK(1)			    General Commands Manual		       YANK(1)

NAME
       yank -- yank terminal output to clipboard

SYNOPSIS
       yank [-1ilxv] [-d delim]	[-g pattern] [-- command [argument ...]]

DESCRIPTION
       Read  input  from stdin and display a selection interface that allows a
       field to	be selected and	copied to the clipboard.   Fields  are	either
       recognized  by a	regular	expression using the -g	option or by splitting
       the  input  on  a  delimiter  sequence  using  the   -d	 option,   see
       "DELIMITERS".

       Using  the  arrow  keys	will  move the selected	field, see "COMMANDS".
       Pressing	the return key will invoke  command  and  write	 the  selected
       field to	its stdin.  The	command	defaults to xsel(1x) but could be any-
       thing that accepts input	on stdin, see "EXAMPLES".

       The options are as follows:

       -1      If  only	 one field is recognized, select it and	invoke command
	       without displaying the selection	interface.

       -d delim
	       All input characters not	present	in delim will be recognized as
	       fields, see "DELIMITERS".

       -g pattern
	       Use pattern to recognize	fields,	expressed as a POSIX  extended
	       regular expression.

       -i      Ignore case differences between pattern and the input.

       -l      Use the default delimiters except for space, see	"DELIMITERS".

       -v      Prints version.

       -x      Use alternate screen.

       -- command [argument ...]
	       Use command with	zero or	more args as the yank command.

COMMANDS
       Ctrl-A |	g
	     Move selection to the first field.

       Ctrl-C |	Ctrl-D
	     Exit without invoking the yank command.

       Ctrl-E |	G
	     Move selection to the last	field.

       Ctrl-P/Ctrl-N | Left/Right | h/l
	     Move selection to the left	or right.

       Up/Down | j/k
	     Move selection to the next	or previous line.

       Enter
	     Exit using	the selected field.

DELIMITERS
       If  the -d and -g options are omitted the following characters are rec-
       ognized as delimiters by	default:

       \f    form feed

       \n    new line

       \r    carriage return

       \s    space

       \t    horizontal	tab

       If the -d option	is present space is not	recognized as a	delimiter.

EXAMPLES
       Yank an environment variable key	or value:

	     $ env | yank -d =

       Yank a field from a CSV file:

	     $ yank -d \", <file.csv

       Yank a whole line using the -l option:

	     $ make 2>&1 | yank	-l

       If stdout is not	a terminal the	selected  field	 will  be  written  to
       stdout  and  exit without invoking the yank command.  Kill the selected
       PID:

	     $ ps ux | yank -g [0-9]+ |	xargs kill

       Yank the	selected field to the clipboard	as opposed of the default pri-
       mary clipboard:

	     $ yank -- xsel -b

DIAGNOSTICS
       The yank	utility	exits 0	on success, and	>0 if an error occurs.

SEE ALSO
       re_format(7)

AUTHORS
       Anton Lindqvist <anton@basename.se>

CAVEATS
       Recognizing fields enclosed in brackets requires	`]' to be present  be-
       fore `['	in the argument	given to the -d	option,	see re_format(7).

FreeBSD	ports 15.0		 July 10, 2015			       YANK(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=yank&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help