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".  Press-
     ing the return key will invoke command and write the selected field to  its
     stdin.  The command defaults to xsel(1x) but could be anything that accepts
     input on stdin, see "EXAMPLES".

     The options are as follows:

     -1      If only one field is recognized, select it and invoke command with-
	     out 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 reg-
	     ular 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  recog-
     nized 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  primary
     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 before
     `[' in the argument given to the -d option, see re_format(7).

FreeBSD ports 15.quarterly	  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.1.quarterly>

home | help