ShowProc/ShowProc.help at main · deeveon/ShowProc · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
    NAME
        ShowProc - Lists information about tasks and processes.

    FORMAT
        ShowProc [VERSION] [ALL|SYSTEM|CLI] [FULL|TCB|SHORT]
                 [[PROCESS] <process #>] [COMMAND <command>|<pattern>]

    TEMPLATE
        VER=VERSION/S,ALL/S,SYS=SYSTEM/S,CLI=SHELL/S,F=FULL/S,TCB/S,
        S=SHORT/S,PROCESS/N,COM=COMMAND/K

    PATH
        C:ShowProc

    FUNCTION
        ShowProc lists currently running tasks and processes along with
        various details about each one. It is intended to be an improvement
        over the AmigaOS STATUS command.

        ShowProc outputs information in an easy-to-read table view. It shows
        additional information (compared to STATUS) such as, for example, how
        much stack a task/process is using. It also allows you to use standard
        AmigaOS wildcards when searching for a Shell/CLI process.

        ShowProc defaults to showing detailed information about all tasks
        and processes. Running ShowProc with the CLI and SHORT options will
        make it most resemble the default view of the AmigaOS STATUS command.

            1> ShowProc CLI SHORT

    OPTIONS
        The following options are provided to control what ShowProc
        outputs to the console. If multiple output formats are provided,
        ShowProc will use the most verbose one, with the exception of the
        COMMAND option which overrides all others.

            COMMAND > FULL > TCB > SHORT

        Similarly, if multiple process lists are provided, ShowProc will use
        the most inclusive one.

            ALL > SYSTEM > CLI

        VERSION or VER
            Outputs the program name, revision and revision date, then exits.

        ALL
            Outputs both SYSTEM and CLI information as separate tables.

        SYSTEM or SYS (default)
            Outputs information about all tasks and processes.

        CLI or SHELL
            Outputs information about Shell/CLI processes.

            This view shows additional Shell/CLI specific information such
            as the current FAILAT level, last return code and if it is
            running in the background.

        FULL or F (default)
            Outputs detailed information about each task or process.

        TCB
            Outputs the same information as FULL except it omits the
            task/process name.

        SHORT or S
            Outputs only the process number and task/process name (if any).

        PROCESS <process #>
            If a <process #> number (1-999) is provided, ShowProc will
            show information about only that process. A process number
            can be provided with or without the PROCESS keyword.

        COMMAND or COM <command>|<pattern>
            You can search for a process using a command name or wildcard
            pattern. If found, the Shell/CLI number is output and the
            program return code is set to 0 (SUCCESS). If all processes
            have been searched and a match hasn't been found, the return
            code is set to 5 (WARN). Otherwise, the return code will be
            set to 20 (FAIL).

    EXAMPLES
        1) Show detailed information about all tasks and processes.

           1> ShowProc
                                                   CLI        Stack  Stack
            Num Task/Process Name          Pri T/P Num State   Used   Size
            --- ------------------------- ---- --- --- ----- ------ ------
              1 ShowProc                     1  P    4   Run    766   3968
              2 VirusZ_III                   0  P      Ready    426   8192
              3 Picasso96                    0  P       Wait    234   4000
              4 datatypes.library            0  P       Wait    178   4000
              5 RexxMaster                   4  P       Wait    170   2048
              6 « ConClip »                  0  P       Wait    210   3000
              7 Workbench                    1  P    2  Wait    190   8000
              ...

        2) Show detailed information about a single Shell/CLI process.

           1> ShowProc 4
                                               Stack  Stack Fail
            Num Command Name         Pri   GV   Used   Size  Lvl   RC   BG
            --- -------------------- --- ---- ------ ------ ---- ---- ----
              4 ShowProc               0  150    822   3968   10    0   No

        3) Show only the process number and command name for all processes.

           1> ShowProc SHORT

            Num Task/Process Name
            --- -------------------------
              1 ShowProc
              2 VirusZ_III
              3 Picasso96
              4 datatypes.library
              5 RexxMaster
              6 « ConClip »
              7 Workbench
              ...

        4) Send a BREAK to the Shell/CLI process executing the COPY command.

           1> ShowProc >RAM:xyz COMMAND=COPY
           1> BREAK <RAM:xyz >NIL: ?

    SEE ALSO
        STATUS, BREAK, ALIAS