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 diagnostic log output destination		hcp-diag
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
Show configuration option's names		show-config-options
Setting by a relative path from the current directory		include-conf-from-cwd
Server compatibility disabled		no-earlier-serv-compat

Check System Information

Description	Short Name	Option Name
Show system info		system-info
Run host benchmark		run-host-benchmark
Specify measurement categories on the benchmark		run-host-benchmark-categories

Please refer to the hcpd command section on the following option.

--investigation

Please refer to the hcp command section on the following option.

--hpfp, --wss, --user, --password, --config-file, --config-option, --show-config-options, --system-info, --run-host-benchmark, --run-host-benchmark-categories, --hcp-diag, --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-compat, --no-agent, --ident-select

Ownership Change

d, no-dereference

=========================================================================
Supported OS : Linux / Windows / Mac
Format : -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 / Windows / Mac
Format : -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 / Windows / Mac
Format : -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 / Windows / Mac
Format : -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 / Windows / Mac
Format : -D | --no-follow
=========================================================================

Change owner or group of files without following symbolic links to directories.

--
Example:
[user@localhost ~]$ hchown -D ...
--

host

=========================================================================
Supported OS : Linux / Windows / Mac
Format : --host=<remote-host>
-------------------------------------------------------------------------
remote-host
Default : none
Range 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 / Windows / Mac
Format : --port=<remote-port>
-------------------------------------------------------------------------
remote-port
Default : none
Range 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 / Windows / Mac
Format : --hcp-out=<output-path>
-------------------------------------------------------------------------
output-path
Default : none
Range 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=- ...
TODO
EXIT 0 REASON 0000
[user@localhost ~]$ 
--

--
Example:
[user@localhost ~]$ hchown --hcp-out=- ...
--

Software Information Update

V, version

=========================================================================
Supported OS : Linux / Windows / Mac
Format : -V | --version
=========================================================================

The hchown command version is shown.

--
Example:
[user@localhost ~]$ hchown -V
hchown client (hchown) 1.5.8_1 / Linux (HpFP2 2.0.0.91_26 WSAPI 0.0.1.36 WS 4.2.0-2)
--

config-test

=========================================================================
Supported OS : Linux / Windows / Mac
Format : --config-test
=========================================================================

The parameters and the configuration information for the hchown command are output.

--
Example:
[user@localhost ~]$ hchown --config-test
...

-- [Targets] ---------------------------------------------------------------
-- [Command Options] -------------------------------------------------------
 owner          : -
 group          : -
 no-dereference : disable
 recursive      : disable
 follow-cmd-link-dir : disable
 follow-all     : disable
 no-follow      : enable
 host           : -
 port           : -
 user           : -
 password       : -
 version        : disable
 help           : disable
-- [Configuration Parameters] ----------------------------------------------
 PubkeyAuthentication             : yes
 WinLogonUserAuthentication       : yes
 PAMAuthentication                : yes
 LocalPasswordAuthentication      : yes
 NumberOfPasswordPrompts          : 3
 CompressLevel                    : -1
 StrictHostKeyChecking            : ask
 IdentityFile                     : - [~/.ssh/id_rsa ~/.ssh/id_ecdsa ~/.ssh/id_ed25519 ~/.hcp/id_rsa ~/.hcp/id_ecdsa ~/.hcp/id_ed25519]
 MaxReceiveRate                   : 100000000000
 MaxSendRate                      : 100000000000
 MaxConnectionReceiveRate         : 100000000000
 MaxConnectionSendRate            : 100000000000
 TransportTimeout                 : 180 sec
 AcceptableCryptMethod            : AES256/GCM AES256/CTR/VMAC AES256/CBC AES128/CBC [Intel:AES-NI=yes]
 AcceptableDigestMethod           : XXH3 SHA256 SHA160
-- [Environment Variables] -------------------------------------------------
USER          : user
LOGNAME       : user
HCP_PASSWORD  : 
HCP_WS_PROXY  : 
----------------------------------------------------------------------------

Please type '--config-test --config-test ...' for more details.
--

h, help

=========================================================================
Supported OS : Linux / Windows / Mac
Format : -h | --help
=========================================================================

The hchown command help is shown.

--
Example:
[user@localhost ~]$ hchown -h
--

Client Command (hchown)

Basic Format​

Option List​

Ownership Change​

d, no-dereference​

R, recursive​

s, follow-cmd-link-dir​

S, follow-all​

D, no-follow​

host​

port​

Log Management​

hcp-out​

Software Information Update​

V, version​

config-test​

h, help​

Basic Format

Option List

Ownership Change

d, no-dereference

R, recursive

s, follow-cmd-link-dir

S, follow-all

D, no-follow

host

port

Log Management

hcp-out

Software Information Update

V, version

config-test

h, help