diff options
Diffstat (limited to 'ja_JP.eucJP/man/man3/kvm_getprocs.3')
| -rw-r--r-- | ja_JP.eucJP/man/man3/kvm_getprocs.3 | 174 |
1 files changed, 0 insertions, 174 deletions
diff --git a/ja_JP.eucJP/man/man3/kvm_getprocs.3 b/ja_JP.eucJP/man/man3/kvm_getprocs.3 deleted file mode 100644 index 43d67bc3c1..0000000000 --- a/ja_JP.eucJP/man/man3/kvm_getprocs.3 +++ /dev/null @@ -1,174 +0,0 @@ -.\" Copyright (c) 1992, 1993 -.\" The Regents of the University of California. All rights reserved. -.\" -.\" This code is derived from software developed by the Computer Systems -.\" Engineering group at Lawrence Berkeley Laboratory under DARPA contract -.\" BG 91-66 and contributed to Berkeley. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)kvm_getprocs.3 8.1 (Berkeley) 6/4/93 -.\" %FreeBSD: src/lib/libkvm/kvm_getprocs.3,v 1.6.2.6 2001/12/17 10:08:30 ru Exp % -.\" -.\" $FreeBSD$ -.Dd June 4, 1993 -.Dt KVM_GETPROCS 3 -.Os -.Sh 名称 -.Nm kvm_getprocs , -.Nm kvm_getargv , -.Nm kvm_getenvv -.Nd ユーザプロセス状態にアクセスする -.Sh ライブラリ -.Lb libkvm -.Sh 書式 -.In kvm.h -.In sys/param.h -.In sys/sysctl.h -.\" .Fa kvm_t *kd -.Ft struct kinfo_proc * -.Fn kvm_getprocs "kvm_t *kd" "int op" "int arg" "int *cnt" -.Ft char ** -.Fn kvm_getargv "kvm_t *kd" "const struct kinfo_proc *p" "int nchr" -.Ft char ** -.Fn kvm_getenvv "kvm_t *kd" "const struct kinfo_proc *p" "int nchr" -.Sh 解説 -.Fn kvm_getprocs -は -.Fa kd -が指示するカーネルの動作中のプロセスの (サブ) 集合を返します。 -.Fa op -と -.Fa arg -の引数は,返されるプロセスの集合を制限する属性を構成します。 -.Fa op -の値は以下のフィルタリング属性を記述しています : -.Pp -.Bl -tag -width 20n -offset indent -compact -.It Sy KERN_PROC_ALL -すべてのプロセス -.It Sy KERN_PROC_PID -プロセス ID -.Fa arg -を持つプロセス -.It Sy KERN_PROC_PGRP -プロセスグループ -.Fa arg -を持つプロセス -.It Sy KERN_PROC_SESSION -セッション -.Fa arg -を持つプロセス -.It Sy KERN_PROC_TTY -tty -.Fa arg -を持つプロセス -.It Sy KERN_PROC_UID -実効ユーザ ID -.Fa arg -を持つプロセス -.It Sy KERN_PROC_RUID -実ユーザ ID -.Fa arg -を持つプロセス -.El -.Pp -見つけたプロセス数は参照パラメータ -.Fa cnt -で返されます。 -プロセスは kinfo_proc 構造体の連続配列として返されます。 -このメモリは局所的に割り当てられ、 -.Fn kvm_getprocs -と -.Fn kvm_close -に引き続く呼び出しはこの記憶域に上書きします。 -.Pp -.Fn kvm_getargv -はヌルで終了する引数ベクタを返します。 -このベクタは -.Fa p -が示すプロセスに渡されたコマンドライン引数に対応します。 -おそらく、これらの引数はプロセス生成時の -.Xr exec 3 -に渡された値に相当します。 -しかしながら、この情報は、 -故意にプロセス自身のコントロール下にあります。 -オリジナルのコマンド名は、 -.Fn kvm_getprocs -によって返されたプロセス構造体の p_comm フィールドに、 -変更されていない状態で見つけることができます。 -.Pp -.Fa nchr -引数はヌルバイトを含めた最大の文字数を示し、 -文字列の構築に使います。 -もしもこの量を超えてしまえば、 -オーバフローの原因となる文字列は切り捨てられ、 -結果が部分的に返されます。これは -.Xr ps 1 -や -.Xr w 1 -のようなプログラムにとっては簡便な方法です。 -これらのプログラムにおいては、 -コマンドの 1 行要約のみを印字しますので、 -無視するためのみに多量のテキストを複写すべきではありません。 -.Fa nchr -が 0 ならば、なんら制限は課されませんし、 -すべての引数の文字列はそっくりそのまま返されます。 -.Pp -argv ポインタと文字列記憶域に割り当てられたメモリは、 -kvm ライブラリによって所有されます。引き続く -.Fn kvm_getprocs -と -.Xr kvm_close 3 -呼び出しはこの記憶域を容赦なく使います。 -.Pp -.Fn kvm_getenvv -関数は -.Fn kvm_getargv -に類似していますが、環境文字列のベクタを返します。 -このデータはまたプロセスにより変更可能です。 -.Sh 戻り値 -.Fn kvm_getprocs , -.Fn kvm_getargv , -および -.Fn kvm_getenvv -はすべて異常終了時に -.Dv NULL -を返します。 -.Sh バグ -これらのルーチンは kvm インタフェースに属していません。 -.Sh 関連項目 -.Xr kvm 3 , -.Xr kvm_close 3 , -.Xr kvm_geterr 3 , -.Xr kvm_nlist 3 , -.Xr kvm_open 3 , -.Xr kvm_openfiles 3 , -.Xr kvm_read 3 , -.Xr kvm_write 3 |
