Skip to main content

クライアントコマンド（hcp-ls）

hcp-lsコマンドは、リモート（サーバ、hcpdサーバ）上のファイル一覧を取得するコマンドです。

基本書式​

Usage: hcp-ls [OPTION]... [USER@]HOST[:PORT][:FILE] [:FILE]...
   or: hcp-ls [OPTION]... --host=HOST [--port=PORT] [--user=USER] [FILE]...

オプション一覧​

hcp-lsコマンドのオプションは以下の通りです。

ファイル一覧取得

説明短縮名オプション名
実行するリストコマンド（ls/dir）問い合わせqquery-cmdname
リストコマンドのオプション指定ocmd-options
接続先リモートホストの指定host
接続先リモートホストのサービスポート指定port

通信方式選択機能

説明短縮名オプション名
HpFPプロトコルの使用hpfp
WebSocketプロトコル(SSL/TLS)の使用wss
ポート分離型UDP (HpFP)プロトコルの使用（廃止予定）udp
WebSocketプロトコル（平文通信）の使用ws
プロキシ直接接続指定(WebSocketプロトコル使用時)ws-proxy-direct
プロキシサーバの指定(WebSocketプロトコル使用時)ws-proxy

輻輳制御

説明短縮名オプション名
輻輳制御モードの指定（HpFPプロトコル使用時）hpfp-cong

データフロー制御・通信メッセージサイズ制御

説明短縮名オプション名
MSS(Maximum Segment Size)の指定（HpFPプロトコル使用時）hpfp-mss

データフロー制御・データバッファ設定

説明短縮名オプション名
送信バッファサイズの指定（HpFPプロトコル使用時）hpfp-sndbuf
受信バッファサイズの指定（HpFPプロトコル使用時）hpfp-rcvbuf

認証

説明短縮名オプション名
鍵エージェント無効化no-agent
秘密鍵選択ident-select
サーバ証明書の検証無効化（WebSocket(SSL/TLS)通信時）wss-no-check-certificate
ユーザ名を先に指定してファイル一覧取得user
パスワードを先に指定してファイル一覧取得password

各種監視機能

説明短縮名オプション名
調査モード起動（廃止予定）investigation

ログ管理機能

説明短縮名オプション名
アプリケーション診断ログの出力先指定hcp-diag
各種統計ログの出力先指定stat-log-file
実行記録の出力先指定hcp-out
多重起動モードで起動multi-run

ソフトウェアの情報確認

説明短縮名オプション名
バージョン確認Vversion
入力パラメータ及び設定情報確認config-test
コマンドヘルプの表示hhelp

システム動作環境設定

説明短縮名オプション名
設定ファイルのパス指定config-file
設定項目上書き指定config-option
使用可能な設定項目の表示show-config-options
実行ディレクトリからの相対パスでIncludeinclude-conf-from-cwd
サーバ互換対応無効化no-earlier-serv-compat

システムの情報確認

説明短縮名オプション名
システム情報表示system-info
システム性能確認run-host-benchmark
システム性能確認カテゴリ指定run-host-benchmark-categories

次のオプションはhcpdコマンドの説明をご参照ください。

--investigation

次のオプションはhcpコマンドの説明をご参照ください。

--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

ファイル一覧取得​

q, query-cmdname​

=========================================================================
対応OS : Linux / Windows / Mac
書式 : -q | --query-cmdname
=========================================================================

サーバ上で実行されるリストコマンドの名前を問合せます。以下の何れかが表示されます。

  • ls (Linux)
  • dir (Windows)
--
例：
[user@localhost ~]$ hcp-ls -q ...
--

o, cmd-options​

=========================================================================
対応OS : Linux / Windows / Mac
書式 : -o <options> | --cmd-options=<options>
-------------------------------------------------------------------------
options
既定値 : なし
値の範囲 : ls もしくは dirコマンドの引数オプション
=========================================================================

コマンドのオプションを指定します。空白もしくはハイフン"-"を含む場合は、クオートします。

--
例：
[user@localhost ~]$ hcp-ls -o "-al" ...
--

host​

=========================================================================
対応OS : Linux / Windows / Mac
書式 : --host=<remote-host>
-------------------------------------------------------------------------
remote-host
既定値 : なし
値の範囲 : IPアドレス もしくは ホスト名
=========================================================================

接続先のリモートホストを指定します。リスト対象を指定するパスに適用されます。このパラメータを指定した場合、このパスのホスト名を省略することができます。

--
例：
[user@localhost ~]$ hcp-ls --host=192.168.100.100 ...
--

port​

=========================================================================
対応OS : Linux / Windows / Mac
書式 : --port=<remote-port>
-------------------------------------------------------------------------
remote-port
既定値 : なし
値の範囲 : ポート番号
=========================================================================

接続先のリモートホストのサービスポート番号を指定します。リスト対象を指定するパスに適用されます。

--
例：
[user@localhost ~]$ hcp-ls --port=1874 ...
--

ログ管理機能​

hcp-out​

=========================================================================
対応OS : Linux / Windows / Mac
書式 : --hcp-out=<output-path>
-------------------------------------------------------------------------
output-path
既定値 : なし
値の範囲 : ファイルシステムのパス文字列
=========================================================================

ファイルリスト取得の実行記録を出力するファイルを指定します。リストの実行結果は常に標準出力へ出力されます。

--
例：
FILE 127.0.0.1:11111:/home/user/Desktop/hcp_dst5
--

--
例：
[user@localhost ~]$ hcp-ls --hcp-out=- ...
--

ソフトウェアの情報確認​

V, version​

=========================================================================
対応OS : Linux / Windows / Mac
書式 : -V | --version
=========================================================================

hcp-lsコマンドのバージョンを表示します。

--
例：
[user@localhost ~]$ hcp-ls -V
hcp-ls client (hcp-ls) 1.5.9_10 / Linux (HpFP2 2.0.0.91_26 WSAPI 0.0.1.36 WS 4.2.0-2)
--

config-test​

=========================================================================
対応OS : Linux / Windows / Mac
書式 : --config-test
=========================================================================

hcp-lsコマンドの入力パラメータ及び設定情報を出力します。

--
例：
[user@localhost ~]$ hcp-ls --config-test
...

-- [Targets] ---------------------------------------------------------------
-- [Command Options] -------------------------------------------------------
 query-cmdname  : disable
 cmd-options    : -
 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​

=========================================================================
対応OS : Linux / Windows / Mac
書式 : -h | --help
=========================================================================

hcp-lsコマンドのヘルプを表示します。

--
例：
[user@localhost ~]$ hcp-ls -h
--