unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

pargs(1)                         User Commands                        pargs(1)



NAME
       pargs  - print  process  arguments,  environment  variables,  or auxil-
       iary 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 aux-
       iliary 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  charac-
       ter encoding, pargs attempts to employ the iconv(3C) facility to gener-
       ate a printable version of the extracted  strings. In  the  event  that
       such a conversion is impossible, strings are displayed as 7-bit ASCII.

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 ASCII, regardless of the locale of  the  tar-
                get. The use of iconv(3C) is suppressed.



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



       -F       Force. Grabs the target process even if  another  process  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 unprintable characters, or
                if the target process is in a different locale, a warning mes-
                sage  is  displayed.  The  resulting  command  line may 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.



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.



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


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).   ATTRIBUTE  TYPEATTRIBUTE   VALUE   AvailabilitySUNWesu
       Interface StabilityEvolving


SEE ALSO
       proc(1),  iconv(3C), proc(4), ascii(5), attributes(5), environ(5), for-
       mats(5)



SunOS 5.10                        13 Apr 2004                         pargs(1)