clnt.c 31 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292
  1. /*
  2. * linux/net/sunrpc/clnt.c
  3. *
  4. * This file contains the high-level RPC interface.
  5. * It is modeled as a finite state machine to support both synchronous
  6. * and asynchronous requests.
  7. *
  8. * - RPC header generation and argument serialization.
  9. * - Credential refresh.
  10. * - TCP connect handling.
  11. * - Retry of operation when it is suspected the operation failed because
  12. * of uid squashing on the server, or when the credentials were stale
  13. * and need to be refreshed, or when a packet was damaged in transit.
  14. * This may be have to be moved to the VFS layer.
  15. *
  16. * NB: BSD uses a more intelligent approach to guessing when a request
  17. * or reply has been lost by keeping the RTO estimate for each procedure.
  18. * We currently make do with a constant timeout value.
  19. *
  20. * Copyright (C) 1992,1993 Rick Sladkey <jrs@world.std.com>
  21. * Copyright (C) 1995,1996 Olaf Kirch <okir@monad.swb.de>
  22. */
  23. #include <asm/system.h>
  24. #include <linux/module.h>
  25. #include <linux/types.h>
  26. #include <linux/mm.h>
  27. #include <linux/slab.h>
  28. #include <linux/utsname.h>
  29. #include <linux/sunrpc/clnt.h>
  30. #include <linux/workqueue.h>
  31. #include <linux/sunrpc/rpc_pipe_fs.h>
  32. #include <linux/nfs.h>
  33. #define RPC_SLACK_SPACE (1024) /* total overkill */
  34. #ifdef RPC_DEBUG
  35. # define RPCDBG_FACILITY RPCDBG_CALL
  36. #endif
  37. static DECLARE_WAIT_QUEUE_HEAD(destroy_wait);
  38. static void call_start(struct rpc_task *task);
  39. static void call_reserve(struct rpc_task *task);
  40. static void call_reserveresult(struct rpc_task *task);
  41. static void call_allocate(struct rpc_task *task);
  42. static void call_encode(struct rpc_task *task);
  43. static void call_decode(struct rpc_task *task);
  44. static void call_bind(struct rpc_task *task);
  45. static void call_bind_status(struct rpc_task *task);
  46. static void call_transmit(struct rpc_task *task);
  47. static void call_status(struct rpc_task *task);
  48. static void call_transmit_status(struct rpc_task *task);
  49. static void call_refresh(struct rpc_task *task);
  50. static void call_refreshresult(struct rpc_task *task);
  51. static void call_timeout(struct rpc_task *task);
  52. static void call_connect(struct rpc_task *task);
  53. static void call_connect_status(struct rpc_task *task);
  54. static u32 * call_header(struct rpc_task *task);
  55. static u32 * call_verify(struct rpc_task *task);
  56. static int
  57. rpc_setup_pipedir(struct rpc_clnt *clnt, char *dir_name)
  58. {
  59. static uint32_t clntid;
  60. int error;
  61. if (dir_name == NULL)
  62. return 0;
  63. for (;;) {
  64. snprintf(clnt->cl_pathname, sizeof(clnt->cl_pathname),
  65. "%s/clnt%x", dir_name,
  66. (unsigned int)clntid++);
  67. clnt->cl_pathname[sizeof(clnt->cl_pathname) - 1] = '\0';
  68. clnt->cl_dentry = rpc_mkdir(clnt->cl_pathname, clnt);
  69. if (!IS_ERR(clnt->cl_dentry))
  70. return 0;
  71. error = PTR_ERR(clnt->cl_dentry);
  72. if (error != -EEXIST) {
  73. printk(KERN_INFO "RPC: Couldn't create pipefs entry %s, error %d\n",
  74. clnt->cl_pathname, error);
  75. return error;
  76. }
  77. }
  78. }
  79. /*
  80. * Create an RPC client
  81. * FIXME: This should also take a flags argument (as in task->tk_flags).
  82. * It's called (among others) from pmap_create_client, which may in
  83. * turn be called by an async task. In this case, rpciod should not be
  84. * made to sleep too long.
  85. */
  86. struct rpc_clnt *
  87. rpc_new_client(struct rpc_xprt *xprt, char *servname,
  88. struct rpc_program *program, u32 vers,
  89. rpc_authflavor_t flavor)
  90. {
  91. struct rpc_version *version;
  92. struct rpc_clnt *clnt = NULL;
  93. struct rpc_auth *auth;
  94. int err;
  95. int len;
  96. dprintk("RPC: creating %s client for %s (xprt %p)\n",
  97. program->name, servname, xprt);
  98. err = -EINVAL;
  99. if (!xprt)
  100. goto out_no_xprt;
  101. if (vers >= program->nrvers || !(version = program->version[vers]))
  102. goto out_err;
  103. err = -ENOMEM;
  104. clnt = kmalloc(sizeof(*clnt), GFP_KERNEL);
  105. if (!clnt)
  106. goto out_err;
  107. memset(clnt, 0, sizeof(*clnt));
  108. atomic_set(&clnt->cl_users, 0);
  109. atomic_set(&clnt->cl_count, 1);
  110. clnt->cl_parent = clnt;
  111. clnt->cl_server = clnt->cl_inline_name;
  112. len = strlen(servname) + 1;
  113. if (len > sizeof(clnt->cl_inline_name)) {
  114. char *buf = kmalloc(len, GFP_KERNEL);
  115. if (buf != 0)
  116. clnt->cl_server = buf;
  117. else
  118. len = sizeof(clnt->cl_inline_name);
  119. }
  120. strlcpy(clnt->cl_server, servname, len);
  121. clnt->cl_xprt = xprt;
  122. clnt->cl_procinfo = version->procs;
  123. clnt->cl_maxproc = version->nrprocs;
  124. clnt->cl_protname = program->name;
  125. clnt->cl_pmap = &clnt->cl_pmap_default;
  126. clnt->cl_port = xprt->addr.sin_port;
  127. clnt->cl_prog = program->number;
  128. clnt->cl_vers = version->number;
  129. clnt->cl_prot = xprt->prot;
  130. clnt->cl_stats = program->stats;
  131. rpc_init_wait_queue(&clnt->cl_pmap_default.pm_bindwait, "bindwait");
  132. if (!clnt->cl_port)
  133. clnt->cl_autobind = 1;
  134. clnt->cl_rtt = &clnt->cl_rtt_default;
  135. rpc_init_rtt(&clnt->cl_rtt_default, xprt->timeout.to_initval);
  136. err = rpc_setup_pipedir(clnt, program->pipe_dir_name);
  137. if (err < 0)
  138. goto out_no_path;
  139. auth = rpcauth_create(flavor, clnt);
  140. if (IS_ERR(auth)) {
  141. printk(KERN_INFO "RPC: Couldn't create auth handle (flavor %u)\n",
  142. flavor);
  143. err = PTR_ERR(auth);
  144. goto out_no_auth;
  145. }
  146. /* save the nodename */
  147. clnt->cl_nodelen = strlen(system_utsname.nodename);
  148. if (clnt->cl_nodelen > UNX_MAXNODENAME)
  149. clnt->cl_nodelen = UNX_MAXNODENAME;
  150. memcpy(clnt->cl_nodename, system_utsname.nodename, clnt->cl_nodelen);
  151. return clnt;
  152. out_no_auth:
  153. rpc_rmdir(clnt->cl_pathname);
  154. out_no_path:
  155. if (clnt->cl_server != clnt->cl_inline_name)
  156. kfree(clnt->cl_server);
  157. kfree(clnt);
  158. out_err:
  159. xprt_destroy(xprt);
  160. out_no_xprt:
  161. return ERR_PTR(err);
  162. }
  163. /**
  164. * Create an RPC client
  165. * @xprt - pointer to xprt struct
  166. * @servname - name of server
  167. * @info - rpc_program
  168. * @version - rpc_program version
  169. * @authflavor - rpc_auth flavour to use
  170. *
  171. * Creates an RPC client structure, then pings the server in order to
  172. * determine if it is up, and if it supports this program and version.
  173. *
  174. * This function should never be called by asynchronous tasks such as
  175. * the portmapper.
  176. */
  177. struct rpc_clnt *rpc_create_client(struct rpc_xprt *xprt, char *servname,
  178. struct rpc_program *info, u32 version, rpc_authflavor_t authflavor)
  179. {
  180. struct rpc_clnt *clnt;
  181. int err;
  182. clnt = rpc_new_client(xprt, servname, info, version, authflavor);
  183. if (IS_ERR(clnt))
  184. return clnt;
  185. err = rpc_ping(clnt, RPC_TASK_SOFT|RPC_TASK_NOINTR);
  186. if (err == 0)
  187. return clnt;
  188. rpc_shutdown_client(clnt);
  189. return ERR_PTR(err);
  190. }
  191. /*
  192. * This function clones the RPC client structure. It allows us to share the
  193. * same transport while varying parameters such as the authentication
  194. * flavour.
  195. */
  196. struct rpc_clnt *
  197. rpc_clone_client(struct rpc_clnt *clnt)
  198. {
  199. struct rpc_clnt *new;
  200. new = kmalloc(sizeof(*new), GFP_KERNEL);
  201. if (!new)
  202. goto out_no_clnt;
  203. memcpy(new, clnt, sizeof(*new));
  204. atomic_set(&new->cl_count, 1);
  205. atomic_set(&new->cl_users, 0);
  206. new->cl_parent = clnt;
  207. atomic_inc(&clnt->cl_count);
  208. /* Duplicate portmapper */
  209. rpc_init_wait_queue(&new->cl_pmap_default.pm_bindwait, "bindwait");
  210. /* Turn off autobind on clones */
  211. new->cl_autobind = 0;
  212. new->cl_oneshot = 0;
  213. new->cl_dead = 0;
  214. rpc_init_rtt(&new->cl_rtt_default, clnt->cl_xprt->timeout.to_initval);
  215. if (new->cl_auth)
  216. atomic_inc(&new->cl_auth->au_count);
  217. new->cl_pmap = &new->cl_pmap_default;
  218. rpc_init_wait_queue(&new->cl_pmap_default.pm_bindwait, "bindwait");
  219. return new;
  220. out_no_clnt:
  221. printk(KERN_INFO "RPC: out of memory in %s\n", __FUNCTION__);
  222. return ERR_PTR(-ENOMEM);
  223. }
  224. /*
  225. * Properly shut down an RPC client, terminating all outstanding
  226. * requests. Note that we must be certain that cl_oneshot and
  227. * cl_dead are cleared, or else the client would be destroyed
  228. * when the last task releases it.
  229. */
  230. int
  231. rpc_shutdown_client(struct rpc_clnt *clnt)
  232. {
  233. dprintk("RPC: shutting down %s client for %s, tasks=%d\n",
  234. clnt->cl_protname, clnt->cl_server,
  235. atomic_read(&clnt->cl_users));
  236. while (atomic_read(&clnt->cl_users) > 0) {
  237. /* Don't let rpc_release_client destroy us */
  238. clnt->cl_oneshot = 0;
  239. clnt->cl_dead = 0;
  240. rpc_killall_tasks(clnt);
  241. wait_event_timeout(destroy_wait,
  242. !atomic_read(&clnt->cl_users), 1*HZ);
  243. }
  244. if (atomic_read(&clnt->cl_users) < 0) {
  245. printk(KERN_ERR "RPC: rpc_shutdown_client clnt %p tasks=%d\n",
  246. clnt, atomic_read(&clnt->cl_users));
  247. #ifdef RPC_DEBUG
  248. rpc_show_tasks();
  249. #endif
  250. BUG();
  251. }
  252. return rpc_destroy_client(clnt);
  253. }
  254. /*
  255. * Delete an RPC client
  256. */
  257. int
  258. rpc_destroy_client(struct rpc_clnt *clnt)
  259. {
  260. if (!atomic_dec_and_test(&clnt->cl_count))
  261. return 1;
  262. BUG_ON(atomic_read(&clnt->cl_users) != 0);
  263. dprintk("RPC: destroying %s client for %s\n",
  264. clnt->cl_protname, clnt->cl_server);
  265. if (clnt->cl_auth) {
  266. rpcauth_destroy(clnt->cl_auth);
  267. clnt->cl_auth = NULL;
  268. }
  269. if (clnt->cl_parent != clnt) {
  270. rpc_destroy_client(clnt->cl_parent);
  271. goto out_free;
  272. }
  273. if (clnt->cl_pathname[0])
  274. rpc_rmdir(clnt->cl_pathname);
  275. if (clnt->cl_xprt) {
  276. xprt_destroy(clnt->cl_xprt);
  277. clnt->cl_xprt = NULL;
  278. }
  279. if (clnt->cl_server != clnt->cl_inline_name)
  280. kfree(clnt->cl_server);
  281. out_free:
  282. kfree(clnt);
  283. return 0;
  284. }
  285. /*
  286. * Release an RPC client
  287. */
  288. void
  289. rpc_release_client(struct rpc_clnt *clnt)
  290. {
  291. dprintk("RPC: rpc_release_client(%p, %d)\n",
  292. clnt, atomic_read(&clnt->cl_users));
  293. if (!atomic_dec_and_test(&clnt->cl_users))
  294. return;
  295. wake_up(&destroy_wait);
  296. if (clnt->cl_oneshot || clnt->cl_dead)
  297. rpc_destroy_client(clnt);
  298. }
  299. /**
  300. * rpc_bind_new_program - bind a new RPC program to an existing client
  301. * @old - old rpc_client
  302. * @program - rpc program to set
  303. * @vers - rpc program version
  304. *
  305. * Clones the rpc client and sets up a new RPC program. This is mainly
  306. * of use for enabling different RPC programs to share the same transport.
  307. * The Sun NFSv2/v3 ACL protocol can do this.
  308. */
  309. struct rpc_clnt *rpc_bind_new_program(struct rpc_clnt *old,
  310. struct rpc_program *program,
  311. int vers)
  312. {
  313. struct rpc_clnt *clnt;
  314. struct rpc_version *version;
  315. int err;
  316. BUG_ON(vers >= program->nrvers || !program->version[vers]);
  317. version = program->version[vers];
  318. clnt = rpc_clone_client(old);
  319. if (IS_ERR(clnt))
  320. goto out;
  321. clnt->cl_procinfo = version->procs;
  322. clnt->cl_maxproc = version->nrprocs;
  323. clnt->cl_protname = program->name;
  324. clnt->cl_prog = program->number;
  325. clnt->cl_vers = version->number;
  326. clnt->cl_stats = program->stats;
  327. err = rpc_ping(clnt, RPC_TASK_SOFT|RPC_TASK_NOINTR);
  328. if (err != 0) {
  329. rpc_shutdown_client(clnt);
  330. clnt = ERR_PTR(err);
  331. }
  332. out:
  333. return clnt;
  334. }
  335. /*
  336. * Default callback for async RPC calls
  337. */
  338. static void
  339. rpc_default_callback(struct rpc_task *task, void *data)
  340. {
  341. }
  342. static const struct rpc_call_ops rpc_default_ops = {
  343. .rpc_call_done = rpc_default_callback,
  344. };
  345. /*
  346. * Export the signal mask handling for synchronous code that
  347. * sleeps on RPC calls
  348. */
  349. #define RPC_INTR_SIGNALS (sigmask(SIGHUP) | sigmask(SIGINT) | sigmask(SIGQUIT) | sigmask(SIGTERM))
  350. static void rpc_save_sigmask(sigset_t *oldset, int intr)
  351. {
  352. unsigned long sigallow = sigmask(SIGKILL);
  353. sigset_t sigmask;
  354. /* Block all signals except those listed in sigallow */
  355. if (intr)
  356. sigallow |= RPC_INTR_SIGNALS;
  357. siginitsetinv(&sigmask, sigallow);
  358. sigprocmask(SIG_BLOCK, &sigmask, oldset);
  359. }
  360. static inline void rpc_task_sigmask(struct rpc_task *task, sigset_t *oldset)
  361. {
  362. rpc_save_sigmask(oldset, !RPC_TASK_UNINTERRUPTIBLE(task));
  363. }
  364. static inline void rpc_restore_sigmask(sigset_t *oldset)
  365. {
  366. sigprocmask(SIG_SETMASK, oldset, NULL);
  367. }
  368. void rpc_clnt_sigmask(struct rpc_clnt *clnt, sigset_t *oldset)
  369. {
  370. rpc_save_sigmask(oldset, clnt->cl_intr);
  371. }
  372. void rpc_clnt_sigunmask(struct rpc_clnt *clnt, sigset_t *oldset)
  373. {
  374. rpc_restore_sigmask(oldset);
  375. }
  376. /*
  377. * New rpc_call implementation
  378. */
  379. int rpc_call_sync(struct rpc_clnt *clnt, struct rpc_message *msg, int flags)
  380. {
  381. struct rpc_task *task;
  382. sigset_t oldset;
  383. int status;
  384. /* If this client is slain all further I/O fails */
  385. if (clnt->cl_dead)
  386. return -EIO;
  387. BUG_ON(flags & RPC_TASK_ASYNC);
  388. status = -ENOMEM;
  389. task = rpc_new_task(clnt, flags, &rpc_default_ops, NULL);
  390. if (task == NULL)
  391. goto out;
  392. /* Mask signals on RPC calls _and_ GSS_AUTH upcalls */
  393. rpc_task_sigmask(task, &oldset);
  394. rpc_call_setup(task, msg, 0);
  395. /* Set up the call info struct and execute the task */
  396. status = task->tk_status;
  397. if (status == 0) {
  398. atomic_inc(&task->tk_count);
  399. status = rpc_execute(task);
  400. if (status == 0)
  401. status = task->tk_status;
  402. }
  403. rpc_restore_sigmask(&oldset);
  404. rpc_release_task(task);
  405. out:
  406. return status;
  407. }
  408. /*
  409. * New rpc_call implementation
  410. */
  411. int
  412. rpc_call_async(struct rpc_clnt *clnt, struct rpc_message *msg, int flags,
  413. const struct rpc_call_ops *tk_ops, void *data)
  414. {
  415. struct rpc_task *task;
  416. sigset_t oldset;
  417. int status;
  418. /* If this client is slain all further I/O fails */
  419. if (clnt->cl_dead)
  420. return -EIO;
  421. flags |= RPC_TASK_ASYNC;
  422. /* Create/initialize a new RPC task */
  423. status = -ENOMEM;
  424. if (!(task = rpc_new_task(clnt, flags, tk_ops, data)))
  425. goto out;
  426. /* Mask signals on GSS_AUTH upcalls */
  427. rpc_task_sigmask(task, &oldset);
  428. rpc_call_setup(task, msg, 0);
  429. /* Set up the call info struct and execute the task */
  430. status = task->tk_status;
  431. if (status == 0)
  432. rpc_execute(task);
  433. else
  434. rpc_release_task(task);
  435. rpc_restore_sigmask(&oldset);
  436. out:
  437. return status;
  438. }
  439. void
  440. rpc_call_setup(struct rpc_task *task, struct rpc_message *msg, int flags)
  441. {
  442. task->tk_msg = *msg;
  443. task->tk_flags |= flags;
  444. /* Bind the user cred */
  445. if (task->tk_msg.rpc_cred != NULL)
  446. rpcauth_holdcred(task);
  447. else
  448. rpcauth_bindcred(task);
  449. if (task->tk_status == 0)
  450. task->tk_action = call_start;
  451. else
  452. task->tk_action = rpc_exit_task;
  453. }
  454. void
  455. rpc_setbufsize(struct rpc_clnt *clnt, unsigned int sndsize, unsigned int rcvsize)
  456. {
  457. struct rpc_xprt *xprt = clnt->cl_xprt;
  458. if (xprt->ops->set_buffer_size)
  459. xprt->ops->set_buffer_size(xprt, sndsize, rcvsize);
  460. }
  461. /*
  462. * Return size of largest payload RPC client can support, in bytes
  463. *
  464. * For stream transports, this is one RPC record fragment (see RFC
  465. * 1831), as we don't support multi-record requests yet. For datagram
  466. * transports, this is the size of an IP packet minus the IP, UDP, and
  467. * RPC header sizes.
  468. */
  469. size_t rpc_max_payload(struct rpc_clnt *clnt)
  470. {
  471. return clnt->cl_xprt->max_payload;
  472. }
  473. EXPORT_SYMBOL(rpc_max_payload);
  474. /**
  475. * rpc_force_rebind - force transport to check that remote port is unchanged
  476. * @clnt: client to rebind
  477. *
  478. */
  479. void rpc_force_rebind(struct rpc_clnt *clnt)
  480. {
  481. if (clnt->cl_autobind)
  482. clnt->cl_port = 0;
  483. }
  484. EXPORT_SYMBOL(rpc_force_rebind);
  485. /*
  486. * Restart an (async) RPC call. Usually called from within the
  487. * exit handler.
  488. */
  489. void
  490. rpc_restart_call(struct rpc_task *task)
  491. {
  492. if (RPC_ASSASSINATED(task))
  493. return;
  494. task->tk_action = call_start;
  495. }
  496. /*
  497. * 0. Initial state
  498. *
  499. * Other FSM states can be visited zero or more times, but
  500. * this state is visited exactly once for each RPC.
  501. */
  502. static void
  503. call_start(struct rpc_task *task)
  504. {
  505. struct rpc_clnt *clnt = task->tk_client;
  506. dprintk("RPC: %4d call_start %s%d proc %d (%s)\n", task->tk_pid,
  507. clnt->cl_protname, clnt->cl_vers, task->tk_msg.rpc_proc->p_proc,
  508. (RPC_IS_ASYNC(task) ? "async" : "sync"));
  509. /* Increment call count */
  510. task->tk_msg.rpc_proc->p_count++;
  511. clnt->cl_stats->rpccnt++;
  512. task->tk_action = call_reserve;
  513. }
  514. /*
  515. * 1. Reserve an RPC call slot
  516. */
  517. static void
  518. call_reserve(struct rpc_task *task)
  519. {
  520. dprintk("RPC: %4d call_reserve\n", task->tk_pid);
  521. if (!rpcauth_uptodatecred(task)) {
  522. task->tk_action = call_refresh;
  523. return;
  524. }
  525. task->tk_status = 0;
  526. task->tk_action = call_reserveresult;
  527. xprt_reserve(task);
  528. }
  529. /*
  530. * 1b. Grok the result of xprt_reserve()
  531. */
  532. static void
  533. call_reserveresult(struct rpc_task *task)
  534. {
  535. int status = task->tk_status;
  536. dprintk("RPC: %4d call_reserveresult (status %d)\n",
  537. task->tk_pid, task->tk_status);
  538. /*
  539. * After a call to xprt_reserve(), we must have either
  540. * a request slot or else an error status.
  541. */
  542. task->tk_status = 0;
  543. if (status >= 0) {
  544. if (task->tk_rqstp) {
  545. task->tk_action = call_allocate;
  546. return;
  547. }
  548. printk(KERN_ERR "%s: status=%d, but no request slot, exiting\n",
  549. __FUNCTION__, status);
  550. rpc_exit(task, -EIO);
  551. return;
  552. }
  553. /*
  554. * Even though there was an error, we may have acquired
  555. * a request slot somehow. Make sure not to leak it.
  556. */
  557. if (task->tk_rqstp) {
  558. printk(KERN_ERR "%s: status=%d, request allocated anyway\n",
  559. __FUNCTION__, status);
  560. xprt_release(task);
  561. }
  562. switch (status) {
  563. case -EAGAIN: /* woken up; retry */
  564. task->tk_action = call_reserve;
  565. return;
  566. case -EIO: /* probably a shutdown */
  567. break;
  568. default:
  569. printk(KERN_ERR "%s: unrecognized error %d, exiting\n",
  570. __FUNCTION__, status);
  571. break;
  572. }
  573. rpc_exit(task, status);
  574. }
  575. /*
  576. * 2. Allocate the buffer. For details, see sched.c:rpc_malloc.
  577. * (Note: buffer memory is freed in xprt_release).
  578. */
  579. static void
  580. call_allocate(struct rpc_task *task)
  581. {
  582. struct rpc_rqst *req = task->tk_rqstp;
  583. struct rpc_xprt *xprt = task->tk_xprt;
  584. unsigned int bufsiz;
  585. dprintk("RPC: %4d call_allocate (status %d)\n",
  586. task->tk_pid, task->tk_status);
  587. task->tk_action = call_bind;
  588. if (req->rq_buffer)
  589. return;
  590. /* FIXME: compute buffer requirements more exactly using
  591. * auth->au_wslack */
  592. bufsiz = task->tk_msg.rpc_proc->p_bufsiz + RPC_SLACK_SPACE;
  593. if (xprt->ops->buf_alloc(task, bufsiz << 1) != NULL)
  594. return;
  595. printk(KERN_INFO "RPC: buffer allocation failed for task %p\n", task);
  596. if (RPC_IS_ASYNC(task) || !signalled()) {
  597. xprt_release(task);
  598. task->tk_action = call_reserve;
  599. rpc_delay(task, HZ>>4);
  600. return;
  601. }
  602. rpc_exit(task, -ERESTARTSYS);
  603. }
  604. static inline int
  605. rpc_task_need_encode(struct rpc_task *task)
  606. {
  607. return task->tk_rqstp->rq_snd_buf.len == 0;
  608. }
  609. static inline void
  610. rpc_task_force_reencode(struct rpc_task *task)
  611. {
  612. task->tk_rqstp->rq_snd_buf.len = 0;
  613. }
  614. /*
  615. * 3. Encode arguments of an RPC call
  616. */
  617. static void
  618. call_encode(struct rpc_task *task)
  619. {
  620. struct rpc_rqst *req = task->tk_rqstp;
  621. struct xdr_buf *sndbuf = &req->rq_snd_buf;
  622. struct xdr_buf *rcvbuf = &req->rq_rcv_buf;
  623. unsigned int bufsiz;
  624. kxdrproc_t encode;
  625. u32 *p;
  626. dprintk("RPC: %4d call_encode (status %d)\n",
  627. task->tk_pid, task->tk_status);
  628. /* Default buffer setup */
  629. bufsiz = req->rq_bufsize >> 1;
  630. sndbuf->head[0].iov_base = (void *)req->rq_buffer;
  631. sndbuf->head[0].iov_len = bufsiz;
  632. sndbuf->tail[0].iov_len = 0;
  633. sndbuf->page_len = 0;
  634. sndbuf->len = 0;
  635. sndbuf->buflen = bufsiz;
  636. rcvbuf->head[0].iov_base = (void *)((char *)req->rq_buffer + bufsiz);
  637. rcvbuf->head[0].iov_len = bufsiz;
  638. rcvbuf->tail[0].iov_len = 0;
  639. rcvbuf->page_len = 0;
  640. rcvbuf->len = 0;
  641. rcvbuf->buflen = bufsiz;
  642. /* Encode header and provided arguments */
  643. encode = task->tk_msg.rpc_proc->p_encode;
  644. if (!(p = call_header(task))) {
  645. printk(KERN_INFO "RPC: call_header failed, exit EIO\n");
  646. rpc_exit(task, -EIO);
  647. return;
  648. }
  649. if (encode == NULL)
  650. return;
  651. task->tk_status = rpcauth_wrap_req(task, encode, req, p,
  652. task->tk_msg.rpc_argp);
  653. if (task->tk_status == -ENOMEM) {
  654. /* XXX: Is this sane? */
  655. rpc_delay(task, 3*HZ);
  656. task->tk_status = -EAGAIN;
  657. }
  658. }
  659. /*
  660. * 4. Get the server port number if not yet set
  661. */
  662. static void
  663. call_bind(struct rpc_task *task)
  664. {
  665. struct rpc_clnt *clnt = task->tk_client;
  666. dprintk("RPC: %4d call_bind (status %d)\n",
  667. task->tk_pid, task->tk_status);
  668. task->tk_action = call_connect;
  669. if (!clnt->cl_port) {
  670. task->tk_action = call_bind_status;
  671. task->tk_timeout = task->tk_xprt->bind_timeout;
  672. rpc_getport(task, clnt);
  673. }
  674. }
  675. /*
  676. * 4a. Sort out bind result
  677. */
  678. static void
  679. call_bind_status(struct rpc_task *task)
  680. {
  681. int status = -EACCES;
  682. if (task->tk_status >= 0) {
  683. dprintk("RPC: %4d call_bind_status (status %d)\n",
  684. task->tk_pid, task->tk_status);
  685. task->tk_status = 0;
  686. task->tk_action = call_connect;
  687. return;
  688. }
  689. switch (task->tk_status) {
  690. case -EACCES:
  691. dprintk("RPC: %4d remote rpcbind: RPC program/version unavailable\n",
  692. task->tk_pid);
  693. rpc_delay(task, 3*HZ);
  694. goto retry_bind;
  695. case -ETIMEDOUT:
  696. dprintk("RPC: %4d rpcbind request timed out\n",
  697. task->tk_pid);
  698. if (RPC_IS_SOFT(task)) {
  699. status = -EIO;
  700. break;
  701. }
  702. goto retry_bind;
  703. case -EPFNOSUPPORT:
  704. dprintk("RPC: %4d remote rpcbind service unavailable\n",
  705. task->tk_pid);
  706. break;
  707. case -EPROTONOSUPPORT:
  708. dprintk("RPC: %4d remote rpcbind version 2 unavailable\n",
  709. task->tk_pid);
  710. break;
  711. default:
  712. dprintk("RPC: %4d unrecognized rpcbind error (%d)\n",
  713. task->tk_pid, -task->tk_status);
  714. status = -EIO;
  715. break;
  716. }
  717. rpc_exit(task, status);
  718. return;
  719. retry_bind:
  720. task->tk_status = 0;
  721. task->tk_action = call_bind;
  722. return;
  723. }
  724. /*
  725. * 4b. Connect to the RPC server
  726. */
  727. static void
  728. call_connect(struct rpc_task *task)
  729. {
  730. struct rpc_xprt *xprt = task->tk_xprt;
  731. dprintk("RPC: %4d call_connect xprt %p %s connected\n",
  732. task->tk_pid, xprt,
  733. (xprt_connected(xprt) ? "is" : "is not"));
  734. task->tk_action = call_transmit;
  735. if (!xprt_connected(xprt)) {
  736. task->tk_action = call_connect_status;
  737. if (task->tk_status < 0)
  738. return;
  739. xprt_connect(task);
  740. }
  741. }
  742. /*
  743. * 4c. Sort out connect result
  744. */
  745. static void
  746. call_connect_status(struct rpc_task *task)
  747. {
  748. struct rpc_clnt *clnt = task->tk_client;
  749. int status = task->tk_status;
  750. dprintk("RPC: %5u call_connect_status (status %d)\n",
  751. task->tk_pid, task->tk_status);
  752. task->tk_status = 0;
  753. if (status >= 0) {
  754. clnt->cl_stats->netreconn++;
  755. task->tk_action = call_transmit;
  756. return;
  757. }
  758. /* Something failed: remote service port may have changed */
  759. rpc_force_rebind(clnt);
  760. switch (status) {
  761. case -ENOTCONN:
  762. case -ETIMEDOUT:
  763. case -EAGAIN:
  764. task->tk_action = call_bind;
  765. break;
  766. default:
  767. rpc_exit(task, -EIO);
  768. break;
  769. }
  770. }
  771. /*
  772. * 5. Transmit the RPC request, and wait for reply
  773. */
  774. static void
  775. call_transmit(struct rpc_task *task)
  776. {
  777. dprintk("RPC: %4d call_transmit (status %d)\n",
  778. task->tk_pid, task->tk_status);
  779. task->tk_action = call_status;
  780. if (task->tk_status < 0)
  781. return;
  782. task->tk_status = xprt_prepare_transmit(task);
  783. if (task->tk_status != 0)
  784. return;
  785. /* Encode here so that rpcsec_gss can use correct sequence number. */
  786. if (rpc_task_need_encode(task)) {
  787. task->tk_rqstp->rq_bytes_sent = 0;
  788. call_encode(task);
  789. /* Did the encode result in an error condition? */
  790. if (task->tk_status != 0)
  791. goto out_nosend;
  792. }
  793. task->tk_action = call_transmit_status;
  794. xprt_transmit(task);
  795. if (task->tk_status < 0)
  796. return;
  797. if (!task->tk_msg.rpc_proc->p_decode) {
  798. task->tk_action = rpc_exit_task;
  799. rpc_wake_up_task(task);
  800. }
  801. return;
  802. out_nosend:
  803. /* release socket write lock before attempting to handle error */
  804. xprt_abort_transmit(task);
  805. rpc_task_force_reencode(task);
  806. }
  807. /*
  808. * 6. Sort out the RPC call status
  809. */
  810. static void
  811. call_status(struct rpc_task *task)
  812. {
  813. struct rpc_clnt *clnt = task->tk_client;
  814. struct rpc_rqst *req = task->tk_rqstp;
  815. int status;
  816. if (req->rq_received > 0 && !req->rq_bytes_sent)
  817. task->tk_status = req->rq_received;
  818. dprintk("RPC: %4d call_status (status %d)\n",
  819. task->tk_pid, task->tk_status);
  820. status = task->tk_status;
  821. if (status >= 0) {
  822. task->tk_action = call_decode;
  823. return;
  824. }
  825. task->tk_status = 0;
  826. switch(status) {
  827. case -ETIMEDOUT:
  828. task->tk_action = call_timeout;
  829. break;
  830. case -ECONNREFUSED:
  831. case -ENOTCONN:
  832. rpc_force_rebind(clnt);
  833. task->tk_action = call_bind;
  834. break;
  835. case -EAGAIN:
  836. task->tk_action = call_transmit;
  837. break;
  838. case -EIO:
  839. /* shutdown or soft timeout */
  840. rpc_exit(task, status);
  841. break;
  842. default:
  843. printk("%s: RPC call returned error %d\n",
  844. clnt->cl_protname, -status);
  845. rpc_exit(task, status);
  846. break;
  847. }
  848. }
  849. /*
  850. * 6a. Handle transmission errors.
  851. */
  852. static void
  853. call_transmit_status(struct rpc_task *task)
  854. {
  855. if (task->tk_status != -EAGAIN)
  856. rpc_task_force_reencode(task);
  857. call_status(task);
  858. }
  859. /*
  860. * 6b. Handle RPC timeout
  861. * We do not release the request slot, so we keep using the
  862. * same XID for all retransmits.
  863. */
  864. static void
  865. call_timeout(struct rpc_task *task)
  866. {
  867. struct rpc_clnt *clnt = task->tk_client;
  868. if (xprt_adjust_timeout(task->tk_rqstp) == 0) {
  869. dprintk("RPC: %4d call_timeout (minor)\n", task->tk_pid);
  870. goto retry;
  871. }
  872. dprintk("RPC: %4d call_timeout (major)\n", task->tk_pid);
  873. if (RPC_IS_SOFT(task)) {
  874. printk(KERN_NOTICE "%s: server %s not responding, timed out\n",
  875. clnt->cl_protname, clnt->cl_server);
  876. rpc_exit(task, -EIO);
  877. return;
  878. }
  879. if (!(task->tk_flags & RPC_CALL_MAJORSEEN)) {
  880. task->tk_flags |= RPC_CALL_MAJORSEEN;
  881. printk(KERN_NOTICE "%s: server %s not responding, still trying\n",
  882. clnt->cl_protname, clnt->cl_server);
  883. }
  884. rpc_force_rebind(clnt);
  885. retry:
  886. clnt->cl_stats->rpcretrans++;
  887. task->tk_action = call_bind;
  888. task->tk_status = 0;
  889. }
  890. /*
  891. * 7. Decode the RPC reply
  892. */
  893. static void
  894. call_decode(struct rpc_task *task)
  895. {
  896. struct rpc_clnt *clnt = task->tk_client;
  897. struct rpc_rqst *req = task->tk_rqstp;
  898. kxdrproc_t decode = task->tk_msg.rpc_proc->p_decode;
  899. u32 *p;
  900. dprintk("RPC: %4d call_decode (status %d)\n",
  901. task->tk_pid, task->tk_status);
  902. if (task->tk_flags & RPC_CALL_MAJORSEEN) {
  903. printk(KERN_NOTICE "%s: server %s OK\n",
  904. clnt->cl_protname, clnt->cl_server);
  905. task->tk_flags &= ~RPC_CALL_MAJORSEEN;
  906. }
  907. if (task->tk_status < 12) {
  908. if (!RPC_IS_SOFT(task)) {
  909. task->tk_action = call_bind;
  910. clnt->cl_stats->rpcretrans++;
  911. goto out_retry;
  912. }
  913. printk(KERN_WARNING "%s: too small RPC reply size (%d bytes)\n",
  914. clnt->cl_protname, task->tk_status);
  915. rpc_exit(task, -EIO);
  916. return;
  917. }
  918. req->rq_rcv_buf.len = req->rq_private_buf.len;
  919. /* Check that the softirq receive buffer is valid */
  920. WARN_ON(memcmp(&req->rq_rcv_buf, &req->rq_private_buf,
  921. sizeof(req->rq_rcv_buf)) != 0);
  922. /* Verify the RPC header */
  923. p = call_verify(task);
  924. if (IS_ERR(p)) {
  925. if (p == ERR_PTR(-EAGAIN))
  926. goto out_retry;
  927. return;
  928. }
  929. task->tk_action = rpc_exit_task;
  930. if (decode)
  931. task->tk_status = rpcauth_unwrap_resp(task, decode, req, p,
  932. task->tk_msg.rpc_resp);
  933. dprintk("RPC: %4d call_decode result %d\n", task->tk_pid,
  934. task->tk_status);
  935. return;
  936. out_retry:
  937. req->rq_received = req->rq_private_buf.len = 0;
  938. task->tk_status = 0;
  939. }
  940. /*
  941. * 8. Refresh the credentials if rejected by the server
  942. */
  943. static void
  944. call_refresh(struct rpc_task *task)
  945. {
  946. dprintk("RPC: %4d call_refresh\n", task->tk_pid);
  947. xprt_release(task); /* Must do to obtain new XID */
  948. task->tk_action = call_refreshresult;
  949. task->tk_status = 0;
  950. task->tk_client->cl_stats->rpcauthrefresh++;
  951. rpcauth_refreshcred(task);
  952. }
  953. /*
  954. * 8a. Process the results of a credential refresh
  955. */
  956. static void
  957. call_refreshresult(struct rpc_task *task)
  958. {
  959. int status = task->tk_status;
  960. dprintk("RPC: %4d call_refreshresult (status %d)\n",
  961. task->tk_pid, task->tk_status);
  962. task->tk_status = 0;
  963. task->tk_action = call_reserve;
  964. if (status >= 0 && rpcauth_uptodatecred(task))
  965. return;
  966. if (status == -EACCES) {
  967. rpc_exit(task, -EACCES);
  968. return;
  969. }
  970. task->tk_action = call_refresh;
  971. if (status != -ETIMEDOUT)
  972. rpc_delay(task, 3*HZ);
  973. return;
  974. }
  975. /*
  976. * Call header serialization
  977. */
  978. static u32 *
  979. call_header(struct rpc_task *task)
  980. {
  981. struct rpc_clnt *clnt = task->tk_client;
  982. struct rpc_rqst *req = task->tk_rqstp;
  983. u32 *p = req->rq_svec[0].iov_base;
  984. /* FIXME: check buffer size? */
  985. p = xprt_skip_transport_header(task->tk_xprt, p);
  986. *p++ = req->rq_xid; /* XID */
  987. *p++ = htonl(RPC_CALL); /* CALL */
  988. *p++ = htonl(RPC_VERSION); /* RPC version */
  989. *p++ = htonl(clnt->cl_prog); /* program number */
  990. *p++ = htonl(clnt->cl_vers); /* program version */
  991. *p++ = htonl(task->tk_msg.rpc_proc->p_proc); /* procedure */
  992. p = rpcauth_marshcred(task, p);
  993. req->rq_slen = xdr_adjust_iovec(&req->rq_svec[0], p);
  994. return p;
  995. }
  996. /*
  997. * Reply header verification
  998. */
  999. static u32 *
  1000. call_verify(struct rpc_task *task)
  1001. {
  1002. struct kvec *iov = &task->tk_rqstp->rq_rcv_buf.head[0];
  1003. int len = task->tk_rqstp->rq_rcv_buf.len >> 2;
  1004. u32 *p = iov->iov_base, n;
  1005. int error = -EACCES;
  1006. if ((len -= 3) < 0)
  1007. goto out_overflow;
  1008. p += 1; /* skip XID */
  1009. if ((n = ntohl(*p++)) != RPC_REPLY) {
  1010. printk(KERN_WARNING "call_verify: not an RPC reply: %x\n", n);
  1011. goto out_garbage;
  1012. }
  1013. if ((n = ntohl(*p++)) != RPC_MSG_ACCEPTED) {
  1014. if (--len < 0)
  1015. goto out_overflow;
  1016. switch ((n = ntohl(*p++))) {
  1017. case RPC_AUTH_ERROR:
  1018. break;
  1019. case RPC_MISMATCH:
  1020. dprintk("%s: RPC call version mismatch!\n", __FUNCTION__);
  1021. error = -EPROTONOSUPPORT;
  1022. goto out_err;
  1023. default:
  1024. dprintk("%s: RPC call rejected, unknown error: %x\n", __FUNCTION__, n);
  1025. goto out_eio;
  1026. }
  1027. if (--len < 0)
  1028. goto out_overflow;
  1029. switch ((n = ntohl(*p++))) {
  1030. case RPC_AUTH_REJECTEDCRED:
  1031. case RPC_AUTH_REJECTEDVERF:
  1032. case RPCSEC_GSS_CREDPROBLEM:
  1033. case RPCSEC_GSS_CTXPROBLEM:
  1034. if (!task->tk_cred_retry)
  1035. break;
  1036. task->tk_cred_retry--;
  1037. dprintk("RPC: %4d call_verify: retry stale creds\n",
  1038. task->tk_pid);
  1039. rpcauth_invalcred(task);
  1040. task->tk_action = call_refresh;
  1041. goto out_retry;
  1042. case RPC_AUTH_BADCRED:
  1043. case RPC_AUTH_BADVERF:
  1044. /* possibly garbled cred/verf? */
  1045. if (!task->tk_garb_retry)
  1046. break;
  1047. task->tk_garb_retry--;
  1048. dprintk("RPC: %4d call_verify: retry garbled creds\n",
  1049. task->tk_pid);
  1050. task->tk_action = call_bind;
  1051. goto out_retry;
  1052. case RPC_AUTH_TOOWEAK:
  1053. printk(KERN_NOTICE "call_verify: server requires stronger "
  1054. "authentication.\n");
  1055. break;
  1056. default:
  1057. printk(KERN_WARNING "call_verify: unknown auth error: %x\n", n);
  1058. error = -EIO;
  1059. }
  1060. dprintk("RPC: %4d call_verify: call rejected %d\n",
  1061. task->tk_pid, n);
  1062. goto out_err;
  1063. }
  1064. if (!(p = rpcauth_checkverf(task, p))) {
  1065. printk(KERN_WARNING "call_verify: auth check failed\n");
  1066. goto out_garbage; /* bad verifier, retry */
  1067. }
  1068. len = p - (u32 *)iov->iov_base - 1;
  1069. if (len < 0)
  1070. goto out_overflow;
  1071. switch ((n = ntohl(*p++))) {
  1072. case RPC_SUCCESS:
  1073. return p;
  1074. case RPC_PROG_UNAVAIL:
  1075. dprintk("RPC: call_verify: program %u is unsupported by server %s\n",
  1076. (unsigned int)task->tk_client->cl_prog,
  1077. task->tk_client->cl_server);
  1078. error = -EPFNOSUPPORT;
  1079. goto out_err;
  1080. case RPC_PROG_MISMATCH:
  1081. dprintk("RPC: call_verify: program %u, version %u unsupported by server %s\n",
  1082. (unsigned int)task->tk_client->cl_prog,
  1083. (unsigned int)task->tk_client->cl_vers,
  1084. task->tk_client->cl_server);
  1085. error = -EPROTONOSUPPORT;
  1086. goto out_err;
  1087. case RPC_PROC_UNAVAIL:
  1088. dprintk("RPC: call_verify: proc %p unsupported by program %u, version %u on server %s\n",
  1089. task->tk_msg.rpc_proc,
  1090. task->tk_client->cl_prog,
  1091. task->tk_client->cl_vers,
  1092. task->tk_client->cl_server);
  1093. error = -EOPNOTSUPP;
  1094. goto out_err;
  1095. case RPC_GARBAGE_ARGS:
  1096. dprintk("RPC: %4d %s: server saw garbage\n", task->tk_pid, __FUNCTION__);
  1097. break; /* retry */
  1098. default:
  1099. printk(KERN_WARNING "call_verify: server accept status: %x\n", n);
  1100. /* Also retry */
  1101. }
  1102. out_garbage:
  1103. task->tk_client->cl_stats->rpcgarbage++;
  1104. if (task->tk_garb_retry) {
  1105. task->tk_garb_retry--;
  1106. dprintk("RPC %s: retrying %4d\n", __FUNCTION__, task->tk_pid);
  1107. task->tk_action = call_bind;
  1108. out_retry:
  1109. return ERR_PTR(-EAGAIN);
  1110. }
  1111. printk(KERN_WARNING "RPC %s: retry failed, exit EIO\n", __FUNCTION__);
  1112. out_eio:
  1113. error = -EIO;
  1114. out_err:
  1115. rpc_exit(task, error);
  1116. return ERR_PTR(error);
  1117. out_overflow:
  1118. printk(KERN_WARNING "RPC %s: server reply was truncated.\n", __FUNCTION__);
  1119. goto out_garbage;
  1120. }
  1121. static int rpcproc_encode_null(void *rqstp, u32 *data, void *obj)
  1122. {
  1123. return 0;
  1124. }
  1125. static int rpcproc_decode_null(void *rqstp, u32 *data, void *obj)
  1126. {
  1127. return 0;
  1128. }
  1129. static struct rpc_procinfo rpcproc_null = {
  1130. .p_encode = rpcproc_encode_null,
  1131. .p_decode = rpcproc_decode_null,
  1132. };
  1133. int rpc_ping(struct rpc_clnt *clnt, int flags)
  1134. {
  1135. struct rpc_message msg = {
  1136. .rpc_proc = &rpcproc_null,
  1137. };
  1138. int err;
  1139. msg.rpc_cred = authnull_ops.lookup_cred(NULL, NULL, 0);
  1140. err = rpc_call_sync(clnt, &msg, flags);
  1141. put_rpccred(msg.rpc_cred);
  1142. return err;
  1143. }