clnt.c 31 KB

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