Scheck Funcs サポート一覧¶

• バージョン：1.0.7-7-g251eead
• リリース日：2023-04-06 11:17:57
• 対応OS：windows/amd64,windows/386,linux/arm,linux/arm64,linux/386,linux/amd64

紹介¶

以前の形式では、Lua 仮想マシンの初期化時にすべての関数を登録していましたが、Lua スクリプトでこれらのメソッドが使用されないため、仮想マシンに冗長性が生じていました。

関数が増えるにつれて、このような冗長性の問題はますます深刻化するため、サブパッケージ化とモジュール化処理が行われました。

これらのモジュールの使用方法¶

Go の関数はパッケージ形式で複数のモジュールに分割されています。Lua スクリプトでモジュールを使用する場合、事前にパッケージをインポートする必要があります（trigger を除く）。

Lua コード：

    -- fileモジュールを使用
    local file = require("file")
    local info = file.file_info("./example.exe")
    print(info['size'])
    -- do something ...

    -- cacheモジュールを使用
    local cache = require("cache")
    cache.set_cache({"123","abc"})
    print(cache.get_cache("123")) -- "abc"

    -- trigger は参照宣言が不要
    local current = "123"
    trigger({Content=current})

モジュールと関数一覧¶

注意：OS が異なるとメソッドセットも異なります。異なるシステム間での呼び出しはできません。all_os はすべての OS に共通するメソッドです。

• file
  • all_os
  • ls
  • file_exist
  • file_info
  • read_file
  • file_hash
  • sc_path_watch
  • grep
• system
  • all_os
  • hostname
  • uptime
  • time_zone
  • mounts
  • uname
  • sc_sleep
  • sc_ticker
  • linux
  • kernel_info
  • kernel_modules
  • ulimit_info
  • processes
  • process_open_files
  • users
  • logged_in_users
  • last
  • lastb
  • shadow
  • shell_history
  • crontab
  • sysctl
  • rpm_list
  • rpm_query
  • windows
• net
  • all_os
  • interface_addresses
  • linux
  • iptables
  • process_open_sockets
  • listening_ports
  • windows
• cache
  • all_os
  • get_cache
  • set_cache
  • del_cache
  • del_cache_all
  • get_global_cache
  • set_global_cache
• json
  • all_os
  • json_encode
  • json_decode
• mysql
  • all_os
  • mysql_weak_psw
  • mysql_ports_list
• コンテナ
  • sc_docker_exist
  • sc_docker_containers
  • sc_docker_runlike
• その他
  • trigger

file¶

file_all_os¶

ls¶

ls(dir[, rescue])

指定されたディレクトリ内のファイルを一覧表示します。

パラメータ：

戻り値：

読み取りに失敗した場合はエラーが発生します。

file_exist¶

file_exist(filepath)

ファイルが存在するか確認します。

パラメータ：

戻り値：

例：

file = '/your/file/path'
exists = file_exist(file)
print(exists)

file_info¶

file_info(filepath)

ファイルの属性とメタデータを読み取ります。

パラメータ：

戻り値：

読み取りに失敗した場合はエラーが発生します。

例：

file = '/your/file/path'
info = file_info(file)

read_file¶

read_file(filepath)

ファイルの内容を読み取ります。

パラメータ：

戻り値：

読み取りに失敗した場合はエラーが発生します。

例：

file='/your/file/path'
content = read_file(file)

file_hash¶

file_hash(filepath)

ファイル内容の MD5 チェックサムを計算します。

パラメータ：

戻り値：

読み取りに失敗した場合はエラーが発生します。

例：

file='/your/file/path'
content = file_hash(file)

sc_path_watch¶

sc_path_watch(dir,chan)

ファイルまたはディレクトリが変更されたかどうかを監視します。

パラメータ：

戻り値：

戻り値はなく、決して停止しません。 ディレクトリまたはファイルが変更されると、lua.LChannel を通じて通知されます。

lua.LChannel：

ファイルステータス：

grep¶

grep(option, pattern, file)

grep コマンドを実行します。

パラメータ：

戻り値：

system¶

system_all_os¶

hostname¶

hostname()

現在のホスト名を取得します。

戻り値：

取得に失敗した場合はエラーが発生します。

uptime¶

uptime()

最後の起動からの経過時間。

戻り値：

time_zone¶

time_zone()

システムの現在のタイムゾーン。

戻り値：

mounts¶

mounts()

システムにマウントされているデバイスとファイルシステム（プロセス固有ではありません）。

戻り値：

読み取りに失敗した場合はエラーが発生します。

uname¶

uname()

オペレーティングシステムの名前とバージョン。

戻り値：

失敗した場合はエラーが発生します。

sc_sleep¶

sc_sleep(time)

スレッドを指定された秒数だけスリープさせます。

パラメータ：

戻り値：

失敗した場合はエラーが発生します。

sc_ticker¶

sc_ticker(channel,time)

定期的に Lua.LChannel にシグナルを送信します。

パラメータ：

戻り値：

戻り値はありません。 Lua.LString を Lua.LChannel に送信します。

system_linux¶

kernel_info¶

kernel_info()

ロードされた Linux カーネルモジュールとロード検索パス内のモジュール。

戻り値：

読み取りに失敗した場合はエラーが発生します。

kernel_modules¶

kernel_modules()

ロードされた Linux カーネルモジュールとロード検索パス内のモジュール。

戻り値：

読み取りに失敗した場合はエラーが発生します。

ulimit_info¶

ulimit_info()

システムリソース使用量の制限。

戻り値：

読み取りに失敗した場合はエラーが発生します。

processes¶

processes()

ホストシステム上で実行中のすべてのプロセス。

戻り値：

読み取りに失敗した場合はエラーが発生します。

process_open_files¶

process_open_files()

各プロセスのファイル記述子。

戻り値：

読み取りに失敗した場合はエラーが発生します。

users¶

users()

ローカルユーザーアカウント（Windows にローカルでログオンしたドメインアカウントを含む）。

戻り値：

読み取りに失敗した場合はエラーが発生します。

logged_in_users¶

logged_in_users()

システムでアクティブなシェルを持つユーザー。

戻り値：

読み取りに失敗した場合はエラーが発生します。

last¶

last()

システムのログインとログアウト。

戻り値：

読み取りに失敗した場合はエラーが発生します。

lastb¶

lastb()

失敗したログイン。

戻り値：

読み取りに失敗した場合はエラーが発生します。

shadow¶

shadow()

ローカルシステムユーザーの暗号化パスワードと関連情報。注意：通常、/etc/shadow にアクセスするにはスーパーユーザー権限が必要です。

戻り値：

読み取りに失敗した場合はエラーが発生します。

shell_history¶

shell_history()

ユーザーごとの .*_history データの改行区切り（コマンド）テーブル。

戻り値：

読み取りに失敗した場合はエラーが発生します。

crontab¶

crontab()

システムおよびユーザーの cron/tab から行解析された値。

戻り値：

失敗した場合はエラーが発生します。

sysctl¶

sysctl([key])

オペレーティングシステムの sysctl 情報。

パラメータ：

戻り値：

失敗した場合はエラーが発生します。

rpm_list¶

rpm_list()

現在のすべての RPM パッケージを一覧表示します。

戻り値：

失敗した場合はエラーが発生します。

rpm_query¶

rpm_query(pkg)

パッケージがインストールされているか確認します。

パラメータ：

戻り値：

system_windows¶

net¶

net_all_os¶

interface_addresses¶

interface_addresses()

ネットワークインターフェースと関連するメタデータ。

戻り値：

読み取りに失敗した場合はエラーが発生します。

net_linux¶

iptables¶

iptables()

Linux IP パケットフィルタリングおよび NAT ツール。

戻り値：

読み取りに失敗した場合はエラーが発生します。

process_open_sockets¶

process_open_sockets()

システム上でネットワークソケットを開いているプロセス。

戻り値：

読み取りに失敗した場合はエラーが発生します。

listening_ports¶

listening_ports()

リッスン（バインド）しているネットワークソケット/ポートを持つプロセス。

戻り値：

読み取りに失敗した場合はエラーが発生します。

net_windows¶

cache¶

cache_all_os¶

get_cache¶

get_cache(key)

キャッシュキーの値を取得します。

パラメータ：

戻り値：

set_cache¶

set_cache(key, value)

キャッシュのキーと値のペアを設定します。

パラメータ：

戻り値：

clean_cache¶

clean_cache()

このルールのキャッシュをクリアします。

パラメータ：

戻り値：

del_cache¶

del_cache(key)

キーを指定してキャッシュを削除します。

パラメータ：

戻り値： 戻り値なし

del_cache_all¶

del_cache()

すべてのキャッシュを削除します。

パラメータ：

戻り値：

get_global_cache¶

get_global_cache(key)

グローバルキャッシュキーの値を取得します。

パラメータ：

戻り値：

set_global_cache¶

set_global_cache(key, value)

グローバルキャッシュにキーと値を設定します。

パラメータ：

戻り値：

json¶

json_all_os¶

json_encode¶

json_encode(object)

Lua テーブルを JSON 文字列にエンコードします。

パラメータ：

戻り値：

エンコードに失敗した場合はエラーが発生します。

json_decode¶

json_decode(str)

JSON 文字列を Lua テーブルにデコードします。

パラメータ：

戻り値：

デコードに失敗した場合はエラーが発生します。

mysql¶

mysql_all_os¶

mysql_weak_psw¶

mysql_weak_psw(host, port [,username])

MySQL の脆弱なパスワードを確認します。

パラメータ：

戻り値：

失敗した場合はエラーが発生します。

mysql_ports_list¶

mysql_ports_list()

ホストの MySQL ポートを一覧表示します。

戻り値：

読み取りに失敗した場合はエラーが発生します。

出力例：

port    3307
protocolversion 10
statusflags 2
authpluginname  mysql_native_password
serverversion   5.7.34
state   LISTEN
cmdline /usr/bin/docker-proxy -proto tcp -host-ip 0.0.0.0 -host-port 3307 -container-ip 172.18.0.4 -container-port 3306
pid 7062

コンテナ関連（container）¶

sc_docker_exist¶

sc_docker_exist()

ホスト上で Docker が実行されているか確認します。

戻り値：

失敗した場合はエラーが発生します。

sc_docker_containers¶

sc_docker_containers()

MySQL の脆弱なパスワードを確認します。

他の Docker 関数の前に、最初に sc_docker_exist を実行する必要があります。

戻り値：

失敗した場合はエラーが発生します。

sc_docker_runlike¶

sc_docker_runlike(containerName)

MySQL の脆弱なパスワードを確認します。

パラメータ：

戻り値：

失敗した場合はエラーが発生します。

その他¶

trigger¶

trigger([template_vals])

イベントをトリガーし、line protocol でターゲットに送信します。

パラメータ：

戻り値：

失敗した場合はエラーが発生します。