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

FreeBSD Manual Pages

  
 
  

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

NAME
     pbcopy,  pbpaste - provide copying and pasting to the pasteboard (the Clip-
     board) from command line

SYNOPSIS
     pbcopy [-help] [-pboard {general | ruler | find | font}]

     pbpaste [-help] [-pboard {general | ruler | find | font}] [-Prefer  {txt  |
     rtf | ps}]

DESCRIPTION
     pbcopy  takes the standard input and places it in the specified pasteboard.
     If no pasteboard is specified, the general pasteboard will be used  by  de-
     fault.   The input is placed in the pasteboard as plain text data unless it
     begins with the Encapsulated PostScript (EPS) file header or the Rich  Text
     Format  (RTF)  file header, in which case it is placed in the pasteboard as
     one of those data types.

     pbpaste removes the data from the pasteboard and writes it to the	standard
     output.   It normally looks first for plain text data in the pasteboard and
     writes that to the standard output; if no plain text data is in the  paste-
     board  it	looks for Encapsulated PostScript; if no EPS is present it looks
     for Rich Text.  If none of those types is present in  the	pasteboard,  pb-
     paste produces no output.

     * Encoding:

     pbcopy and pbpaste use locale environment variables to determine the encod-
     ing to be used for input and output.  For example, absent other locale set-
     tings,  setting the environment variable LANG=en_US.UTF-8 will cause pbcopy
     and pbpaste to use UTF-8 for input and output.  If an  encoding  cannot  be
     determined  from  the locale, the standard C encoding will be used.  Use of
     UTF-8 is recommended.  Note that by default the Terminal  application  uses
     the  UTF-8  encoding and automatically sets the appropriate locale environ-
     ment variable.

OPTIONS
     -pboard {general | ruler | find | font}
	    specifies which pasteboard to copy to or paste from.  If  no  paste-
	    board is given, the general pasteboard will be used by default.

     -Prefer {txt | rtf | ps}
	    tells pbpaste what type of data to look for in the pasteboard first.
	    As	stated	above, pbpaste normally looks first for plain text data;
	    however, by specifying -Prefer ps you can tell pbpaste to look first
	    for Encapsulated PostScript.  If you specify  -Prefer  rtf,  pbpaste
	    looks  first  for  Rich Text format.  In any case, pbpaste looks for
	    the other formats if the preferred one is not found.  The txt option
	    replaces the deprecated ascii option, which continues to function as
	    before.  Both indicate a preference for plain text.

SEE ALSO
     ADC Reference Library:
     Cocoa > Interapplication Communication > Copying and Pasting
     Carbon > Interapplication Communication >	Pasteboard  Manager  Programming
     Guide
     Carbon > Interapplication Communication > Pasteboard Manager Reference

BUGS
     There is no way to tell pbpaste to get only a specified data type.

Apple Computer, Inc.		January 12, 2005		       PBCOPY(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pbcopy&sektion=1&manpath=macOS+26.6.1>

home | help