The list function

The list function is a registry file search mechanism.

The arguments to the list function are user, path, name, and type, and must be entered in that order.
fileregedit [-f reg_file] list [user [path [name [type]]]]
The square brackets [] enclose an optional set of arguments. Everything within the brackets must be entered as a set of data.
  • If the -f switch is specified, the reg_file specification is required.
  • When the brackets are nested, there is a dependence on the existence of the arguments, and the arguments must be entered in the order shown in the syntax above.
  • If path is specified, then user must be specified.
  • If name is specified, then user and path, must be specified.
  • If type is specified, then user, path, and name must be specified.
fileregedit list phoebe "" "" "string value"
  • Any key specified by path is created if it does not already exist.
  • If a non-required argument is not specified, the default is any (value). For example the following command finds all keys and/or values owned by the user phoebe, regardless of their path, name or type (key, string value, dword value, or binary value)

fileregedit list phoebe

The output of the list function is a pipe-separated list of items, one line per item.

For example, to show all keys and values owned by the user phoebe, enter:

fileregedit list phoebe

Sample resulting output:

4 items found

|USER|CLASS|TYPE|PATH|NAME|SIZE|VALUE|

|phoebe|KEY|KEY|/|XyEnterprise|0||

|phoebe|KEY|KEY|/XyEnterprise|Software|0||

|phoebe|KEY|KEY|/XyEnterprise/Software|Web|0||

|phoebe|VALUE|STRING|/XyEnterprise/Software/Web|Preference|6|abced|

#

OutputDescription
4 items foundThe number of keys and/or values found by the search.
|USER|CLASS|TYPE|PATH|NAME|SIZE|VALUE|
These are the field labels for output that follows.

|phoebe|KEY|KEY|/|XyEnterprise|0||

|phoebe|KEY|KEY|/XyEnterprise|Software|0||

|phoebe|KEY|KEY|/XyEnterprise/Software|Web|0||

|phoebe|VALUE|STRING|/XyEnterprise/Software/Web|Preference|6|abced|

This is the list of the items that were found.

The size column indicates the number of bytes required to store the data associated with a value.

Keys are always 0 bytes, because they have no value data.