psxoffset

NAME

psxoffset - list or set POSIX domain offsets

SYNOPSIS

psxoffset [-v] -list
psxoffset [-v] -set DomainName psxOffset_in_hex
psxoffset [-v] -uid 64bit_uid_in_hex
psxoffset [-v] -sid sid
psxoffset [-v] -name username

DESCRIPTION

The psxoffset utility is used to distribute space between POSIX offset values or to ensure that POSIX offset values are the same in trusted domains. This is sometimes required in networks containing a very large number of domains that have a very large number of users and groups.

The psxoffset utility supports the following options:

-v

Prefaces the output with the name of the computer on which the utility was run.

-list

Lists the current POSIX offset values of domains trusted by the principal domain.

-set DomainName psxOffset_in_hex

Sets psxOffset_in_hex as the POSIX offset of the domain identified by DomainName. The psxOffset_in_hex argument must be an eight-digit hexadecimal value (for example, 0xe0000000). This option can only be used on a domain controller by a user logged on with the appropriate privileges. After this option is used, all computers running the Interix subsystem in the domain must be restarted to ensure that they are using the correct offset values.

-uid 64bit_uid_in_hex

Displays the full name of the user or group identified by 64bit_uid_in_hex, a 64-bit hexadecimal value. This value must identify domain user or group (rather than a built-in or local user or group), and is typically obtained from an Event Viewer log entry.

-sid sid

Prints the full name of the user or group identified by the Windows security identifier (SID) specified by sid.

-name username

Prints the SID of the user or group identified by username, specified in the form [domain+]name. Specify the name of the domain if it is not the name of the principal domain.

DIAGNOSTICS

The psxoffset utility can return one of the following values:

0

Success.

1

An error occurred.

NOTE

The psxoffset binary can be run on Windows computers without the Interix subsystem. To do so, create a copy of the psxoffset named Psxoffset.exe on the computer you want to run it on.