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
       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 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 recognized 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).

Debian                                            July 10, 2015                                          YANK(1)