Client Command (hchown)
The hchown command is a command to change owner or group of files on the server. The user ownership is specified by username and user ID, and the group ownership is by group name and group ID. It is not support on Windows service.
Basic Format#
The basic format is as follows.
Usage: hchown [OPTION]... OWNER[:[GROUP]] [USER@]HOST[:PORT]:FILE [:FILE]... or: hchown [OPTION]... --host=HOST [--port=PORT] [--user=USER] OWNER[:[GROUP]] FILE...Option List#
The options for the hchown commands are below.
Ownership Change
| Description | Short Name | Option Name |
|---|---|---|
| Disable the dereference of the symbolic link | d | no-dereference |
| Change recursively | R | recursive |
| Follow symbolic links to directories on command line | s | follow-cmd-link-dir |
| Follow all symbolic links | S | follow-all |
| No follow symbolic links | D | no-follow |
| Set the remote host | host | |
| Set the remote port | port |
Selectable Communication Method Function
| Description | Short Name | Option Name |
|---|---|---|
| The HpFP protocol | hpfp | |
| The WebSocket protocol(SSL/TLS) | wss | |
| The port-separation UDP(HpFP) protocol(deprecated) | udp | |
| The WebSocket protocol (plaintext communications) | ws | |
| Directly connect to the Proxy server when the WebSocket protocol | ws-proxy-direct | |
| Set the Proxy server when the WebSocket protocol | ws-proxy |
Congestion Control
| Description | Short Name | Option Name |
|---|---|---|
| Congestion control modes in the HpFP protocol | hpfp-cong |
Data Flow Control, Message Data Size Control
| Description | Short Name | Option Name |
|---|---|---|
| MSS(Maximum Segment Size) in the HpFP protocol | hpfp-mss |
Data Flow Control, Data Buffer Setting
| Description | Short Name | Option Name |
|---|---|---|
| Set the sending buffer size for the HpFP protocol | hpfp-sndbuf | |
| Set the receiving buffer size for the HpFP protocol | hpfp-rcvbuf |
Authentication
| Description | Short Name | Option Name |
|---|---|---|
| Server certificate checking is disabled in WebSocket protocol communications | wss-no-check-certificate | |
| Specify a username first and ownership change | user | |
| Specify a password first and ownership change | password |
Various Monitorings
| Description | Short Name | Option Name |
|---|---|---|
| Investigation mode starts (deprecated) | investigation |
Log Management
| Description | Short Name | Option Name |
|---|---|---|
| Specify an application log output destination | log-file | |
| Specify various statistics log output destinations | stat-log-file | |
| Specify an execution record output destination | hcp-out | |
| Start in the multiple-run mode | multi-run |
Software Information Update
| Description | Short Name | Option Name |
|---|---|---|
| Check the application version | V | version |
| Check the configuration and input parameters | config-test | |
| Display the command help | h | help |
System Operating Environment Settings
| Description | Short Name | Option Name |
|---|---|---|
| Setting form a path of the configuration file | config-file | |
| Make configuration from command line | config-option | |
| Setting by a relative path from the current directory | include-conf-from-cwd | |
| Server compatibility disabled | no-earlier-serv-compat |
Please refer to the hcpd command section on the following option.
--investigationPlease refer to the hcp command section on the following option.
--hpfp, --wss, --user, --password, --config-file, --config-option, --log-file, --stat-log-file, --udp, --ws, --wss-no-check-certificate, --ws-proxy-direct, --ws-proxy, --hpfp-cong, --hpfp-mss, --hpfp-sndbuf, --hpfp-rcvbuf, --multi-run, --include-conf-from-cwd, --no-earlier-serv-compatOwnership Change#
d, no-dereference#
=========================================================================Supported OS : Linux / WindowsFormat : -d | --no-dereference=========================================================================Change owner or group of files without resolving symblic links. Changes will be applied to symbolic links.
--Example:[user@localhost ~]$ hchown -d ...--R, recursive#
=========================================================================Supported OS : Linux / WindowsFormat : -R | --recursive=========================================================================Changes owner or group of files traversing directories recursively.
Ownerships and groups of all subdirectories under the specified directory will be changed.
--Example:[user@localhost ~]$ hchown -R ...--s, follow-cmd-link-dir#
=========================================================================Supported OS : Linux / WindowsFormat : -s | --follow-cmd-link-dir=========================================================================When symbolic links to directories are specified on the command line, change owner or group of files following the links.
--Example:[user@localhost ~]$ hchown -s ...--S, follow-all#
=========================================================================Supported OS : Linux / WindowsFormat : -S | --follow-all=========================================================================Change owner or group of files following all symbolic links to directories.
--Example:[user@localhost ~]$ hchown -S ...--D, no-follow#
=========================================================================Supported OS : Linux / WindowsFormat : -D | --no-follow=========================================================================Change owner or group of files without following symbolic links to directories.
--Example:[user@localhost ~]$ hchown -D ...--host#
=========================================================================Supported OS : Linux / WindowsFormat : --host=<remote-host>-------------------------------------------------------------------------remote-hostDefault : noneRange of Values : IP address or host name=========================================================================The remote host in the destination is specified. This option is applied to a link target or link name, or a path to specify a directory. With this parameter, the host name for this path can be omitted.
--Example:[user@localhost ~]$ hchown --remote-host=192.168.100.100 ...--port#
=========================================================================Supported OS : Linux / WindowsFormat : --port=<remote-port>-------------------------------------------------------------------------remote-portDefault : noneRange of Values : port number=========================================================================The service port number for the remote host in the destination is specified. This option is applied to a link target or link name, or a path to specify a directory.
--Example:[user@localhost ~]$ hchown --remote-port=1874 ...--Log Management#
hcp-out#
=========================================================================Supported OS : Linux / WindowsFormat : --hcp-out=<output-path>-------------------------------------------------------------------------output-pathDefault : noneRange of Values : path string of file system=========================================================================The file to output the execution record of changing owner or group is set.
--Example:[user@localhost ~]$ hchown --hcp-out=- ...TODOEXIT 0 REASON 0000[user@localhost ~]$ --
--Example:[user@localhost ~]$ hchown --hcp-out=- ...--Software Information Update#
V, version#
=========================================================================Supported OS : Linux / WindowsFormat : -V | --version=========================================================================The hchown command version is shown.
--Example:[user@localhost ~]$ hchown -Vhchown client (hchown) 1.3.4_3 / Linux (HpFP2 2.0.0.91_21 WSAPI 0.0.1.30 WS 4.2.0-1)--config-test#
=========================================================================Supported OS : Linux / WindowsFormat : --config-test=========================================================================The parameters and the configuration information for the hchown command are output.
--Example:[user@localhost ~]$ hchown --config-test...
Number of Logical Processors : 2Number of Physical Processors : 2
Command parameters no-dereference : disable recursive : disable follow-cmd-link-dir : disable follow-all : disable no-follow : enable host : disable port : disable user : disable password : disable version : disable help : disable
Configuration parameters PubkeyAuthentication : yes WinLogonUserAuthentication : yes PAMAuthentication : yes LocalPasswordAuthentication : yes CompressLevel : -1 StrictHostKeyChecking : ask PrivateKeyFile : - [~/.hcp/id_rsa] TransportTimeout : 180 AcceptableCryptMethod : AES256/GCM AES256/CTR/VMAC AES256/CBC AES128/CBC [Intel:AES-NI=yes] AcceptableDigestMethod : XXH3 MM128 SHA256 SHA160
Please type '--config-test --config-test ...' for more details.--h, help#
=========================================================================Supported OS : Linux / WindowsFormat : -h | --help=========================================================================The hchown command help is shown.
--Example:[user@localhost ~]$ hchown -h--