proc(4)                                                         proc(4)

  proc

  NAME

    proc - process virtual file system

  SYNOPSIS

    /proc/*

  DESCRIPTION

    The /proc file system provides access to the states of the processes in
    the Interix subsystem.

  Directory structure

    The /proc directory contains a subdirectory for each running process and
    light-weight process (LWP) in the system; the name of the subdirectory is
    the process identifier (ID) number. Each process directory contains files
    that describe the state of the process. Access to the files is restricted
    to the owner or to a user with appropriate privileges. These files are as
    follows:

    as
        Address space. This is a read/write file.

    cmdline
        The command line that invoked the process. Each argument is terminated
        by a nul.

    ctl
        Control file. This control file is write-only. The following control
        messages are defined in :

        PCSTOP
            Stop process cold.

        PCRUN
            Resume a stopped process.

        PCWSTOP
            Block until traced process stops on event of interest.

        PCSTRACE
            Set signal trace bits.

        PCSFAULT
            Set fault trace bits.

        PCSENTRY
            Set sysentry trace bits.

        PCSEXIT
            Set sysexit trace bits.

        PCCFAULT
            Clear current fault (if stopped on fault).

        PCSREG
            Set general registers.

        PCSFPREG
            Set floating point registers.

    environ
        The environment of the process.

    map
        Read-only map of the virtual memory address space.

    psinfo
        Contains miscellaneous information about the process and the
        representative light-weight process (LWP) needed by the ps(1) command.
        The psinfo process file is accessible after a process becomes a
        zombie. The file contains a psinfo structure (as defined in ) that contains an embedded lwpsinfo structure for the
        representative LWP.

    stat
        Human readable read-only status information. For example:
        argv0   /bin/ksh
        pid     1923
        ppid    1
        pgid    1923
        ruser   1123834 100000125fa
        user    1123834 100000125fa
        rgroup  1049089 100000201
        group   1049089 100000201
        utime   31
        stime   375
        cutime  2828
        cstime  1343
        tty     ttyn01
        state   3
        flags   22
        etime   8888366
        vsize   16429056
        wsize   2170880
        sid     1923
        inpsx   1
        natpid  1568
        natsid  0
        nice    2
        wchan   0
        sttime  1054884358
        openfdcount     4

    status
        Binary status information. It corresponds to the System V r4.2 status
        file, and consists of a pstatus_t structure as defined in . It is used by gdb(1).

    lwp
        A directory containing one subdirectory for each thread in the
        process. The name of the thread directory is the thread identifier
        (LWPID).
        A directory in /proc/pid/lwp/lwpid contains the following entries:

        lwpctl
            Write-only control file. The messages written to this file affect
            the specific LWP rather than the representative LWP, as is the
            case for the process's ctl file.

        lwpstatus
            LWP-specific state information. This file contains the lwpstatus_t
            structure as defined in  and is used by gdb(1). It
            can contain the following messages:

            PCSTOP
                Stop thread cold.

            PCRUN
                Resume a stopped thread.

            PCWSTOP
                Block until traced thread stops on event of interest.
        The lwpctl and lwpstatus files are the same as the ctl and status
        files for a process, but their scope is limited to a particular
        thread.

  NOTE

    The format of the contents of the proc directory as found in the current
    release as well as any structures defined in procfs.h and ucontext.h are
    not guaranteed to be valid in future releases.

  SEE ALSO

    ps(1)

    truss(1)