sysinf

display technical system information 

Command


SYNOPSIS

sysinf [-D] keyword [options]


DESCRIPTION

sysinf displays technical system information on the standard output. The information returned by sysinf is the result of standard Win32 system calls. Many of the calls return information which is described by various bit masks; in this case they are displayed using the manifest name of the bitmask as defined in the Win32 SDK documentation. Most information is displayed in tab-delimited columns suitable for use in system administration and configuration shell scripts. The domains, networks, printers, servers, and disks commands display the following six columns of information:

column 1	Resource Type (disk, printer)
column 2	Display Type (server, share point, file, group, etc.)
column 3	Resource Usage (connectable, container, sibling)
column 4	Remote Name
column 5	Comment
column 6	Network Provider (network type or name)

If you specify sysinf on the command line without a keyword, a list of all keywords and their options is displayed on standard error.

Options

-D

displays everything that is found while the network is being enumerated.

This option, when specified, must be the first argument on the command, preceding any keywords and their arguments.

When evaluating why sysinf is taking long time to run on your network, you can specify the -D option and see how many machines are on your network and which ones are taking the longest to contact.

Keywords

sysinf accepts the following keywords:

codepages [-a] [-c

displays all code pages currently installed on your system. When you specify the -a option, sysinf codepages displays a list of all code pages currently supported by Windows. When you specify the -c option, sysinf codepages displays the current code page; code pages are not enumerated and the -a is ignored.

dc [-c computer] domain_name ... 

displays the name of the computer which is the domain controller for each specified domain_name. If you do not specify a domain_name, sysinf dc displays the primary domain controller for your current domain. The -c computer option specifies on which computer to look for the domain controller.

desktops [-a

displays information about the desktops currently in use on your system. If you specify the -a option, sysinf desktops includes information on unknown window types for each desktop. If you specify both the -a and -h options, desktops also returns complete information on hwnd for all desktops. See windows -ah for column descriptions.

disks [-a

displays the names of all network shared disks on your current system. If you specify the -a option, sysinf prints extended information on all shared network disks.

drives [-a] [drive_root ...] 

displays a list of all mapped drive letters. If you specify the -a option, sysinf drives also displays file system bit masks, file system type, maximum component length, and the UNC name of the file system, as per the GetVolumeInformation system call.

If you specify one or more drive_root arguments, sysinf drives only displays information on the drives with those drive-roots. drive_root can be either a drive root path (for example, c:/) or a UNC name (for example, \\\\centi.mks.com\\rd\\).

Note:

Because of the way the underlying system call works, UNC names must end in a backslash while drive root path names must end in either a slash or a backslash.

domains [-a

displays a list of all domains on your current system. If you specify the -a option, domains displays extended information on each domain.

file filename ... 

displays raw information about each specified filename.

info [-v

displays information from the GetSystemInfo system call. If you specify the -v option, info displays the information with the following descriptive tags:

Product Name
Host Hardware
Oem ID
Page Size
Minimum Application Address
Maximum Application Address
Active Processor Mask
Number of Processors
Hyperthreading
Number of Physical Processors
Processor Type
Allocation Granularity
Processor Name
Processor Level
Processor Revision
Processor Feature

If you do not specify the -v option, info displays a single line consisting of the above information in tab-delimited columns.

locales [-a

displays a list of all installed locales. If you specify the -a option, sysinf locales displays a list of all supported system locales.

keyboard 

displays the keyboard layout list.

lookup [-v] [-c computer] [name...] 

displays the SID which corresponds to each specified name. name can be the name of either a user or a group. The -v option displays additional information. The -c computer option specifies on which computer to look for the corresponding SID.

metrics [metric...] 

displays information on system metrics using the GetSystemMetrics system call. The metric name takes the form SM_XXX; for example SM_CLEANBOOT returns 0 if you booted normally, and non-zero on a failsafe boot. If you do not specify a metric name or names, sysinf metrics displays all current system metrics in a tab delimited list.

memory [-v

displays information from the GlobalMemoryStatus system call. If you specify the -v option, memory displays the information with the following descriptive tags:

Memory Load
Total Physical Memory
Available Physical Memory
Total Page File bytes
Available Page File bytes
Total Virtual bytes
Available Virtual bytes
networks [-a

displays a list of all top level networks currently on your system. If you specify the -a option, sysinf networks displays extended information on your system networks.

performance [item...] 

when no item is specified, displays performance information about your system. This information is broken down into a series of items, each identified with a item number. By specifying one or more of these item numbers, only information about those areas is displayed.

printers [-a

displays a list of all currently installed network printers. If you specify the -a option, sysinf printers displays extended information on your network printers.

servers [-a

displays a list of all servers currently on your network. If you specify the -a option, sysinf servers displays extended information.

sid [-v] [-c computer] [name...] 

asks the computer specified by the -c computer option for the SID corresponding to each specified name and displays it. name can be the name of either a user or a group. If you do not specify -c, sysinf sid asks an arbitrary computer for the information. The -v option displays additional information.

timezone 

displays the current timezone information.

tokens 

displays information on the Privileges, Groups, User, Primary Group, Owner, Source, and Default DACL for the token held by the current process (sysinf itself). Since tokens are seldom changed, this is normally the same token as is held by all your processes.

volumes [-a] [root_directory...] 

displays a list of all mounted volumes. If you specify the -a option, sysinf volumes also displays file system bit masks, file system type, maximum component length, and the UNC name of the file system, as per the GetVolumeInformation system call.

windows [-ah

displays information about the windows currently in use on your system. If you specify the -a option, sysinf windows includes information on unknown window types. If you specify the -h option, windows also returns information on hwnd.

The output of sysinf windows -ah appears in five columns:

column 1	hwnd
column 2	Thread identifier that created the window
column 3	Process ID of the process that created the window
column 4	Window class name
column 4	Window title
windowstations [-ah

displays information about the windowstations currently in use on your system. If you specify the -a option, sysinf windowstations includes information on unknown windowstation types. If you specify the -h option, windowstations also returns information on hwnd.


EXAMPLES

The following command searches for a file on all drives currently mounted on your system:

find $(sysinf drives | sed 's/$/:\//') -name file

Note:

This example uses the sed command to append :/ to each of the drive letters returned by sysinf drives to create the syntax required for the find command.


DIAGNOSTICS

Possible exit status values are:

0 

Successful completion.

>0 

An error occurred.


PORTABILITY

Windows 8.1. Windows Server 2012 R2. Windows 10. Windows Server 2016. Windows Server 2019. Windows 11. Windows Server 2022.

Note:

On Windows systems with up-to-date service packs, the default behavior is to not let its resources be enumerated.


AVAILABILITY

PTC MKS Toolkit for Power Users
PTC MKS Toolkit for System Administrators
PTC MKS Toolkit for Developers
PTC MKS Toolkit for Interoperability
PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition


PTC MKS Toolkit 10.4 Documentation Build 39.