HTTP Namespace Reservation (HttpReserve.exe)

Microsoft Robotics

Glossary Item Box

DSS User Guide: DSS Node Security Model

Microsoft Robotics Developer StudioSend feedback on this topic

HTTP Namespace Reservation (HttpReserve.exe)

The HTTP Namespace Reservation tool reserves one or more HTTP namespaces for the kernel-level HTTP listener (http.sys). Namespace reservations enable processes running under a non-administrator account to listen using the HTTP listener which is a prerequisite for running a DSS node. Administrative users do not have to reserve a namespace. In order to run a DSS node using a non-administrative account, you must first reserve the namespace.

httpreserve.exe [options]

Parameters

Option Short Name Description

/Domain:<string>

/d

The user domain.

/Extend[+|-]

/e

Extend an existing port reservation.

/Force[+|-]

/f

Force reservation, override existing port reservations.

/Port:<int>

/p

The port number to reserve. Required.

/Prefix:<string>

/x

Use the supplied prefix.

/Query[+|-]

/q

Query existing reservation.

/Remove[+|-]

/r

Remove reservation, delete a port reservation.

/User:<string>

/u

The user to reserve the port for. Required.

@<file>

Name of a text file containing arguments. Multiple arguments per line are allowed. An unquoted hash (#) comments out the remainder of a line. An argument file is processed by removing comments, leading and trailing spaces and tabs, processing quotation marks and escape sequences, and then processing the arguments as if they were on the command line.

Examples

The following example creates a namespace reservation on HTTP port 50000 which enables a local, non-administrative account named MSRS_TEST to run a DSS node on port 50000:

httpreserve /port:50000 /user:msrs_test
      

Namespace reservations are persisted and are only necessary once for a given port and user or group. They can be removed by running the tool using with the /remove parameter as illustrated in the following example:

httpreserve /port:50000 /remove+
      

DSS User Guide: DSS Node Security Model

 

 

© 2012 Microsoft Corporation. All Rights Reserved.

Show: