4 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 2 only,
8 * as published by the Free Software Foundation.
10 * This program is distributed in the hope that it will be useful, but
11 * WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * General Public License version 2 for more details (a copy is included
14 * in the LICENSE file that accompanied this code).
16 * You should have received a copy of the GNU General Public License
17 * version 2 along with this program; If not, see
18 * http://www.gnu.org/licenses/gpl-2.0.html
23 * Copyright (c) 2014, Intel Corporation.
26 * lustre/osp/osp_trans.c
29 * 1. OSP (Object Storage Proxy) transaction methods
31 * Implement OSP layer transaction related interfaces for the dt_device API
32 * dt_device_operations.
35 * 2. Handle asynchronous idempotent operations
37 * The OSP uses OUT (Object Unified Target) RPC to talk with other server
38 * (MDT or OST) for kinds of operations, such as create, unlink, insert,
39 * delete, lookup, set_(x)attr, get_(x)attr, and etc. To reduce the number
40 * of RPCs, we allow multiple operations to be packaged together in single
43 * For the asynchronous idempotent operations, such as get_(x)attr, related
44 * RPCs will be inserted into an osp_device based shared asynchronous request
45 * queue - osp_device::opd_async_requests. When the queue is full, all the
46 * requests in the queue will be packaged into a single OUT RPC and given to
47 * the ptlrpcd daemon (for sending), then the queue is purged and other new
48 * requests can be inserted into it.
50 * When the asynchronous idempotent operation inserts the request into the
51 * shared queue, it will register an interpreter. When the packaged OUT RPC
52 * is replied (or failed to be sent out), all the registered interpreters
53 * will be called one by one to handle each own result.
56 * There are three kinds of transactions
58 * 1. Local transaction, all of updates of the transaction are in the local MDT.
59 * 2. Remote transaction, all of updates of the transaction are in one remote
60 * MDT, which only happens in LFSCK now.
61 * 3. Distribute transaction, updates for the transaction are in mulitple MDTs.
63 * Author: Di Wang <di.wang@intel.com>
64 * Author: Fan, Yong <fan.yong@intel.com>
67 #define DEBUG_SUBSYSTEM S_MDS
69 #include "osp_internal.h"
72 * The argument for the interpreter callback of osp request.
74 struct osp_update_args {
75 struct dt_update_request *oaua_update;
77 wait_queue_head_t *oaua_waitq;
78 bool oaua_flow_control;
82 * Call back for each update request.
84 struct osp_update_callback {
85 /* list in the dt_update_request::dur_cb_items */
86 struct list_head ouc_list;
88 /* The target of the async update request. */
89 struct osp_object *ouc_obj;
91 /* The data used by or_interpreter. */
94 /* The interpreter function called after the async request handled. */
95 osp_update_interpreter_t ouc_interpreter;
98 static struct object_update_request *object_update_request_alloc(size_t size)
100 struct object_update_request *ourq;
102 OBD_ALLOC_LARGE(ourq, size);
104 return ERR_PTR(-ENOMEM);
106 ourq->ourq_magic = UPDATE_REQUEST_MAGIC;
107 ourq->ourq_count = 0;
112 static void object_update_request_free(struct object_update_request *ourq,
116 OBD_FREE_LARGE(ourq, ourq_size);
120 * Allocate and initialize dt_update_request
122 * dt_update_request is being used to track updates being executed on
123 * this dt_device(OSD or OSP). The update buffer will be 4k initially,
124 * and increased if needed.
126 * \param [in] dt dt device
128 * \retval dt_update_request being allocated if succeed
129 * \retval ERR_PTR(errno) if failed
131 struct dt_update_request *dt_update_request_create(struct dt_device *dt)
133 struct dt_update_request *dt_update;
134 struct object_update_request *ourq;
136 OBD_ALLOC_PTR(dt_update);
137 if (dt_update == NULL)
138 return ERR_PTR(-ENOMEM);
140 ourq = object_update_request_alloc(OUT_UPDATE_INIT_BUFFER_SIZE);
142 OBD_FREE_PTR(dt_update);
143 return ERR_CAST(ourq);
146 dt_update->dur_buf.ub_req = ourq;
147 dt_update->dur_buf.ub_req_size = OUT_UPDATE_INIT_BUFFER_SIZE;
149 dt_update->dur_dt = dt;
150 dt_update->dur_batchid = 0;
151 INIT_LIST_HEAD(&dt_update->dur_cb_items);
157 * Destroy dt_update_request
159 * \param [in] dt_update dt_update_request being destroyed
161 void dt_update_request_destroy(struct dt_update_request *dt_update)
163 if (dt_update == NULL)
166 object_update_request_free(dt_update->dur_buf.ub_req,
167 dt_update->dur_buf.ub_req_size);
168 OBD_FREE_PTR(dt_update);
172 object_update_request_dump(const struct object_update_request *ourq,
176 size_t total_size = 0;
178 for (i = 0; i < ourq->ourq_count; i++) {
179 struct object_update *update;
182 update = object_update_request_get(ourq, i, &size);
183 LASSERT(update != NULL);
184 CDEBUG(mask, "i = %u fid = "DFID" op = %s master = %u"
185 "params = %d batchid = "LPU64" size = %zu\n",
186 i, PFID(&update->ou_fid),
187 update_op_str(update->ou_type),
188 update->ou_master_index, update->ou_params_count,
189 update->ou_batchid, size);
194 CDEBUG(mask, "updates = %p magic = %x count = %d size = %zu\n", ourq,
195 ourq->ourq_magic, ourq->ourq_count, total_size);
199 * Allocate an osp request and initialize it with the given parameters.
201 * \param[in] obj pointer to the operation target
202 * \param[in] data pointer to the data used by the interpreter
203 * \param[in] interpreter pointer to the interpreter function
205 * \retval pointer to the asychronous request
206 * \retval NULL if the allocation failed
208 static struct osp_update_callback *
209 osp_update_callback_init(struct osp_object *obj, void *data,
210 osp_update_interpreter_t interpreter)
212 struct osp_update_callback *ouc;
218 lu_object_get(osp2lu_obj(obj));
219 INIT_LIST_HEAD(&ouc->ouc_list);
221 ouc->ouc_data = data;
222 ouc->ouc_interpreter = interpreter;
228 * Destroy the osp_update_callback.
230 * \param[in] env pointer to the thread context
231 * \param[in] ouc pointer to osp_update_callback
233 static void osp_update_callback_fini(const struct lu_env *env,
234 struct osp_update_callback *ouc)
236 LASSERT(list_empty(&ouc->ouc_list));
238 lu_object_put(env, osp2lu_obj(ouc->ouc_obj));
243 * Interpret the packaged OUT RPC results.
245 * For every packaged sub-request, call its registered interpreter function.
246 * Then destroy the sub-request.
248 * \param[in] env pointer to the thread context
249 * \param[in] req pointer to the RPC
250 * \param[in] arg pointer to data used by the interpreter
251 * \param[in] rc the RPC return value
253 * \retval 0 for success
254 * \retval negative error number on failure
256 static int osp_update_interpret(const struct lu_env *env,
257 struct ptlrpc_request *req, void *arg, int rc)
259 struct object_update_reply *reply = NULL;
260 struct osp_update_args *oaua = arg;
261 struct dt_update_request *dt_update = oaua->oaua_update;
262 struct osp_update_callback *ouc;
263 struct osp_update_callback *next;
268 if (oaua->oaua_flow_control)
269 obd_put_request_slot(
270 &dt2osp_dev(dt_update->dur_dt)->opd_obd->u.cli);
272 /* Unpack the results from the reply message. */
273 if (req->rq_repmsg != NULL) {
274 reply = req_capsule_server_sized_get(&req->rq_pill,
275 &RMF_OUT_UPDATE_REPLY,
276 OUT_UPDATE_REPLY_SIZE);
277 if (reply == NULL || reply->ourp_magic != UPDATE_REPLY_MAGIC)
280 count = reply->ourp_count;
285 list_for_each_entry_safe(ouc, next, &dt_update->dur_cb_items,
287 list_del_init(&ouc->ouc_list);
289 /* The peer may only have handled some requests (indicated
290 * by the 'count') in the packaged OUT RPC, we can only get
291 * results for the handled part. */
292 if (index < count && reply->ourp_lens[index] > 0) {
293 struct object_update_result *result;
295 result = object_update_result_get(reply, index, NULL);
299 rc1 = result->our_rc;
302 if (unlikely(rc1 == 0))
306 if (ouc->ouc_interpreter != NULL)
307 ouc->ouc_interpreter(env, reply, req, ouc->ouc_obj,
308 ouc->ouc_data, index, rc1);
310 osp_update_callback_fini(env, ouc);
314 if (oaua->oaua_count != NULL && atomic_dec_and_test(oaua->oaua_count))
315 wake_up_all(oaua->oaua_waitq);
317 dt_update_request_destroy(dt_update);
323 * Pack all the requests in the shared asynchronous idempotent request queue
324 * into a single OUT RPC that will be given to the background ptlrpcd daemon.
326 * \param[in] env pointer to the thread context
327 * \param[in] osp pointer to the OSP device
328 * \param[in] update pointer to the shared queue
330 * \retval 0 for success
331 * \retval negative error number on failure
333 int osp_unplug_async_request(const struct lu_env *env,
334 struct osp_device *osp,
335 struct dt_update_request *update)
337 struct osp_update_args *args;
338 struct ptlrpc_request *req = NULL;
341 rc = osp_prep_update_req(env, osp->opd_obd->u.cli.cl_import,
342 update->dur_buf.ub_req, &req);
344 struct osp_update_callback *ouc;
345 struct osp_update_callback *next;
347 list_for_each_entry_safe(ouc, next,
348 &update->dur_cb_items, ouc_list) {
349 list_del_init(&ouc->ouc_list);
350 if (ouc->ouc_interpreter != NULL)
351 ouc->ouc_interpreter(env, NULL, NULL,
353 ouc->ouc_data, 0, rc);
354 osp_update_callback_fini(env, ouc);
356 dt_update_request_destroy(update);
358 args = ptlrpc_req_async_args(req);
359 args->oaua_update = update;
360 args->oaua_count = NULL;
361 args->oaua_waitq = NULL;
362 args->oaua_flow_control = false;
363 req->rq_interpret_reply = osp_update_interpret;
364 ptlrpcd_add_req(req, PDL_POLICY_LOCAL, -1);
371 * Find or create (if NOT exist or purged) the shared asynchronous idempotent
372 * request queue - osp_device::opd_async_requests.
374 * If the osp_device::opd_async_requests is not NULL, then return it directly;
375 * otherwise create new dt_update_request and attach it to opd_async_requests.
377 * \param[in] osp pointer to the OSP device
379 * \retval pointer to the shared queue
380 * \retval negative error number on failure
382 static struct dt_update_request *
383 osp_find_or_create_async_update_request(struct osp_device *osp)
385 struct dt_update_request *update = osp->opd_async_requests;
390 update = dt_update_request_create(&osp->opd_dt_dev);
392 osp->opd_async_requests = update;
398 * Insert an osp_update_callback into the dt_update_request.
400 * Insert an osp_update_callback to the dt_update_request. Usually each update
401 * in the dt_update_request will have one correspondent callback, and these
402 * callbacks will be called in rq_interpret_reply.
404 * \param[in] env pointer to the thread context
405 * \param[in] obj pointer to the operation target object
406 * \param[in] data pointer to the data used by the interpreter
407 * \param[in] interpreter pointer to the interpreter function
409 * \retval 0 for success
410 * \retval negative error number on failure
412 int osp_insert_update_callback(const struct lu_env *env,
413 struct dt_update_request *update,
414 struct osp_object *obj, void *data,
415 osp_update_interpreter_t interpreter)
417 struct osp_update_callback *ouc;
419 ouc = osp_update_callback_init(obj, data, interpreter);
423 list_add_tail(&ouc->ouc_list, &update->dur_cb_items);
429 * Insert an asynchronous idempotent request to the shared request queue that
430 * is attached to the osp_device.
432 * This function generates a new osp_async_request with the given parameters,
433 * then tries to insert the request into the osp_device-based shared request
434 * queue. If the queue is full, then triggers the packaged OUT RPC to purge
435 * the shared queue firstly, and then re-tries.
437 * NOTE: must hold the osp::opd_async_requests_mutex to serialize concurrent
438 * osp_insert_async_request call from others.
440 * \param[in] env pointer to the thread context
441 * \param[in] op operation type, see 'enum update_type'
442 * \param[in] obj pointer to the operation target
443 * \param[in] count array size of the subsequent \a lens and \a bufs
444 * \param[in] lens buffer length array for the subsequent \a bufs
445 * \param[in] bufs the buffers to compose the request
446 * \param[in] data pointer to the data used by the interpreter
447 * \param[in] interpreter pointer to the interpreter function
449 * \retval 0 for success
450 * \retval negative error number on failure
452 int osp_insert_async_request(const struct lu_env *env, enum update_type op,
453 struct osp_object *obj, int count,
454 __u16 *lens, const void **bufs, void *data,
455 osp_update_interpreter_t interpreter)
457 struct osp_device *osp = lu2osp_dev(osp2lu_obj(obj)->lo_dev);
458 struct dt_update_request *update;
459 struct object_update *object_update;
460 size_t max_update_size;
461 struct object_update_request *ureq;
465 update = osp_find_or_create_async_update_request(osp);
467 RETURN(PTR_ERR(update));
470 ureq = update->dur_buf.ub_req;
471 max_update_size = update->dur_buf.ub_req_size -
472 object_update_request_size(ureq);
474 object_update = update_buffer_get_update(ureq, ureq->ourq_count);
475 rc = out_update_pack(env, object_update, max_update_size, op,
476 lu_object_fid(osp2lu_obj(obj)), count, lens, bufs);
477 /* The queue is full. */
479 osp->opd_async_requests = NULL;
480 mutex_unlock(&osp->opd_async_requests_mutex);
482 rc = osp_unplug_async_request(env, osp, update);
483 mutex_lock(&osp->opd_async_requests_mutex);
487 update = osp_find_or_create_async_update_request(osp);
489 RETURN(PTR_ERR(update));
499 rc = osp_insert_update_callback(env, update, obj, data, interpreter);
504 int osp_trans_update_request_create(struct thandle *th)
506 struct osp_thandle *oth = thandle_to_osp_thandle(th);
507 struct dt_update_request *update;
509 if (oth->ot_dur != NULL)
512 update = dt_update_request_create(th->th_dev);
513 if (IS_ERR(update)) {
514 th->th_result = PTR_ERR(update);
515 return PTR_ERR(update);
518 if (dt2osp_dev(th->th_dev)->opd_connect_mdt)
519 update->dur_flags = UPDATE_FL_SYNC;
521 oth->ot_dur = update;
525 static void osp_thandle_get(struct osp_thandle *oth)
527 atomic_inc(&oth->ot_refcount);
530 static void osp_thandle_put(struct osp_thandle *oth)
532 if (atomic_dec_and_test(&oth->ot_refcount))
537 * The OSP layer dt_device_operations::dt_trans_create() interface
538 * to create a transaction.
540 * There are two kinds of transactions that will involve OSP:
542 * 1) If the transaction only contains the updates on remote server
543 * (MDT or OST), such as re-generating the lost OST-object for
544 * LFSCK, then it is a remote transaction. For remote transaction,
545 * the upper layer caller (such as the LFSCK engine) will call the
546 * dt_trans_create() (with the OSP dt_device as the parameter),
547 * then the call will be directed to the osp_trans_create() that
548 * creates the transaction handler and returns it to the caller.
550 * 2) If the transcation contains both local and remote updates,
551 * such as cross MDTs create under DNE mode, then the upper layer
552 * caller will not trigger osp_trans_create(). Instead, it will
553 * call dt_trans_create() on other dt_device, such as LOD that
554 * will generate the transaction handler. Such handler will be
555 * used by the whole transaction in subsequent sub-operations.
557 * \param[in] env pointer to the thread context
558 * \param[in] d pointer to the OSP dt_device
560 * \retval pointer to the transaction handler
561 * \retval negative error number on failure
563 struct thandle *osp_trans_create(const struct lu_env *env, struct dt_device *d)
565 struct osp_thandle *oth;
566 struct thandle *th = NULL;
570 if (unlikely(oth == NULL))
571 RETURN(ERR_PTR(-ENOMEM));
575 th->th_tags = LCT_TX_HANDLE;
577 atomic_set(&oth->ot_refcount, 1);
578 INIT_LIST_HEAD(&oth->ot_dcb_list);
584 * Prepare update request.
586 * Prepare OUT update ptlrpc request, and the request usually includes
587 * all of updates (stored in \param ureq) from one operation.
589 * \param[in] env execution environment
590 * \param[in] imp import on which ptlrpc request will be sent
591 * \param[in] ureq hold all of updates which will be packed into the req
592 * \param[in] reqp request to be created
594 * \retval 0 if preparation succeeds.
595 * \retval negative errno if preparation fails.
597 int osp_prep_update_req(const struct lu_env *env, struct obd_import *imp,
598 const struct object_update_request *ureq,
599 struct ptlrpc_request **reqp)
601 struct ptlrpc_request *req;
602 struct object_update_request *tmp;
607 object_update_request_dump(ureq, D_INFO);
608 req = ptlrpc_request_alloc(imp, &RQF_OUT_UPDATE);
612 ureq_len = object_update_request_size(ureq);
613 req_capsule_set_size(&req->rq_pill, &RMF_OUT_UPDATE, RCL_CLIENT,
616 rc = ptlrpc_request_pack(req, LUSTRE_MDS_VERSION, OUT_UPDATE);
618 ptlrpc_req_finished(req);
622 req_capsule_set_size(&req->rq_pill, &RMF_OUT_UPDATE_REPLY,
623 RCL_SERVER, OUT_UPDATE_REPLY_SIZE);
625 tmp = req_capsule_client_get(&req->rq_pill, &RMF_OUT_UPDATE);
626 memcpy(tmp, ureq, ureq_len);
628 ptlrpc_request_set_replen(req);
629 req->rq_request_portal = OUT_PORTAL;
630 req->rq_reply_portal = OSC_REPLY_PORTAL;
639 * Send update request to the remote MDT synchronously.
641 * \param[in] env execution environment
642 * \param[in] imp import on which ptlrpc request will be sent
643 * \param[in] dt_update hold all of updates which will be packed into the req
644 * \param[in] reqp request to be created
646 * \retval 0 if RPC succeeds.
647 * \retval negative errno if RPC fails.
649 int osp_remote_sync(const struct lu_env *env, struct osp_device *osp,
650 struct dt_update_request *dt_update,
651 struct ptlrpc_request **reqp)
653 struct obd_import *imp = osp->opd_obd->u.cli.cl_import;
654 struct ptlrpc_request *req = NULL;
658 rc = osp_prep_update_req(env, imp, dt_update->dur_buf.ub_req, &req);
662 /* This will only be called with read-only update, and these updates
663 * might be used to retrieve update log during recovery process, so
664 * it will be allowed to send during recovery process */
665 req->rq_allow_replay = 1;
667 /* Note: some dt index api might return non-zero result here, like
668 * osd_index_ea_lookup, so we should only check rc < 0 here */
669 rc = ptlrpc_queue_wait(req);
671 ptlrpc_req_finished(req);
672 dt_update->dur_rc = rc;
681 dt_update->dur_rc = rc;
683 ptlrpc_req_finished(req);
689 * Add commit callback to transaction.
691 * Add commit callback to the osp thandle, which will be called
692 * when the thandle is committed remotely.
694 * \param[in] th the thandle
695 * \param[in] dcb commit callback structure
697 * \retval only return 0 for now.
699 int osp_trans_cb_add(struct thandle *th, struct dt_txn_commit_cb *dcb)
701 struct osp_thandle *oth = thandle_to_osp_thandle(th);
703 LASSERT(dcb->dcb_magic == TRANS_COMMIT_CB_MAGIC);
704 LASSERT(&dcb->dcb_func != NULL);
705 list_add(&dcb->dcb_linkage, &oth->ot_dcb_list);
710 static void osp_trans_commit_cb(struct osp_thandle *oth, int result)
712 struct dt_txn_commit_cb *dcb;
713 struct dt_txn_commit_cb *tmp;
715 LASSERT(atomic_read(&oth->ot_refcount) > 0);
716 /* call per-transaction callbacks if any */
717 list_for_each_entry_safe(dcb, tmp, &oth->ot_dcb_list,
719 LASSERTF(dcb->dcb_magic == TRANS_COMMIT_CB_MAGIC,
720 "commit callback entry: magic=%x name='%s'\n",
721 dcb->dcb_magic, dcb->dcb_name);
722 list_del_init(&dcb->dcb_linkage);
723 dcb->dcb_func(NULL, &oth->ot_super, dcb, result);
727 static void osp_request_commit_cb(struct ptlrpc_request *req)
729 struct thandle *th = req->rq_cb_data;
730 struct osp_thandle *oth = thandle_to_osp_thandle(th);
731 __u64 last_committed_transno = 0;
732 int result = req->rq_status;
735 if (lustre_msg_get_last_committed(req->rq_repmsg))
736 last_committed_transno =
737 lustre_msg_get_last_committed(req->rq_repmsg);
739 if (last_committed_transno <
740 req->rq_import->imp_peer_committed_transno)
741 last_committed_transno =
742 req->rq_import->imp_peer_committed_transno;
744 CDEBUG(D_HA, "trans no "LPU64" committed transno "LPU64"\n",
745 req->rq_transno, last_committed_transno);
747 /* If the transaction is not really committed, mark result = 1 */
748 if (req->rq_transno != 0 &&
749 (req->rq_transno > last_committed_transno) && result == 0)
752 osp_trans_commit_cb(oth, result);
753 req->rq_committed = 1;
754 osp_thandle_put(oth);
759 * Trigger the request for remote updates.
761 * If th_sync is set, then the request will be sent synchronously,
762 * otherwise, the RPC will be sent asynchronously.
764 * Please refer to osp_trans_create() for transaction type.
766 * \param[in] env pointer to the thread context
767 * \param[in] osp pointer to the OSP device
768 * \param[in] dt_update pointer to the dt_update_request
769 * \param[in] th pointer to the transaction handler
770 * \param[out] sent whether the RPC has been sent
772 * \retval 0 for success
773 * \retval negative error number on failure
775 static int osp_trans_trigger(const struct lu_env *env, struct osp_device *osp,
776 struct dt_update_request *dt_update,
777 struct thandle *th, int *sent)
779 struct osp_update_args *args;
780 struct ptlrpc_request *req;
784 rc = osp_prep_update_req(env, osp->opd_obd->u.cli.cl_import,
785 dt_update->dur_buf.ub_req, &req);
790 req->rq_interpret_reply = osp_update_interpret;
791 args = ptlrpc_req_async_args(req);
792 args->oaua_update = dt_update;
794 if (!th->th_wait_submit && is_only_remote_trans(th) && !th->th_sync) {
795 args->oaua_flow_control = true;
797 if (!osp->opd_connect_mdt) {
798 down_read(&osp->opd_async_updates_rwsem);
799 args->oaua_count = &osp->opd_async_updates_count;
800 args->oaua_waitq = &osp->opd_syn_barrier_waitq;
801 up_read(&osp->opd_async_updates_rwsem);
802 atomic_inc(args->oaua_count);
805 ptlrpcd_add_req(req, PDL_POLICY_LOCAL, -1);
807 struct osp_thandle *oth = thandle_to_osp_thandle(th);
808 struct lu_device *top_device;
810 /* If the transaction is created during MDT recoverying
811 * process, it means this is an recovery update, we need
812 * to let OSP send it anyway without checking recoverying
813 * status, in case the other target is being recoveried
814 * at the same time, and if we wait here for the import
815 * to be recoveryed, it might cause deadlock */
816 top_device = osp->opd_dt_dev.dd_lu_dev.ld_site->ls_top_dev;
817 if (top_device->ld_obd->obd_recovering)
818 req->rq_allow_replay = 1;
820 args->oaua_flow_control = false;
821 req->rq_commit_cb = osp_request_commit_cb;
822 req->rq_cb_data = th;
823 osp_thandle_get(oth); /* for commit callback */
824 osp_get_rpc_lock(osp);
825 rc = ptlrpc_queue_wait(req);
826 osp_put_rpc_lock(osp);
827 if (req->rq_transno == 0 && !req->rq_committed)
828 osp_thandle_put(oth);
831 ptlrpc_req_finished(req);
838 * Get local thandle for osp_thandle
840 * Get the local OSD thandle from the OSP thandle. Currently, there
841 * are a few OSP API (osp_object_create() and osp_sync_add()) needs
842 * to update the object on local OSD device.
844 * If the osp_thandle comes from normal stack (MDD->LOD->OSP), then
845 * we will get local thandle by thandle_get_sub_by_dt.
847 * If the osp_thandle is remote thandle (th_top == NULL, only used
848 * by LFSCK), then it will create a local thandle, and stop it in
849 * osp_trans_stop(). And this only happens on OSP for OST.
851 * These are temporary solution, once OSP accessing OSD object is
852 * being fixed properly, this function should be removed. XXX
854 * \param[in] env pointer to the thread context
855 * \param[in] th pointer to the transaction handler
856 * \param[in] dt pointer to the OSP device
858 * \retval pointer to the local thandle
859 * \retval ERR_PTR(errno) if it fails.
861 struct thandle *osp_get_storage_thandle(const struct lu_env *env,
863 struct osp_device *osp)
865 struct osp_thandle *oth;
866 struct thandle *local_th;
868 if (th->th_top != NULL)
869 return thandle_get_sub_by_dt(env, th->th_top,
872 LASSERT(!osp->opd_connect_mdt);
873 oth = thandle_to_osp_thandle(th);
874 if (oth->ot_storage_th != NULL)
875 return oth->ot_storage_th;
877 local_th = dt_trans_create(env, osp->opd_storage);
878 if (IS_ERR(local_th))
881 oth->ot_storage_th = local_th;
887 * The OSP layer dt_device_operations::dt_trans_start() interface
888 * to start the transaction.
890 * If the transaction is a remote transaction, then related remote
891 * updates will be triggered in the osp_trans_stop().
892 * Please refer to osp_trans_create() for transaction type.
894 * \param[in] env pointer to the thread context
895 * \param[in] dt pointer to the OSP dt_device
896 * \param[in] th pointer to the transaction handler
898 * \retval 0 for success
899 * \retval negative error number on failure
901 int osp_trans_start(const struct lu_env *env, struct dt_device *dt,
904 struct osp_thandle *oth = thandle_to_osp_thandle(th);
906 /* For remote thandle, if there are local thandle, start it here*/
907 if (is_only_remote_trans(th) && oth->ot_storage_th != NULL)
908 return dt_trans_start(env, oth->ot_storage_th->th_dev,
914 * The OSP layer dt_device_operations::dt_trans_stop() interface
915 * to stop the transaction.
917 * If the transaction is a remote transaction, related remote
918 * updates will be triggered here via osp_trans_trigger().
920 * For synchronous mode update or any failed update, the request
921 * will be destroyed explicitly when the osp_trans_stop().
923 * Please refer to osp_trans_create() for transaction type.
925 * \param[in] env pointer to the thread context
926 * \param[in] dt pointer to the OSP dt_device
927 * \param[in] th pointer to the transaction handler
929 * \retval 0 for success
930 * \retval negative error number on failure
932 int osp_trans_stop(const struct lu_env *env, struct dt_device *dt,
935 struct osp_thandle *oth = thandle_to_osp_thandle(th);
936 struct dt_update_request *dt_update;
941 /* For remote transaction, if there is local storage thandle,
943 if (oth->ot_storage_th != NULL && th->th_top == NULL) {
944 dt_trans_stop(env, oth->ot_storage_th->th_dev,
946 oth->ot_storage_th = NULL;
949 dt_update = oth->ot_dur;
950 if (dt_update == NULL || th->th_result != 0) {
955 LASSERT(dt_update != LP_POISON);
957 /* If there are no updates, destroy dt_update and thandle */
958 if (dt_update->dur_buf.ub_req == NULL ||
959 dt_update->dur_buf.ub_req->ourq_count == 0)
962 if (is_only_remote_trans(th) && !th->th_sync) {
963 struct osp_device *osp = dt2osp_dev(th->th_dev);
964 struct client_obd *cli = &osp->opd_obd->u.cli;
966 rc = obd_get_request_slot(cli);
970 if (!osp->opd_imp_active || !osp->opd_imp_connected) {
971 obd_put_request_slot(cli);
972 GOTO(out, rc = -ENOTCONN);
975 rc = osp_trans_trigger(env, dt2osp_dev(dt),
976 dt_update, th, &sent);
978 obd_put_request_slot(cli);
980 rc = osp_trans_trigger(env, dt2osp_dev(dt), dt_update,
985 /* If RPC is triggered successfully, dt_update will be freed in
986 * osp_update_interpreter() */
988 struct osp_update_callback *ouc;
989 struct osp_update_callback *next;
991 if (dt_update != NULL) {
992 list_for_each_entry_safe(ouc, next,
993 &dt_update->dur_cb_items,
995 list_del_init(&ouc->ouc_list);
996 if (ouc->ouc_interpreter != NULL)
997 ouc->ouc_interpreter(env, NULL, NULL,
1001 osp_update_callback_fini(env, ouc);
1004 osp_trans_commit_cb(oth, rc);
1005 dt_update_request_destroy(dt_update);
1009 osp_thandle_put(oth);