Slurm Accounting Storage Plugin API
Overview
This document describes Slurm Accounting Storage plugins and the API that
defines them.
このドキュメントでは、Slurm AccountingStorageプラグインとそれらを定義するAPIについて説明します。
It is intended as a resource to programmers wishing to write
their own Slurm Job Accounting Storage plugins.
これは、独自のSlurm Job AccountingStorageプラグインを作成したいプログラマー向けのリソースとして意図されています。
This is version 1 of the API.
これはAPIのバージョン1です。
Slurm Accounting Storage plugins must conform to the
Slurm Plugin API with the following specifications:
Slurm Accounting Storageプラグインは、次の仕様のSlurm PluginAPIに準拠している必要があります。
const char plugin_name[]="full text name"
A free-formatted ASCII text string that identifies the plugin.
プラグインを識別する自由形式のASCIIテキスト文字列。
const char
plugin_type[]="major/minor"
The major type must be "accounting_storage."
The minor type can be any suitable name
for the type of accounting package.
メジャータイプは「accounting_storage」である必要があります。マイナータイプは、アカウンティングパッケージのタイプに適した名前にすることができます。
We currently use
現在使用しています
- filetxt — Information written to a text file.
filetxt —テキストファイルに書き込まれる情報。
- mysql — Store information in a mysql database (using
the InnoDB storage engine).
mysql —情報をmysqlデータベースに保存します（InnoDBストレージエンジンを使用）。
- slurmdbd — Send information to the Slurm Database
Daemon (SlurmDBD).
slurmdbd — Slurmデータベースデーモン（SlurmDBD）に情報を送信します。
Extra configuration is needed and described here.
追加の構成が必要であり、ここで説明します。
- none — Information is not stored anywhere.
none —情報はどこにも保存されません。
const uint32_t plugin_version
If specified, identifies the version of Slurm used to build this plugin and
any attempt to load the plugin from a different version of Slurm will result
in an error.
指定されている場合、このプラグインのビルドに使用されたSlurmのバージョンを識別し、異なるバージョンのSlurmからプラグインをロードしようとするとエラーが発生します。
If not specified, then the plugin may be loaded by Slurm commands and
daemons from any version, however this may result in difficult to diagnose
failures due to changes in the arguments to plugin functions or changes
in other Slurm functions used by the plugin.
指定しない場合、プラグインは任意のバージョンのSlurmコマンドおよびデーモンによってロードされる可能性がありますが、プラグイン関数の引数の変更またはプラグインが使用する他のSlurm関数の変更により、障害の診断が困難になる可能性があります。
The programmer is urged to study
src/plugins/accounting_storage/mysql
for a sample implementation of a Slurm Accounting Storage plugin.
プログラマーは、Slurm Accounting Storageプラグインのサンプル実装について、src / plugins / accounting_storage / mysqlを調べることをお勧めします。
The Accounting Storage plugin was written to be an interface
to storage data collected by the Job Accounting Gather plugin.
Accounting Storageプラグインは、Job AccountingGatherプラグインによって収集されたストレージデータへのインターフェイスとして作成されました。
When
adding a new database you may want to add common functions in a common
file in the src/database dir.
新しいデータベースを追加するときは、src / databasedirの共通ファイルに共通関数を追加することをお勧めします。
Refer to src/database/mysql_common.c|.h for an
example so other plugins can also use that database type to write out
information.
他のプラグインもそのデータベースタイプを使用して情報を書き出すことができるように、例についてはsrc / database / mysql_common.c | .hを参照してください。
API Functions
The Job Accounting Storage API uses hooks in the slurmctld.
Job Accounting Storage APIは、slurmctldのフックを使用します。
All of the following functions are required.
以下のすべての機能が必要です。
Functions which are not
implemented must be stubbed.
実装されていない関数はスタブする必要があります。
int init (void)
Description:
Called when the plugin is loaded, before any other functions are
called. Put global initialization here.
プラグインがロードされたときに、他の関数が呼び出される前に呼び出されます。ここにグローバル初期化を配置します。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
void fini (void)
Description:
Called when the plugin is removed. Clear any allocated storage here.
プラグインが削除されたときに呼び出されます。ここで割り当てられたストレージをすべてクリアします。
Returns: None.
Note: These init and fini functions are not the same as those
described in the dlopen (3) system library.
注：これらのinitおよびfini関数は、dlopen（3）システムライブラリで説明されているものと同じではありません。
The C run-time system co-opts those symbols for its own initialization.
Cランタイムシステムは、独自の初期化のためにこれらのシンボルを採用します。
The system _init() is called before the Slurm
init(), and the Slurm
fini() is called before the system's
_fini().
システム_init（）はSlurm init（）の前に呼び出され、Slurm fini（）はシステムの_fini（）の前に呼び出されます。
Functions called by the accounting_storage plugin
void *acct_storage_p_get_connection(bool make_agent, int conn_num, uint16_t *persist_conn_flags, bool rollback, char *location)
Description:
acct_storage_p_get_connection() is called to get a connection to the
storage medium.
acct_storage_p_get_connection（）は、ストレージメディアへの接続を取得するために呼び出されます。
acct_storage_p_close_connection() should be used to
free the pointer returned by this function.
acct_storage_p_close_connection（）を使用して、この関数によって返されたポインターを解放する必要があります。
Arguments:
make_agent (input) to make an agent
thread or not.
make_agent（入力）エージェントスレッドを作成するかどうか。
This is primarily used in the slurmdbd plugin.
これは主にslurmdbdプラグインで使用されます。
conn_num (input) connection number to
the plugin.
プラグインへのconn_num（入力）接続番号。
In many cases you should plan on multiple simultaneous
connections to the plugin.
多くの場合、プラグインへの複数の同時接続を計画する必要があります。
This number is useful since the debug
messages can print this out to determine which connection the message
is from.
この番号は、デバッグメッセージがこれを出力して、メッセージの送信元の接続を判別できるため便利です。
persist_conn_flags (output) Flags passed back
from the server if talking to the dbd (optional).
persist_conn_flags（出力）dbdと通信する場合にサーバーから返されるフラグ（オプション）。
rollback (input) Allow rollback to
happen or not (in use with databases that support rollback).
ロールバック（入力）ロールバックの発生を許可するかどうか（ロールバックをサポートするデータベースで使用）。
Returns:
void * which is an opaque structure
used inside the plugin to connect to the storage type on success, or
NULL on failure.
void *は、プラグイン内で成功時にストレージタイプに接続するために使用される不透明な構造であり、失敗するとNULLになります。
int acct_storage_p_close_connection(void **db_conn)
Description:
acct_storage_p_close_connection() is called at the end of the program that has
called acct_storage_p_get_connection().
acct_storage_p_close_connection（）は、acct_storage_p_get_connection（）を呼び出したプログラムの最後に呼び出されます。
This function closes the connection to
the storage type.
この関数は、ストレージタイプへの接続を閉じます。
Arguments:
db_conn (input/output) connection to
the storage type; all memory will be freed inside this function and
set to NULL.
ストレージタイプへのdb_conn（入力/出力）接続。この関数内ですべてのメモリが解放され、NULLに設定されます。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
int acct_storage_p_commit(void *db_conn, bool commit)
Description:
acct_storage_p_commit() is called at a point where you would either
want changes to storage to be committed or rolled back.
acct_storage_p_commit（）は、ストレージへの変更をコミットまたはロールバックする必要があるポイントで呼び出されます。
This function
should also send appropriate update messages to the various slurmctlds.
この関数は、適切な更新メッセージをさまざまなslurmctldsに送信する必要もあります。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
commit (input) true for commit, false
to rollback if connection was set up to rollback.
commit（入力）コミットの場合はtrue、接続がロールバックに設定されている場合はロールバックの場合はfalse。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
int acct_storage_p_add_users(void *db_conn, uint32_t uid, List user_list)
Description:
Called to add users to the storage type.
ストレージタイプにユーザーを追加するために呼び出されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
user_list (input) list of
acct_user_rec_t *'s containing information about the users being added.
user_list（入力）追加されるユーザーに関する情報を含むacct_user_rec_t *のリスト。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
int acct_storage_p_add_coord(void *db_conn, uint32_t uid, List acct_list, acct_user_cond_t *user_cond)
Description:
Called to link specified users to the specified accounts as coordinators.
指定されたユーザーをコーディネーターとして指定されたアカウントにリンクするために呼び出されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
acct_list (input) list of
acct_account_rec_t *'s containing information about the accounts to
add the coordinators to.
acct_list（入力）コーディネーターを追加するアカウントに関する情報を含むacct_account_rec_t *のリスト。
user_cond (input) contain a list of
users to add to be coordinators of the acct_list.
user_cond（入力）には、acct_listのコーディネーターとして追加するユーザーのリストが含まれています。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
int acct_storage_p_add_accts(void *db_conn, uint32_t uid, List acct_list)
Description:
Called to add accounts to the storage type.
ストレージタイプにアカウントを追加するために呼び出されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
acct_list (input) list of
acct_account_rec_t *'s containing information about the accounts to add.
acct_list（入力）追加するアカウントに関する情報を含むacct_account_rec_t *のリスト。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
int acct_storage_p_add_clusters(void *db_conn, uint32_t uid, List cluster_list)
Description:
Called to add clusters to the storage type.
ストレージタイプにクラスターを追加するために呼び出されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
cluster_list (input) list of
acct_cluster_rec_t *'s containing information about the clusters to add.
cluster_list（入力）追加するクラスターに関する情報を含むacct_cluster_rec_t *のリスト。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
int acct_storage_p_add_assocs(void *db_conn, uint32_t uid, List assoc_list)
Description:
Called to add associations to the storage type.
ストレージタイプに関連付けを追加するために呼び出されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
assoc_list (input) list of
acct_assoc_rec_t *'s containing information about the
associations to add.
assoc_list（入力）追加するアソシエーションに関する情報を含むacct_assoc_rec_t *のリスト。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
int acct_storage_p_add_qos(void *db_conn, uint32_t uid, List qos_list)
Description:
Called to add QOS's to the storage type.
ストレージタイプにQOSを追加するために呼び出されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
qos_list (input) list of
acct_qos_rec_t *'s containing information about the qos to add.
追加するqosに関する情報を含むacct_qos_rec_t *のqos_list（入力）リスト。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
int acct_storage_p_add_wckeys(void *db_conn, uint32_t uid, List wckey_list)
Description:
Called to add wckeys to the storage type.
ストレージタイプにwckeyを追加するために呼び出されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
wckey_list (input) list of
acct_wckey_rec_t *'s containing information about the wckeys to add.
wckey_list（入力）追加するwckeyに関する情報を含むacct_wckey_rec_t *のリスト。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
int acct_storage_p_add_reservation(void *db_conn, acct_reservation_rec_t *resv)
Description:
Called to add reservations to the storage type.
ストレージタイプに予約を追加するために呼び出されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
resv (input) Reservation to be added.
resv（入力）追加する予約。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
List acct_storage_p_modify_users(void *db_conn, uint32_t uid, acct_user_cond_t *user_cond, acct_user_rec_t *user)
Description:
Used to modify existing users in the storage type.
ストレージタイプの既存のユーザーを変更するために使用されます。
The condition
could include very vague information about the user, so this
function should be robust in the ability to give everything the user
is asking for.
条件にはユーザーに関する非常にあいまいな情報が含まれる可能性があるため、この関数は、ユーザーが求めているすべてのものを提供する機能において堅牢である必要があります。
This is the reason a list of modified users is
returned so the caller knows what has been changed, sometimes by mistake.
これが、変更されたユーザーのリストが返される理由です。これにより、呼び出し元は、場合によっては誤って何が変更されたかを知ることができます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
user_cond (input) conditional about
which users need to change.
user_cond（入力）どのユーザーを変更する必要があるかについて条件付き。
User names or ids should not need to be stated.
ユーザー名またはIDを記述する必要はありません。
user (input) what the changes
should be on the users identified by the conditional.
ユーザー（入力）条件によって識別されたユーザーにどのような変更を加える必要があるか。
Returns:
List containing names of users
modified on success, or
NULL on failure.
成功した場合は変更されたユーザーの名前、失敗した場合はNULLを含むリスト。
List acct_storage_p_modify_accounts(void *db_conn, uint32_t uid, acct_account_cond_t *acct_cond, acct_account_rec_t *acct)
Description:
Used to modify existing accounts in the storage type.
ストレージタイプの既存のアカウントを変更するために使用されます。
The condition
could include very vague information about the account, so this
function should be robust in the ability to give everything the account
is asking for.
条件にはアカウントに関する非常にあいまいな情報が含まれる可能性があるため、この関数は、アカウントが要求するすべてのものを提供する機能において堅牢である必要があります。
This is the reason a list of modified accounts is
returned so the caller knows what has been changed, sometimes by mistake.
これが、変更されたアカウントのリストが返される理由です。これにより、発信者は、場合によっては誤って何が変更されたかを知ることができます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
acct_cond (input) conditional about
which accounts need to change.
acct_cond（入力）どのアカウントを変更する必要があるかについて条件付き。
Account names should not need to be stated.
アカウント名を記載する必要はありません。
acct (input) what the changes
should be on the accounts identified by the conditional.
acct（入力）条件によって識別されたアカウントの変更内容。
Returns:
List containing names of users
modified on success, or
NULL on failure.
成功した場合は変更されたユーザーの名前、失敗した場合はNULLを含むリスト。
List acct_storage_p_modify_clusters(void *db_conn, uint32_t uid, acct_cluster_cond_t *cluster_cond, acct_cluster_rec_t *cluster)
Description:
Used to modify existing clusters in the storage type.
ストレージタイプの既存のクラスターを変更するために使用されます。
The condition
could include very vague information about the cluster, so this
function should be robust in the ability to give everything the cluster
is asking for.
条件にはクラスターに関する非常にあいまいな情報が含まれる可能性があるため、この関数は、クラスターが要求するすべてのものを提供する機能において堅牢である必要があります。
This is the reason a list of modified clusters is
returned so the caller knows what has been changed, sometimes by mistake.
これが、変更されたクラスターのリストが返される理由であり、呼び出し元は、場合によっては誤って何が変更されたかを知ることができます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
cluster_cond (input) conditional about
which clusters need to change.
cluster_cond（入力）どのクラスターを変更する必要があるかについて条件付き。
Cluster names should not need to be stated.
クラスター名を記述する必要はありません。
cluster (input) what the changes
should be on the clusters identified by the conditional.
cluster（入力）条件によって識別されたクラスターでの変更の内容。
Returns:
List containing names of clusters
modified on success, or
NULL on failure.
成功した場合は変更されたクラスターの名前、失敗した場合はNULLを含むリスト。
List acct_storage_p_modify_assocs(void *db_conn, uint32_t uid, acct_assoc_cond_t *assoc_cond, acct_assoc_rec_t *assoc)
Description:
Used to modify existing associations in the storage type.
ストレージタイプの既存の関連付けを変更するために使用されます。
The condition
could include very vague information about the association, so this
function should be robust in the ability to give everything the association
is asking for.
条件には、関連付けに関する非常にあいまいな情報が含まれる可能性があるため、この関数は、関連付けが要求するすべてのものを提供する機能において堅牢である必要があります。
This is the reason a list of modified associations is
returned so the caller knows what has been changed, sometimes by mistake.
これが、変更された関連付けのリストが返される理由です。これにより、呼び出し元は、場合によっては誤って、何が変更されたかを知ることができます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
assoc_cond (input) conditional about
which associations need to change.
assoc_cond（入力）どの関連付けを変更する必要があるかについて条件付き。
Association ids should not need to be stated.
アソシエーションIDを記述する必要はありません。
assoc (input) what the changes
should be on the associations identified by the conditional.
assoc（入力）条件によって識別された関連付けにどのような変更を加える必要があるか。
Returns:
List containing names of associations
modified on success, or
NULL on failure.
成功した場合は変更されたアソシエーションの名前、失敗した場合はNULLを含むリスト。
List acct_storage_p_modify_job(void *db_conn, uint32_t uid, acct_job_modify_cond_t *job_cond, acct_job_rec_t *job)
Description:
Used to modify two fields (the derived exit code and the comment string) of an
existing job in the storage type.
ストレージタイプの既存のジョブの2つのフィールド（派生した終了コードとコメント文字列）を変更するために使用されます。
Can only modify one job at a time.
一度に変更できるジョブは1つだけです。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
job_cond (input) conditional about
which job need to change.
どのジョブを変更する必要があるかを条件とするjob_cond（入力）。
job (input) what the changes
should be on the job identified by the conditional.
ジョブ（入力）条件によって識別されたジョブにどのような変更を加える必要があるか。
Returns:
List containing ID of job
modified on success, or
NULL on failure.
成功した場合は変更されたジョブのID、失敗した場合はNULLを含むリスト。
List acct_storage_p_modify_qos(void *db_conn, uint32_t uid, acct_qos_cond_t *qos_cond, acct_qos_rec_t *qos)
Description:
Used to modify existing qos in the storage type.
ストレージタイプの既存のQoSを変更するために使用されます。
The condition
could include very vague information about the qos, so this
function should be robust in the ability to give everything the qos
is asking for.
条件には、qosに関する非常にあいまいな情報が含まれる可能性があるため、この関数は、qosが要求するすべてのものを提供する機能において堅牢である必要があります。
This is the reason a list of modified qos is
returned so the caller knows what has been changed, sometimes by mistake.
これが、変更されたqosのリストが返される理由であり、呼び出し元は、場合によっては誤って何が変更されたかを知ることができます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
qos_cond (input) conditional about
which qos need to change.
qos_cond（入力）どのqosを変更する必要があるかについて条件付き。
Qos names should not need to be stated.
Qos名を記述する必要はありません。
qos (input) what the changes
should be on the qos identified by the conditional.
qos（入力）条件によって識別されたqosの変更内容。
Returns:
List containing names of qos
modified on success, or
NULL on failure.
成功した場合は変更されたqosの名前、失敗した場合はNULLを含むリスト。
List acct_storage_p_modify_wckeys(void *db_conn, uint32_t uid, acct_wckey_cond_t *wckey_cond, acct_wckey_rec_t *wckey)
Description:
Used to modify existing wckeys in the storage type.
ストレージタイプの既存のwckeyを変更するために使用されます。
The condition
could include very vague information about the wckeys, so this
function should be robust in the ability to give everything the wckey
is asking for.
条件には、wckeyに関する非常にあいまいな情報が含まれる可能性があるため、この関数は、wckeyが要求するすべてのものを提供する機能において堅牢である必要があります。
This is the reason a list of modified wckey is
returned so the caller knows what has been changed, sometimes by mistake.
これが、変更されたwckeyのリストが返される理由であり、呼び出し元は、場合によっては誤って何が変更されたかを知ることができます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
wckey_cond (input) conditional about
which wckeys need to change.
wckey_cond（入力）どのwckeyを変更する必要があるかについて条件付き。
Wckey names should not need to be stated.
Wckeyの名前を記述する必要はありません。
wckey (input) what the changes
should be on the wckey identified by the conditional.
wckey（入力）条件によって識別されるwckeyの変更内容。
Returns:
List containing names of wckeys
modified on success, or
NULL on failure.
成功した場合は変更されたwckeyの名前、失敗した場合はNULLを含むリスト。
int acct_storage_p_modify_reservation(void *db_conn, acct_reservation_rec_t *resv)
Description:
Called to modify reservations in the storage type.
ストレージタイプの予約を変更するために呼び出されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
resv (input) Reservation to be
modified (id) must be set in the structure.
resv（入力）変更する予約（id）を構造体に設定する必要があります。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
List acct_storage_p_remove_users(void *db_conn, uint32_t uid, acct_user_cond_t *user_cond)
Description:
Used to remove users from the storage type.
ストレージタイプからユーザーを削除するために使用されます。
This will remove all
associations.
これにより、すべての関連付けが削除されます。
Must check to make sure all running jobs are finished
before this is allowed to execute.
これを実行する前に、実行中のすべてのジョブが終了していることを確認する必要があります。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
user_cond (input) conditional about
which users to be removed.
user_cond（入力）どのユーザーを削除するかについて条件付き。
User names or ids should not need to be stated.
ユーザー名またはIDを記述する必要はありません。
Returns:
List containing names of users
removed on success, or
NULL on failure.
成功した場合は削除されたユーザーの名前、失敗した場合はNULLを含むリスト。
List acct_storage_p_remove_coord(void *db_conn, uint32_t uid, List acct_list, acct_user_cond_t *user_cond)
Description:
Used to remove coordinators from the storage type.
ストレージタイプからコーディネーターを削除するために使用されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
acct_list (input) list of accounts
associated with the users.
acct_list（入力）ユーザーに関連付けられているアカウントのリスト。
user_cond (input) conditional about
which users to be removed as coordinators.
user_cond（入力）どのユーザーをコーディネーターとして削除するかについて条件付き。
User names or ids should be stated.
ユーザー名またはIDを記載する必要があります。
Returns:
List containing names of users
removed as coordinators on success, or
NULL on failure.
成功した場合はコーディネーターとして削除され、失敗した場合はNULLとして削除されたユーザーの名前を含むリスト。
List acct_storage_p_remove_accounts(void *db_conn, uint32_t uid, acct_account_cond_t *acct_cond)
Description:
Used to remove accounts from the storage type.
ストレージタイプからアカウントを削除するために使用されます。
This will remove all
associations from these accounts.
これにより、これらのアカウントからすべての関連付けが削除されます。
You need to make sure no jobs are
running with any association that is to be removed.
削除する関連付けでジョブが実行されていないことを確認する必要があります。
If any of these
accounts are default accounts for users that must also change before
an account can be removed.
これらのアカウントのいずれかがユーザーのデフォルトアカウントである場合、アカウントを削除する前に変更する必要があります。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
acct_cond (input) conditional about
which accounts to be removed.
acct_cond（入力）どのアカウントを削除するかについて条件付き。
Account names should not need to be stated.
アカウント名を記載する必要はありません。
Returns:
List containing names of accounts
removed on success, or
NULL on failure.
成功した場合は削除されたアカウントの名前、失敗した場合はNULLを含むリスト。
List acct_storage_p_remove_clusters(void *db_conn, uint32_t uid, acct_cluster_cond_t *cluster_cond)
Description:
Used to remove clusters from the storage type.
ストレージタイプからクラスターを削除するために使用されます。
This will remove all
associations from these clusters.
これにより、これらのクラスターからすべての関連付けが削除されます。
You need to make sure no jobs are
running with any association that is to be removed.
削除する関連付けでジョブが実行されていないことを確認する必要があります。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
cluster_cond (input) conditional about
which clusters to be removed.
cluster_cond（入力）どのクラスターを削除するかについて条件付き。
Cluster names should not need to be stated.
クラスター名を記述する必要はありません。
Returns:
List containing names of clusters
removed on success, or
NULL on failure.
成功した場合は削除されたクラスターの名前、失敗した場合はNULLを含むリスト。
List acct_storage_p_remove_assocs(void *db_conn, uint32_t uid, acct_assoc_cond_t *assoc_cond)
Description:
Used to remove associations from the storage type.
ストレージタイプから関連付けを削除するために使用されます。
You need to make
sure no jobs are running with any association that is to be removed.
削除する関連付けでジョブが実行されていないことを確認する必要があります。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
assoc_cond (input) conditional about
which associations to be removed.
assoc_cond（入力）どの関連付けを削除するかについて条件付き。
Association ids should not need to be stated.
アソシエーションIDを記述する必要はありません。
Returns:
List containing names of associations
removed on success, or
NULL on failure.
成功した場合は削除された、失敗した場合はNULLの関連付けの名前を含むリスト。
List acct_storage_p_remove_qos(void *db_conn, uint32_t uid, acct_qos_cond_t *qos_cond)
Description:
Used to remove qos from the storage type.
ストレージタイプからQoSを削除するために使用されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
qos_cond (input) conditional about
which qos to be removed.
qos_cond（入力）どのqosを削除するかについて条件付き。
Qos names should not need to be stated.
Qos名を記述する必要はありません。
Returns:
List containing names of qos
removed on success, or
NULL on failure.
成功した場合は削除されたqosの名前、失敗した場合はNULLの名前を含むリスト。
List acct_storage_p_remove_wckeys(void *db_conn, uint32_t uid, acct_wckey_cond_t *wckey_cond)
Description:
Used to remove wckeys from the storage type.
ストレージタイプからwckeyを削除するために使用されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
wckey_cond (input) conditional about
which wckeys to be removed.
wckey_cond（入力）どのwckeyを削除するかについて条件付き。
Wckey names should not need to be stated.
Wckeyの名前を記述する必要はありません。
Returns:
List containing names of wckeys
removed on success, or
NULL on failure.
成功した場合は削除されたwckeyの名前、失敗した場合はNULLを含むリスト。
int acct_storage_p_remove_reservation(void *db_conn, acct_reservation_rec_t *resv)
Description:
Called to remove reservations in the storage type.
ストレージタイプの予約を削除するために呼び出されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
resv (input) Reservation to be
removed (id) must be set in the structure.
resv（入力）削除する予約（id）を構造体に設定する必要があります。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
List acct_storage_p_get_users(void *db_conn, uint32_t uid, acct_user_cond_t *user_cond)
Description:
Get a list of acct_user_rec_t *'s based on the conditional sent.
送信された条件に基づいて、acct_user_rec_t *のリストを取得します。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the
function.
uid（入力）関数を呼び出すユーザーのuid。
user_cond (input) conditional about
which users are to be returned.
user_cond（入力）どのユーザーが返されるかについて条件付き。
User names or ids should not need to
be stated.
ユーザー名またはIDを記述する必要はありません。
Returns:
List containing acct_user_rec_t *'s
on success, or
NULL on failure.
成功した場合はacct_user_rec_t *を、失敗した場合はNULLを含むリスト。
List acct_storage_p_get_accts(void *db_conn, uint32_t uid, acct_account_cond_t *acct_cond)
Description:
Get a list of acct_account_rec_t *'s based on the conditional sent.
送信された条件に基づいて、acct_account_rec_t *のリストを取得します。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the
function.
uid（入力）関数を呼び出すユーザーのuid。
acct_cond (input) conditional about
which accounts are to be returned.
acct_cond（入力）どのアカウントが返されるかについて条件付き。
Account names should not need to
be stated.
アカウント名を記載する必要はありません。
Returns:
List containing acct_account_rec_t *'s
on success, or
NULL on failure.
成功した場合はacct_account_rec_t *を、失敗した場合はNULLを含むリスト。
List acct_storage_p_get_clusters(void *db_conn, uint32_t uid, acct_cluster_cond_t *cluster_cond)
Description:
Get a list of acct_cluster_rec_t *'s based on the conditional sent.
送信された条件に基づいて、acct_cluster_rec_t *のリストを取得します。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the
function.
uid（入力）関数を呼び出すユーザーのuid。
cluster_cond (input) conditional about
which clusters are to be returned.
cluster_cond（入力）どのクラスターが返されるかについて条件付き。
Cluster names should not need to
be stated.
クラスター名を記述する必要はありません。
Returns:
List containing acct_cluster_rec_t *'s
on success, or
NULL on failure.
List acct_storage_p_get_assocs(void *db_conn, uint32_t uid, acct_assoc_cond_t *assoc_cond)
Description:
Get a list of acct_assoc_rec_t *'s based on the conditional sent.
送信された条件に基づいて、acct_assoc_rec_t *のリストを取得します。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the
function.
uid（入力）関数を呼び出すユーザーのuid。
assoc_cond (input) conditional about
which associations are to be returned.
assoc_cond（入力）どのアソシエーションが返されるかについて条件付き。
Association names should not need to
be stated.
協会名を記載する必要はありません。
Returns:
List containing acct_assoc_rec_t *'s
on success, or
NULL on failure.
List acct_storage_p_get_events(void *db_conn, uint32_t uid, acct_event_cond_t *event_cond)
Description:
Get a list of acct_event_rec_t *'s based on the conditional sent.
送信された条件に基づいて、acct_event_rec_t *のリストを取得します。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the
function.
uid（入力）関数を呼び出すユーザーのuid。
event_cond (input) conditional about
which events are to be returned.
event_cond（入力）どのイベントが返されるかについて条件付き。
Returns:
List containing acct_event_rec_t *'s
on success, or
NULL on failure.
成功した場合はacct_event_rec_t *を、失敗した場合はNULLを含むリスト。
List acct_storage_p_get_qos(void *db_conn, uint32_t uid, acct_qos_cond_t *qos_cond)
Description:
Get a list of acct_qos_rec_t *'s based on the conditional sent.
送信された条件に基づいて、acct_qos_rec_t *のリストを取得します。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the
function.
uid（入力）関数を呼び出すユーザーのuid。
qos_cond (input) conditional about
which qos are to be returned.
qos_cond（入力）どのqosが返されるかについて条件付き。
Qos names should not need to
be stated.
Qos名を記述する必要はありません。
Returns:
List containing acct_qos_rec_t *'s
on success, or
NULL on failure.
成功した場合はacct_qos_rec_t *を、失敗した場合はNULLを含むリスト。
List acct_storage_p_get_wckeys(void *db_conn, uint32_t uid, acct_wckey_cond_t *wckey_cond)
Description:
Get a list of acct_wckey_rec_t *'s based on the conditional sent.
送信された条件に基づいて、acct_wckey_rec_t *のリストを取得します。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the
function.
uid（入力）関数を呼び出すユーザーのuid。
wckey_cond (input) conditional about
which wckeys are to be returned.
wckey_cond（入力）どのwckeyが返されるかについて条件付き。
Wckey names should not need to
be stated.
Wckeyの名前を記述する必要はありません。
Returns:
List containing acct_wckey_rec_t *'s
on success, or
NULL on failure.
成功した場合はacct_wckey_rec_t *を、失敗した場合はNULLを含むリスト。
List acct_storage_p_get_txn(void *db_conn, uint32_t uid, acct_txn_cond_t *txn_cond)
Description:
Get a list of acct_txn_rec_t *'s (transactions) based on the conditional sent.
送信された条件に基づいて、acct_txn_rec_t *（トランザクション）のリストを取得します。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the
function.
uid（入力）関数を呼び出すユーザーのuid。
txn_cond (input) conditional about
which transactions are to be returned.
txn_cond（入力）どのトランザクションが返されるかについて条件付き。
Transaction ids should not need to
be stated.
トランザクションIDを記述する必要はありません。
Returns:
List containing acct_txn_rec_t *'s
on success, or
NULL on failure.
成功した場合はacct_txn_rec_t *を、失敗した場合はNULLを含むリスト。
int acct_storage_p_get_usage(void *db_conn, uint32_t uid, void *in, int type, time_t start, time_t end)
Description:
Get usage for a specific association or wckey.
特定のアソシエーションまたはwckeyの使用法を取得します。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the
function.
uid（入力）関数を呼び出すユーザーのuid。
in (input/out) can be anything that
gathers usage like acct_assoc_rec_t * or acct_wckey_rec_t *.
in（input / out）は、acct_assoc_rec_t *やacct_wckey_rec_t *などの使用法を収集するものであれば何でもかまいません。
type (input) really
slurmdbd_msg_type_t should let the plugin know what the structure is
that was sent in some how.
type（input）本当にslurmdbd_msg_type_tは、何らかの方法で送信された構造が何であるかをプラグインに通知する必要があります。
start (input) start time of the usage.
使用開始（入力）開始時刻。
end (input) end time of the usage.
使用の終了（入力）終了時間。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
int acct_storage_p_roll_usage(void *db_conn, time_t sent_start, time_t sent_end, uint16_t archive_data, rollup_stats_t *rollup_stats)
Description:
roll up association, cluster, and wckey usage in the storage.
ストレージ内の関連付け、クラスター、およびwckeyの使用をロールアップします。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
sent_start (input) start time of the rollup.
sent_start（入力）ロールアップの開始時刻。
sent_end (input) end time of the rollup.
sent_end（入力）ロールアップの終了時刻。
archive_data (input) archive the results if not zero.
archive_data（入力）は、ゼロでない場合は結果をアーカイブします。
rollup_stats (input/output) performance statistics.
rollup_stats（入力/出力）パフォーマンス統計。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
int clusteracct_storage_p_node_down(void *db_conn, char *cluster, node_record_t *node_ptr, time_t event_time, char *reason)
Description:
Mark nodes down in the storage type.
ストレージタイプでノードをマークダウンします。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
cluster (input) name of cluster node
is on.
クラスタノードのクラスタ（入力）名がオンになっています。
node_ptr (input) pointer to the node
structure marked down.
node_ptr（入力）マークダウンされたノード構造へのポインター。
event_time (input) time event happened.
event_time（入力）時間イベントが発生しました。
reason (input) if different from what
is set in the node_ptr, the reason the node is down.
理由（入力）node_ptrに設定されているものと異なる場合、ノードがダウンしている理由。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
int clusteracct_storage_p_node_up(void *db_conn, char *cluster, node_record_t *node_ptr, time_t event_time)
Description:
Mark nodes up in the storage type.
ストレージタイプでノードをマークアップします。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
cluster (input) name of cluster node
is on.
クラスタノードのクラスタ（入力）名がオンになっています。
node_ptr (input) pointer to the node
structure marked up.
node_ptr（入力）マークアップされたノード構造へのポインター。
event_time (input) time event happened.
event_time（入力）時間イベントが発生しました。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
int clusteracct_storage_p_cluster_procs(void *db_conn, char *cluster, char *cluster_nodes, uint32_t procs, time_t event_time)
Description:
Update storage type with the current number of processors on a given cluster.
特定のクラスター上の現在のプロセッサー数でストレージタイプを更新します。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
cluster (input) name of cluster.
クラスター（入力）クラスターの名前。
cluster_nodes (input) ranged list of
nodes on system.
cluster_nodes（入力）システム上のノードの範囲リスト。
procs (input) number of processors on
system.
procs（入力）システム上のプロセッサの数。
event_time (input) time event happened.
event_time（入力）時間イベントが発生しました。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
int clusteracct_storage_p_get_usage(void *db_conn, uint32_t uid, void *cluster_rec, int type, time_t start, time_t end)
Description:
Get usage for a specific cluster.
特定のクラスターの使用法を取得します。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the
function.
uid（入力）関数を呼び出すユーザーのuid。
cluster_rec (input/out)
acct_cluster_rec_t * already set with the cluster name.
cluster_rec（input / out）acct_cluster_rec_t *クラスター名で既に設定されています。
Usage will be
filled in.
使用法が記入されます。
type (input) really
slurmdbd_msg_type_t should let the plugin know what the structure is
that was sent in some how for this it is just DBD_GET_CLUSTER_USAGE.
type（input）本当にslurmdbd_msg_type_tは、プラグインに、送信された構造が何であるかを通知する必要があります。これは、DBD_GET_CLUSTER_USAGEだけです。
start (input) start time of the usage.
使用開始（入力）開始時刻。
end (input) end time of the usage.
使用の終了（入力）終了時間。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
int clusteracct_storage_p_register_ctld(void *db_conn, char *cluster, uint16_t port)
Description:
Used when a controller is turned on to tell the storage type where the
slurmctld for a given cluster is located at.
コントローラがオンになっているときに使用され、特定のクラスタのslurmctldが配置されているストレージタイプを通知します。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
cluster (input) name of cluster.
クラスター（入力）クラスターの名前。
port (input) port on host cluster is
running on the host is grabbed from the connection.
ポート（入力）ホストで実行されているホストクラスターのポートが接続から取得されます。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
int clusteracct_storage_p_fini_ctld(void *db_conn, char *ip, uint16_t port, char *cluster_nodes)
Description:
Used when a controller is turned off to tell the storage type the
slurmctld has gone away.
コントローラがオフになっているときに使用され、slurmctldがなくなったことをストレージタイプに通知します。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
ip (input) ip of connected slurmctld.
ip（入力）接続されたslurmctldのip。
port (input) port on host cluster is
running on the host is grabbed from the connection.
ポート（入力）ホストで実行されているホストクラスターのポートが接続から取得されます。
cluster_nodes (input) name of all
nodes currently on the cluster.
cluster_nodes（入力）現在クラスター上にあるすべてのノードの名前。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
int jobacct_storage_p_job_start(void *db_conn, job_record_t *job_ptr)
Description:
Note that a job is about to begin execution or has just changed size.
ジョブが実行を開始しようとしている、またはサイズが変更されたばかりであることに注意してください。
The job's state will include the JOB_RESIZING flag if and only if it has
just changed size.
ジョブの状態には、サイズが変更されたばかりの場合に限り、JOB_RESIZINGフラグが含まれます。
Otherwise the job is beginning execution for the first time.
それ以外の場合、ジョブは初めて実行を開始します。
Note the existance of resize_time in the job record if one wishes to
record information about a job at each size (i.e. a history of the job as
its size changes through time).
各サイズでジョブに関する情報（つまり、サイズが時間とともに変化するときのジョブの履歴）を記録する場合は、ジョブレコードにresize_timeが存在することに注意してください。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
job_ptr (input) information about the job in
slurmctld.
slurmctld内のジョブに関するjob_ptr（入力）情報。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
int jobacct_storage_p_job_complete(void *db_conn, job_record_t *job_ptr)
Description:
Note that a job is about to terminate or change size.
ジョブが終了するか、サイズが変更されようとしていることに注意してください。
The job's state will include the JOB_RESIZING flag if and only if it is about
to change size.
ジョブの状態には、サイズが変更されようとしている場合にのみ、JOB_RESIZINGフラグが含まれます。
Otherwise the job is terminating.
それ以外の場合、ジョブは終了します。
Note the existance of resize_time in the job record if one wishes to
record information about a job at each size (i.e. a history of the job as
its size changes through time).
各サイズでジョブに関する情報（つまり、サイズが時間とともに変化するときのジョブの履歴）を記録する場合は、ジョブレコードにresize_timeが存在することに注意してください。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
job_ptr (input) information about the job in
slurmctld.
slurmctld内のジョブに関するjob_ptr（入力）情報。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
int jobacct_storage_p_step_start(void *db_conn, step_record_t *step_ptr)
Description:
jobacct_storage_p_step_start() is called in the jobacct plugin at the
allocation of a new step in the slurmctld, this inserts info about the
beginning of a step.
jobacct_storage_p_step_start（）は、slurmctldの新しいステップの割り当て時にjobacctプラグインで呼び出されます。これにより、ステップの開始に関する情報が挿入されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
step_ptr (input) information about the step in
slurmctld.
slurmctldのステップに関するstep_ptr（入力）情報。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
int jobacct_storage_p_step_complete(void *db_conn, step_record_t *step_ptr)
Description:
jobacct_storage_p_step_complete() is called in the jobacct plugin at
the end of a step in the slurmctld, this updates the ending
information about a step.
jobacct_storage_p_step_complete（）は、slurmctldのステップの最後にjobacctプラグインで呼び出されます。これにより、ステップに関する終了情報が更新されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
step_ptr (input) information about the step in
slurmctld.
slurmctldのステップに関するstep_ptr（入力）情報。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
int jobacct_storage_p_job_suspend(void *db_conn, job_record_t *job_ptr)
Description:
jobacct_storage_p_suspend() is called in the jobacct plugin when a
job is suspended or resumed in the slurmctld, this updates the
database about the suspended time of the job.
jobacct_storage_p_suspend（）は、slurmctldでジョブが一時停止または再開されたときに、jobacctプラグインで呼び出されます。これにより、ジョブの一時停止時間についてデータベースが更新されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
job_ptr (input) information about the job in
slurmctld.
slurmctld内のジョブに関するjob_ptr（入力）情報。
Returns:
none
無し
List jobacct_storage_p_get_jobs_cond(void *db_conn, uint32_t uid, acct_job_cond_t *job_cond)
Description:
jobacct_storage_p_get_jobs_cond() is called to get a list of jobs from the
database given the conditional.
jobacct_storage_p_get_jobs_cond（）は、条件付きでデータベースからジョブのリストを取得するために呼び出されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
uid (input) uid of user calling the function.
uid（入力）関数を呼び出すユーザーのuid。
job_cond (input) conditional about
which jobs to get.
job_cond（入力）取得するジョブに関する条件付き。
Job ids should not need to be stated.
ジョブIDを指定する必要はありません。
Returns:
List of job_rec_t's on success, or
NULL on failure.
成功した場合はjob_rec_tのリスト、失敗した場合はNULLのリスト。
int jobacct_storage_p_archive(void *db_conn, acct_archive_cond_t *arch_cond)
Description:
used to archive old data.
古いデータをアーカイブするために使用されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
arch_cond (input) conditional about
what to archive.
何をアーカイブするかについて条件付きのarch_cond（入力）。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
int jobacct_storage_p_archive_load(void *db_conn, acct_archive_rect *arch_rec)
Description:
used to load old archive data.
古いアーカイブデータをロードするために使用されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
arch_rec (input) information about
what to load.
ロードするものに関するarch_rec（入力）情報。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
int acct_storage_p_update_shares_used(void *db_conn, List acct_list)
Description:
Used to update shares used in the storage type.
ストレージタイプで使用される共有を更新するために使用されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
acct_list (input) List of shares_used_object_t.
acct_list（入力）shares_used_object_tのリスト。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
int acct_storage_p_flush_jobs_on_cluster(void *db_conn, char *cluster, time_t event_time)
Description:
used to mark all jobs in the storage type as finished.
ストレージタイプのすべてのジョブを終了としてマークするために使用されます。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
cluster (input) name of cluster to
apply end to.
終了を適用するクラスターのクラスター（入力）名。
event_time (input) when the flush happened.
フラッシュが発生したときのevent_time（入力）。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
int acct_storage_p_reconfig(void *db_conn)
Description:
Reconfigure the plugin.
プラグインを再構成します。
Arguments:
db_conn (input) connection to
the storage type.
ストレージタイプへのdb_conn（入力）接続。
Returns:
SLURM_SUCCESS on success, or
SLURM_ERROR on failure.
成功した場合はSLURM_SUCCESS、失敗した場合はSLURM_ERROR。
Parameters
These parameters can be used in the slurm.conf to set up
connections to the database all have defaults based on the plugin type
used.
これらのパラメーターをslurm.confで使用して、データベースへの接続を設定できます。すべて、使用されているプラグインタイプに基づいたデフォルトがあります。
- AccountingStorageType
- Specifies which plugin should be used.
使用するプラグインを指定します。
- AccountingStorageLoc
- Let the plugin the name of the logfile/database name to use.
プラグインに使用するログファイル/データベース名の名前を許可します。
- AccountingStorageHost
- Let the plugin know the host where the database is.
データベースが存在するホストをプラグインに知らせます。
- AccountingStoragePort
- Let the plugin know the port to connect to.
プラグインに接続するポートを知らせます。
- AccountingStorageUser
- Let the plugin know the name of the user to connect to the
database with.
データベースに接続するユーザーの名前をプラグインに知らせます。
- AccountingStoragePass
- Let the plugin know the password of the user connecting to the database.
データベースに接続しているユーザーのパスワードをプラグインに知らせます。
- AccountingStorageEnforce
- Specifies if we should enforce certain things be in existence
before allowing job submissions and such valid options are
"associations, limits, qos, and wckeys".
ジョブの送信を許可する前に特定のものが存在するように強制する必要があるかどうかを指定します。そのような有効なオプションは「関連付け、制限、qos、およびwckeys」です。
You can use any combination of those listed.
リストされているものの任意の組み合わせを使用できます。
Last modified 23 October 2019