13 .Nm k_afs_cell_of_file
18 .Fn k_afsklog "char *cell" "char *realm"
20 .Fn k_afsklog_uid "char *cell" "char *realm" "uid_t uid"
22 .Fn k_afs_cell_of_file "const char *path" "char *cell" "int len"
26 .Fn k_pioctl "char *a_path" "int o_opcode" "struct ViceIoctl *a_paramsP" "int a_followSymlinks"
33 initializes some library internal structures, and tests for the
34 presense of AFS in the kernel, none of the other functions should be
37 is called, or if it fails.
42 obtains new tokens (and possibly tickets) for the specified
50 the local cell is used. If
54 the function tries to guess what realm to use. Unless you have some good knowledge of what cell or realm to use, you should pass
57 will use the real user-id for the
64 .Fn k_afs_cell_of_file
67 return the cell of a specified file, no more than
75 syscall with the specified arguments. This function is equivalent to
79 initializes a new PAG.
82 removes destroys all tokens in the current PAG.
86 returns 1 if AFS is present in the kernel, 0 otherwise.
90 returns 0 on success, or a kerberos error number on failure.
91 .Fn k_afs_cell_of_file ,
96 all return the value of the underlaying system call, 0 on success.
98 The following code from
100 will obtain a new PAG and tokens for the local cell and the cell of
101 the users home directory.
106 if(k_afs_cell_of_file(pwd->pw_dir, cell, sizeof(cell)) == 0)
112 If any of these functions (appart from
114 is called without AFS beeing present in the kernel, the process will
115 usually (depending on the operating system) receive a SIGSYS signal.
118 .%A Transarc Corporation
119 .%J AFS-3 Programmer's Reference
120 .%T File Server/Cache Manager Interface