pbs(8) [mojave man page]

PBS(8)							    BSD System Manager's Manual 						    PBS(8)

NAME

     pbs -- general helper tool

SYNOPSIS

     pbs [-debug] [-dump_pboard] [-dump_userdefs] [-flush_pboard] [-flush_userdefs] language1 language2 ...

DESCRIPTION

     pbs is an agent for the Services menu.  It scans for and vends available Services, to populate the Services menu.

     pbs is NOT related to the pasteboard.  The pasteboard is managed by the pboard agent.

     pbs normally runs the first time Services are needed in any login session.  You may run it manually for debugging Services. If run without
     any options, pbs will scan for changed Services, cache them along with their English localization on a private pasteboard, and immediately
     update the Services menu in all running apps. It will also log about any invalid Services declarations in Info.plist. This is useful when
     developing or testing Services, because it immediately applies any changes.

     ServicesMenu.strings files for a localization are loaded only when an app running under that localization shows the Services menu.  You may
     pass pbs language codes (e.g. "fr") to cause it to load that localization immediately.

     pbs has additional options that are useful for debugging, in particular the -dump_pboard option. The complete list of options is:

     -debug
	 Output debugging information regarding what pbs is doing.

     -dump_pboard
	 Prints the private pasteboard containing the current Services information.  You can use this to determine which apps are providing Ser-
	 vices and where they are located on the filesystem.

     -dump_userdefs
	 Prints the userdef cache of Services information.  pbs caches Services information in its userdefs to avoid scanning the entire system
	 every boot.  Changed apps are still detected via FSEvents, so there is no need to flush the userdef cache when installing a new Service.

     -flush_pboard
	 Erases the private pasteboard containing Services information.  The next time the Services menu is shown, pbs will scan for changed Ser-
	 vices and update the pasteboard.

     -flush_userdefs
	 Erases the userdef cache.

     -flush
	 Equivalent to -flush_pboard and -flush_userdefs, entirely resetting pbs. The next time Services information is needed, pbs will do a com-
	 plete rescan for apps vending Services, and read their plist.	Note: this rescan may be very expensive!

HISTORY

     First appeared in NextStep.  pbs has historically had responsibilities that ranged from pasteboard management to Unicode glyph generation,
     but now it only does Services.

macOS								   June 1, 2006 							     macOS

PBCOPY(1)						      General Commands Manual							 PBCOPY(1)

NAME

       pbcopy, pbpaste - provide copying and pasting to the pasteboard (the Clipboard) 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 default.  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 pasteboard 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, pbpaste produces no output.

       * Encoding:

       pbcopy  and  pbpaste use locale environment variables to determine the encoding to be used for input and output.  For example, absent other
       locale settings, 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 environment variable.

OPTIONS

       -pboard {general | ruler | find | font}
	      specifies which pasteboard to copy to or paste from.  If no pasteboard 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)