| 1 | .\" Title: cifs.upcall
|
|---|
| 2 | .\" Author:
|
|---|
| 3 | .\" Generator: DocBook XSL Stylesheets v1.73.1 <http://docbook.sf.net/>
|
|---|
| 4 | .\" Date: 08/27/2008
|
|---|
| 5 | .\" Manual: System Administration tools
|
|---|
| 6 | .\" Source: Samba 3.2
|
|---|
| 7 | .\"
|
|---|
| 8 | .TH "CIFS\.UPCALL" "8" "08/27/2008" "Samba 3\.2" "System Administration tools"
|
|---|
| 9 | .\" disable hyphenation
|
|---|
| 10 | .nh
|
|---|
| 11 | .\" disable justification (adjust text to left margin only)
|
|---|
| 12 | .ad l
|
|---|
| 13 | .SH "NAME"
|
|---|
| 14 | cifs.upcall - Userspace upcall helper for Common Internet File System (CIFS)
|
|---|
| 15 | .SH "SYNOPSIS"
|
|---|
| 16 | .HP 1
|
|---|
| 17 | cifs\.upcall [\-c] [\-v] {keyid}
|
|---|
| 18 | .SH "DESCRIPTION"
|
|---|
| 19 | .PP
|
|---|
| 20 | This tool is part of the
|
|---|
| 21 | \fBsamba\fR(7)
|
|---|
| 22 | suite\.
|
|---|
| 23 | .PP
|
|---|
| 24 | cifs\.upcall is a userspace helper program for the linux CIFS client filesystem\. There are a number of activities that the kernel cannot easily do itself\. This program is a callout program that does these things for the kernel and then returns the result\.
|
|---|
| 25 | .PP
|
|---|
| 26 | cifs\.upcall is generally intended to be run when the kernel calls request\-key(8)
|
|---|
| 27 | for a particular key type\. While it can be run directly from the command\-line, it\'s not generally intended to be run that way\.
|
|---|
| 28 | .SH "OPTIONS"
|
|---|
| 29 | .PP
|
|---|
| 30 | \-c
|
|---|
| 31 | .RS 4
|
|---|
| 32 | When handling a kerberos upcall, use a service principal that starts with "cifs/"\. The default is to use the "host/" service principal\.
|
|---|
| 33 | .RE
|
|---|
| 34 | .PP
|
|---|
| 35 | \-v
|
|---|
| 36 | .RS 4
|
|---|
| 37 | Print version number and exit\.
|
|---|
| 38 | .RE
|
|---|
| 39 | .SH "CONFIGURATION FOR KEYCTL"
|
|---|
| 40 | .PP
|
|---|
| 41 | cifs\.upcall is designed to be called from the kernel via the request\-key callout program\. This requres that request\-key be told where and how to call this program\. The current cifs\.upcall program handles two different key types:
|
|---|
| 42 | .PP
|
|---|
| 43 | cifs\.spnego
|
|---|
| 44 | .RS 4
|
|---|
| 45 | This keytype is for retrieving kerberos session keys
|
|---|
| 46 | .RE
|
|---|
| 47 | .PP
|
|---|
| 48 | dns_resolver
|
|---|
| 49 | .RS 4
|
|---|
| 50 | This key type is for resolving hostnames into IP addresses
|
|---|
| 51 | .RE
|
|---|
| 52 | .PP
|
|---|
| 53 | To make this program useful for CIFS, you\'ll need to set up entries for them in request\-key\.conf(5)\. Here\'s an example of an entry for each key type:
|
|---|
| 54 | .sp
|
|---|
| 55 | .RS 4
|
|---|
| 56 | .nf
|
|---|
| 57 | #OPERATION TYPE D C PROGRAM ARG1 ARG2\.\.\.
|
|---|
| 58 | #========= ============= = = ==========================================
|
|---|
| 59 | create cifs\.spnego * * /usr/local/sbin/cifs\.upcall \-c %k
|
|---|
| 60 | create dns_resolver * * /usr/local/sbin/cifs\.upcall %k
|
|---|
| 61 | .fi
|
|---|
| 62 | .RE
|
|---|
| 63 | .PP
|
|---|
| 64 | See
|
|---|
| 65 | \fBrequest-key.conf5\fR()
|
|---|
| 66 | for more info on each field\.
|
|---|
| 67 | .SH "SEE ALSO"
|
|---|
| 68 | .PP
|
|---|
| 69 |
|
|---|
| 70 | \fBrequest-key.conf\fR(5),
|
|---|
| 71 | \fBmount.cifs\fR(8)
|
|---|
| 72 | .SH "AUTHOR"
|
|---|
| 73 | .PP
|
|---|
| 74 | Igor Mammedov wrote the cifs\.upcall program\.
|
|---|
| 75 | .PP
|
|---|
| 76 | Jeff Layton authored this manpage\.
|
|---|
| 77 | .PP
|
|---|
| 78 | The maintainer of the Linux CIFS VFS is Steve French\.
|
|---|
| 79 | .PP
|
|---|
| 80 | The
|
|---|
| 81 | Linux CIFS Mailing list
|
|---|
| 82 | is the preferred place to ask questions regarding these programs\.
|
|---|
