## Name

cifs.upcall — CIFSのためのユーザ空間upcallヘルパ

## Synopsis

`cifs.upcall` [--trust-dns|-t] [--version|-v] {keyid}

## 説明

このツールは samba(7)システムの一部である。

cifs.upcallは、Linux CIFSクライアントファイルシステムのためのユーザ空間ヘルパプログラムである。kernelがそれ自身では簡単にはできないような、さまざまな機能をkernelに代わって行う。このプログラムはkernelから呼び出されてこれらの機能を実行し、その結果を(kernelに)返す。

cifs.upcallはほとんどの場合、kernelがrequest-key(8)で特定のキータイプを呼び出す際に実行されることを想定して作られている。コマンドラインから直接起動できるようにはなっているものの、その方法で呼び出される事は基本的に想定していない。

## オプション

-c

  このオプションは廃止予定で、現在は無視される。

--trust-dns|-t

  krb5 upcallと一緒に、サービスプリンシパルのホスト部として使われる名前は、UNCのホスト名の部分が初期値となる。このオプションは、ホスト名を得るためにサーバのネットワークアドレスを逆引きすることをupcallプログラムに許可する。

  これは、信頼しているDNSよりもセキュアでない。このオプションを使うとき、アタッカがDNSを乗っ取り、まったく異なったサーバにクライアントがマウントするような偽装をすることが可能になる。代わりにすべての考えうるホスト名に対してサーバプリンシパルをKDCに追加する事が望ましいが、このオプションはそれが不可能な時のために存在している。既定値はこの形式でのホスト名の逆引きを信頼しない。

--version|-v

  バージョン番号を表示して終了する。

## KEYCTLのための構成方法

cifs.upcallは、request-key callout プログラム経由でkernelから呼ばれるようにデザインされている。このため、request-keyに対して、どこから、どのようにこのプログラムを呼び出すかを指示してやらなければならない。現在のcifs.upcallプログラムは2つのキータイプを扱う:

cifs.spnego

  このキータイプはkerberosセッションキーを検索する。

dns_resolver

  このキータイプは、ホスト名をIPアドレスに変換(解決)する。

CIFSがこのプログラムを便利に使えるように、request-key.conf(5)中にエントリを設定する必要がある。以下はそれぞれのキータイプのためのエントリの例である:

    #OPERATION  TYPE           D C PROGRAM ARG1 ARG2...
    #=========  =============  = = ================================
    create      cifs.spnego    * * /usr/local/sbin/cifs.upcall %k
    create      dns_resolver   * * /usr/local/sbin/cifs.upcall %k

それぞれのフィールドについての詳細はrequest-key.conf(5)を参照のこと。

## 参照

request-key.conf(5), mount.cifs(8)

## 著者

Igor Mammedovはcifs.upcallプログラムを書いた。

Jeff Laytonはこのマニュアルページを書いた。

Linux CIFS VFSのメンテナはSteve Frenchである。

Linux CIFSメーリングリストは、これらのプログラムに対して質問をするのにふさわしい場所である。

## 日本語訳

このマニュアルページは Samba 3.4.3-3.4.15 対応のものである。

このドキュメントの Samba 3.2.4-3.4.15 対応の翻訳は

- 太田俊哉(ribbon@samba.gr.jp)

- 堀田 倫英(hotta@net-newbie.com)

によって行なわれた。