Client Command (hchmod)

The hchmod command is a command to change permissions of files on the server. It is not supported on the Windows service.

Basic Format

The basic format is as follows.

Usage: hchmod [OPTION]... MODE[,MODE...] [USER@]HOST[:PORT]:FILE [:FILE]...
   or: hchmod [OPTION]... OCTAL-MODE [USER@]HOST[:PORT]:FILE [:FILE]...
   or: hchmod [OPTION]... --host=HOST [--port=PORT] [--user=USER] MODE[,MODE...] FILE...
   or: hchmod [OPTION]... --host=HOST [--port=PORT] [--user=USER] OCTAL-MODE FILE...

Option List

The options for the hcchmod commands are below.

Permission Change

Description	Short Name	Option Name
Change recursively	R	recursive
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 permission change		user
Specify a password first and permission 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

Permission Change

R, recursive

=========================================================================
Supported OS : Linux / Windows / Mac
Format : -R | --recursive
=========================================================================

Changes permissions traversing directories recursively.

--
Example:
[user@localhost ~]$ hchmod -R ...
--

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. It is used in the path specifying the file. With this parameter, the host name for this path can be omitted.

--
Example:
[user@localhost ~]$ hchmod --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. It is used in the path specifying the file.

--
Example:
[user@localhost ~]$ hchmod --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 permissions is set.

--
Example:
[user@localhost ~]$ hchmod --hcp-out=- ...
HOST 127.0.0.1:1874
OK 0000 CA 00000001 hcp_dst/file1.txt
EXIT 0 REASON 0000
[user@localhost ~]$
--

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

Software Information Update

V, version

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

The hchmod command version is shown.

--
Example:
[user@localhost ~]$ hchmod -V
hchmod client (hchmod) 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 hchmod command are output.

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

-- [Targets] ---------------------------------------------------------------
-- [Command Options] -------------------------------------------------------
 modes          : -
 recursive      : disable
 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 hchmod command help is shown.

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