GDBMI_info_os.st
changeset 12 568a2971c977
child 78 c24e7d8bc881
equal deleted inserted replaced
11:474fbb650afe 12:568a2971c977
       
     1 "{ Package: 'jv:libgdbs' }"
       
     2 
       
     3 GDBMICommand subclass:#GDBMI_info_os
       
     4 	instanceVariableNames:''
       
     5 	classVariableNames:''
       
     6 	poolDictionaries:''
       
     7 	category:'GDB-Core-Commands-MI'
       
     8 !
       
     9 
       
    10 !GDBMI_info_os class methodsFor:'documentation'!
       
    11 
       
    12 documentation
       
    13 "
       
    14 The `-info-os' Command
       
    15 ----------------------
       
    16 
       
    17 Synopsis
       
    18 ........
       
    19 
       
    20      -info-os [ TYPE ]
       
    21 
       
    22    If no argument is supplied, the command returns a table of available
       
    23 operating-system-specific information types.  If one of these types is
       
    24 supplied as an argument TYPE, then the command returns a table of data
       
    25 of that type.
       
    26 
       
    27    The types of information available depend on the target operating
       
    28 system.
       
    29 
       
    30 {No value for `GDBN'} Command
       
    31 .............................
       
    32 
       
    33 The corresponding {No value for `GDBN'} command is `info os'.
       
    34 
       
    35 Example
       
    36 .......
       
    37 
       
    38 When run on a GNU/Linux system, the output will look something like
       
    39 this:
       
    40 
       
    41      {No value for `GDBP'}
       
    42      -info-os
       
    43      ^done,OSDataTable={nr_rows='9',nr_cols='3',
       
    44      hdr=[{width='10',alignment='-1',col_name='col0',colhdr='Type'},
       
    45           {width='10',alignment='-1',col_name='col1',colhdr='Description'},
       
    46           {width='10',alignment='-1',col_name='col2',colhdr='Title'}],
       
    47      body=[item={col0='processes',col1='Listing of all processes',
       
    48                  col2='Processes'},
       
    49            item={col0='procgroups',col1='Listing of all process groups',
       
    50                  col2='Process groups'},
       
    51            item={col0='threads',col1='Listing of all threads',
       
    52                  col2='Threads'},
       
    53            item={col0='files',col1='Listing of all file descriptors',
       
    54                  col2='File descriptors'},
       
    55            item={col0='sockets',col1='Listing of all internet-domain sockets',
       
    56                  col2='Sockets'},
       
    57            item={col0='shm',col1='Listing of all shared-memory regions',
       
    58                  col2='Shared-memory regions'},
       
    59            item={col0='semaphores',col1='Listing of all semaphores',
       
    60                  col2='Semaphores'},
       
    61            item={col0='msg',col1='Listing of all message queues',
       
    62                  col2='Message queues'},
       
    63            item={col0='modules',col1='Listing of all loaded kernel modules',
       
    64                  col2='Kernel modules'}]}
       
    65      {No value for `GDBP'}
       
    66      -info-os processes
       
    67      ^done,OSDataTable={nr_rows='190',nr_cols='4',
       
    68      hdr=[{width='10',alignment='-1',col_name='col0',colhdr='pid'},
       
    69           {width='10',alignment='-1',col_name='col1',colhdr='user'},
       
    70           {width='10',alignment='-1',col_name='col2',colhdr='command'},
       
    71           {width='10',alignment='-1',col_name='col3',colhdr='cores'}],
       
    72      body=[item={col0='1',col1='root',col2='/sbin/init',col3='0'},
       
    73            item={col0='2',col1='root',col2='[kthreadd]',col3='1'},
       
    74            item={col0='3',col1='root',col2='[ksoftirqd/0]',col3='0'},
       
    75            ...
       
    76            item={col0='26446',col1='stan',col2='bash',col3='0'},
       
    77            item={col0='28152',col1='stan',col2='bash',col3='1'}]}
       
    78      (gdb)
       
    79 
       
    80    (Note that the MI output here includes a `'Title'' column that does
       
    81 not appear in command-line `info os'; this column is useful for MI
       
    82 clients that want to enumerate the types of data, such as in a popup
       
    83 menu, but is needless clutter on the command line, and `info os' omits
       
    84 it.)
       
    85 
       
    86 
       
    87 "
       
    88 ! !
       
    89 
       
    90 !GDBMI_info_os methodsFor:'accessing'!
       
    91 
       
    92 operation
       
    93 	^ 'info-os'
       
    94 ! !
       
    95