pr(1) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

pr(1)

pr(1)                            User Commands                           pr(1)

NAME
       pr - print files

SYNOPSIS
       /usr/bin/pr [+ page] [-column] [-adFmrt] [-e [char] [gap]]
            [-h header] [-i [char] [gap]] [-l lines]
            [-n [char] [width]] [-o offset] [-s [char]]
            [-w width] [-fp] [file]...


       /usr/xpg4/bin/pr [+ page] [-column | -c column] [-adFmrt]
            [-e [char] [gap]] [-h header] [-i [char] [gap]]
            [-l lines] [-n [char] [width]] [-o offset]
            [-s [char]] [-w width] [-fp] [file]...

DESCRIPTION
       The  pr  utility is a printing and pagination filter. If multiple input
       files are specified, each is read, formatted, and written  to  standard
       output.  By  default,  the  input is separated into 66-line pages, each
       with:

           o      a 5-line header that includes the page  number,  date,  time
                  and the path name of the file


           o      a 5-line trailer consisting of blank lines



       If  standard  output is associated with a terminal, diagnostic messages
       will be deferred until the pr utility has completed processing.


       When options specifying multi-column output are specified, output  text
       columns will be of equal width; input lines that do not fit into a text
       column  will  be truncated. By default, text columns are separated with
       at least one blank character.

OPTIONS
       The following options are supported. In the following  option  descrip‐
       tions,  column, lines, offset, page, and width are positive decimal in‐
       tegers; gap is a non-negative decimal integer. Some of the option-argu‐
       ments are optional, and some of the option-arguments cannot  be  speci‐
       fied as separate arguments from the preceding option letter. In partic‐
       ular,  the  -s  option does not allow the option letter to be separated
       from its argument, and the options -e, -i, and -n require that both ar‐
       guments, if present, not be separated from the option letter.


       The  following  options  are  supported  for   both   /usr/bin/pr   and
       /usr/xpg4/bin/pr:

       +page                        Begins  output  at page number page of the
                                    formatted input.


       -column                      Produces  multi-column  output   that   is
                                    arranged  in column columns (default is 1)
                                    and is written down each column in the or‐
                                    der in which the text is received from the
                                    input file. This option should not be used
                                    with -m. The -e and -i options will be as‐
                                    sumed  for  multiple  text-column  output.
                                    Whether  or  not text columns are produced
                                    with identical vertical lengths is unspec‐
                                    ified, but a text column will never exceed
                                    the length of the page  (see  the  -l  op‐
                                    tion).  When used with -t, use the minimum
                                    number of lines to write the output.


       -a                           Modifies the effect of the -column  option
                                    so  that the columns are filled across the
                                    page in a round-robin order (for  example,
                                    when  column  is  2,  the first input line
                                    heads column 1, the second heads column 2,
                                    the third is the second line in column  1,
                                    and so forth).


       -d                           Produces output that is double-spaced; ap‐
                                    pend  an extra NEWLINE character following
                                    every NEWLINE character found in  the  in‐
                                    put.


       -e[char][gap]                Expands  each  input  TAB character to the
                                    next greater column position specified  by
                                    the formula n  *gap+1, where n is an inte‐
                                    ger  >0. If gap is 0 or is omitted, it de‐
                                    faults to 8. All TAB characters in the in‐
                                    put will be expanded into the  appropriate
                                    number  of  SPACE  characters. If any non-
                                    digit character, char,  is  specified,  it
                                    will be used as the input tab character.


       -f                           Uses  a  FORMFEED character for new pages,
                                    instead of the default behavior that  uses
                                    a  sequence  of NEWLINE characters. Pauses
                                    before beginning the  first  page  if  the
                                    standard  output is associated with a ter‐
                                    minal.


       -h header                    Uses the string header to replace the con‐
                                    tents of the  file  operand  in  the  page
                                    header.


       -l lines                     Overrides  the  66-line  default and reset
                                    the page length to lines. If lines is  not
                                    greater  than  the  sum of both the header
                                    and trailer depths  (in  lines),  pr  will
                                    suppress  both  the header and trailer, as
                                    if the -t option were in effect.


       -m                           Merges files. Standard output will be for‐
                                    matted so pr writes  one  line  from  each
                                    file  specified by file, side by side into
                                    text columns of  equal  fixed  widths,  in
                                    terms  of  the number of column positions.
                                    Implementations  support  merging  of   at
                                    least nine files.


       -n[char][width]              Provides  width-digit  line numbering (de‐
                                    fault for width is 5). The number will oc‐
                                    cupy the first width column  positions  of
                                    each text column of default output or each
                                    line  of -m output. If char (any non-digit
                                    character) is given, it will  be  appended
                                    to  the  line  number  to separate it from
                                    whatever follows (default for  char  is  a
                                    TAB character).


       -o offset                    Each  line  of  output will be preceded by
                                    offset <space>s. If the -o option  is  not
                                    specified,  the  default  offset is 0. The
                                    space taken will be  in  addition  to  the
                                    output line width (see -w option below).


       -p                           Pauses  before  beginning each page if the
                                    standard output is directed to a  terminal
                                    (pr will write an ALERT character to stan‐
                                    dard  error and wait for a carriage-return
                                    character to be read on /dev/tty).


       -r                           Writes no diagnostic reports on failure to
                                    open files.


       -s [char]                    Separates text columns by the single char‐
                                    acter char instead of by  the  appropriate
                                    number  of  SPACE  characters (default for
                                    char is the TAB character).


       -t                           Writes neither the  five-line  identifying
                                    header  nor  the five-line trailer usually
                                    supplied for each page. Quits writing  af‐
                                    ter  the  last  line  of each file without
                                    spacing to the end of the page.


       -w width                     Sets the width of the line to width column
                                    positions for multiple text-column  output
                                    only.  If  the  -w option is not specified
                                    and the -s option is  not  specified,  the
                                    default  width  is 72. If the -w option is
                                    not specified and the -s option is  speci‐
                                    fied, the default width is 512.

                                    For single column output, input lines will
                                    not be truncated.


   /usr/bin/pr
       The following options are supported for /usr/bin/pr only:

       -F                         Folds the lines of the input file. When used
                                  in  multi-column mode (with the -a or -m op‐
                                  tions), lines will be folded to fit the cur‐
                                  rent column's width. Otherwise, they will be
                                  folded to fit the  current  line  width  (80
                                  columns).


       -i[char][gap]              In  output,  replaces  SPACE characters with
                                  TAB characters wherever one or more adjacent
                                  SPACE  characters  reach  column   positions
                                  gap+1,  2*gap+1,  3*gap+1,  and so forth. If
                                  gap is 0 or is omitted, default TAB settings
                                  at every eighth column position are assumed.
                                  If any non-digit character, char, is  speci‐
                                  fied,  it  will  be  used  as the output TAB
                                  character.


   /usr/xpg4/bin/pr
       The following options are supported for /usr/xpg4/bin/pr only:

       -F                         Uses a FORMFEED character for new pages, in‐
                                  stead of the default behavior  that  uses  a
                                  sequence of NEWLINE characters.


       -i[char][gap]              In  output,  replaces multiple SPACE charac‐
                                  ters with TAB  characters  wherever  two  or
                                  more  adjacent SPACE characters reach column
                                  positions gap+1, 2*gap+1,  3*gap+1,  and  so
                                  forth.  If  gap  is 0 or is omitted, default
                                  TAB settings at every eighth column position
                                  are assumed.  If  any  non-digit  character,
                                  char,  is  specified, it will be used as the
                                  output TAB character.


   /usr/xpg7/bin/pr
       The following options are supported for /usr/xpg7/bin/pr only:


       -F               Uses a FORMFEED character for new  pages,  instead  of
                        the  default  behavior that uses a sequence of NEWLINE
                        characters.


       -i[char][gap]    In output, replaces SPACE characters with TAB  charac‐
                        ters  wherever  one  or more adjacent SPACE characters
                        reach column positions gap+1, 2*gap+1, 3*gap+1, and so
                        forth. If gap is 0 or is omitted, default TAB settings
                        at every eighth column position are  assumed.  If  any
                        non-digit  character,  char,  is specified, it will be
                        used as the output TAB character.



OPERANDS
       The following operand is supported:

       file    A path name of a file to be written. If no  file  operands  are
               specified,  or  if a file operand is −, the standard input will
               be used.


EXAMPLES
       Example 1 Printing a numbered list of all files in the  current  direc‐
       tory


         example% ls -a | pr -n -h "Files in $(pwd)."


       Example 2 Printing files in columns



       This  example  prints  file1 and file2 as a double-spaced, three-column
       listing headed by file list:


         example% pr -3d -h "file list" file1 file2


       Example 3 Writing files with expanded column tabs



       The following example writes file1 on file2, expanding tabs to  columns
       10, 19, 28, ...


         example% pr -e9 -t <file1 >file2


ENVIRONMENT VARIABLES
       See  environ(7) for descriptions of the following environment variables
       that affect the execution of pr: LANG, LC_ALL,  LC_CTYPE,  LC_MESSAGES,
       LC_TIME, TZ, and NLSPATH.

EXIT STATUS
       The following exit values are returned:

       0     Successful completion.


       >0    An error occurred.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

   /usr/bin/pr
       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ Availabilitysystem/core-os _ CSIEnabled


   /usr/xpg4/bin/pr
       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE  VALUE _ Availabilitysystem/xopen/xcu4 _ CSIEnabled _ Interface
       StabilityCommitted _ StandardSee standards(7).


SEE ALSO
       expand(1), attributes(7), environ(7), standards(7)

Oracle Solaris 11.4               6 May 2016                             pr(1)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3