User Commands                                            pargs(1)



NAME
     pargs - print  process  arguments,  environment   variables,
     or auxiliary vector

SYNOPSIS
     pargs [-aceFlx] [pid  core]...


DESCRIPTION
     The pargs utility examines a target process or process  core
     file and prints arguments, environment variables and values,
     or the process auxiliary vector.


     pargs outputs unprintable characters as escaped octal in the
     format  \xxx, unless the character is  one of the characters
     specified in the "Escape Sequences" section  of  formats(5),
     in which case the character is  printed as specified in that
     section.


     pargs attempts to be sensitive to the locale of  the  target
     process.  If the target process and the pargs process do not
     share a common character encoding, pargs attempts to  employ
     the  iconv(3C)  facility  to generate a printable version of
     the extracted  strings. In the event that such a  conversion
     is impossible, strings are displayed as 7-bit ASCI.

OPTIONS
     The following options are supported:

     -a    Prints  process  arguments  as  contained  in   argv[]
           (default).


     -c    Treats strings  in the target process as  though  they
           were  encoded in 7-bit ASCI, regardless of the locale
           of the target. The use of iconv(3C) is suppressed.


     -e    Prints process environment  variables  and  values  as
           pointed  at  by  the  environ symbol or by prenvp in
           /proc/pid/psinfo.


     -F    Force. Grabs the target process even if  another  pro-
           cess has control.


     -l    Displays the arguments as a single command  line.  The
           command  line  is  printed  in  a  manner suitable for
           interpretation by /bin/sh. If  the  arguments  contain



SunOS 5.11          Last change: 19 Jun 2006                    1






User Commands                                            pargs(1)



           unprintable characters, or if the target process is in
           a different locale, a warning  message  is  displayed.
           The  resulting  command  line might not be interpreted
           correctly by /bin/sh.


     -x    Prints process auxiliary vector.


OPERANDS
     The following operands are supported:

     pid     Process ID list.


     core    Process core file.


USAGE
     Caution should be exercised when using the -F flag. Imposing
     two  controlling processes on one victim process can lead to
     chaos. Safety is assured only  if  the  primary  controlling
     process,  typically  a debugger, has stopped the victim pro-
     cess and the primary controlling process is doing nothing at
     the moment of application of the proc tool in question.

EXIT STATUS
     The following exit values are returned:

     0           Successful operation.


     non-zero    An error has occurred (such as no such  process,
                 permission denied, or invalid option).


FILES
     /proc/pid/*    Process information and control files.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:












SunOS 5.11          Last change: 19 Jun 2006                    2






User Commands                                            pargs(1)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWesu                     
    
     Interface Stability          Evolving                    
    


SEE ALSO
     proc(1),  iconv(3C),   proc(4),   ascii(5),   attributes(5),
     environ(5), formats(5)











































SunOS 5.11          Last change: 19 Jun 2006                    3