fop.c

Go to the documentation of this file.

/* -*- C -*- */
/*
 * Copyright (c) 2021 Seagate Technology LLC and/or its Affiliates
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * For any questions about this software or licensing,
 * please email opensource@seagate.com or cortx-questions@seagate.com.
 *
 */


#define M0_TRACE_SUBSYSTEM M0_TRACE_SUBSYS_DTM0
#include "lib/trace.h"         /* M0_LOG */
#include "cas/cas.h"
#include "cas/cas_xc.h"
#include "dtm0/fop.h"
#include "dtm0/fop_xc.h"
#include "dtm0/addb2.h"
#include "dtm0/drlink.h"       /* m0_dtm0_req_post */
#include "dtm0/service.h"      /* m0_dtm0_service */
#include "be/dtm0_log.h"       /* m0_be_dtm0_log_* */
#include "be/queue.h"          /* M0_BE_QUEUE_PUT */
#include "fop/fom_generic.h"   /* M0_FOPH_* */
#include "lib/assert.h"
#include "lib/errno.h"
#include "lib/memory.h"
#include "lib/misc.h"          /* M0_IN() */
#include "reqh/reqh.h"         /* reqh::rh_beseg */
#include "rpc/rpc_opcodes.h"   /* M0_DTM0_REP_OPCODE */

struct m0_fop_type dtm0_req_fop_fopt;
struct m0_fop_type dtm0_rep_fop_fopt;
struct m0_fop_type dtm0_redo_fop_fopt;

struct dtm0_fom {
        struct m0_fom           dtf_fom;
        struct m0_fom_thralldom dtf_thrall;
        int                     dtf_thrall_rc;
};

static int dtm0_emsg_fom_tick(struct m0_fom *fom);
static int dtm0_pmsg_fom_tick(struct m0_fom *fom);
static int dtm0_rmsg_fom_tick(struct m0_fom *fom);
static int dtm0_tmsg_fom_tick(struct m0_fom *fom);
static int dtm0_fom_create(struct m0_fop *fop, struct m0_fom **out,
                               struct m0_reqh *reqh);
static void dtm0_fom_fini(struct m0_fom *fom);
static size_t dtm0_fom_locality(const struct m0_fom *fom);
static int dtm0_cas_fop_prepare(struct dtm0_req_fop *req,
                                struct m0_fop_type  *cas_fopt,
                                struct m0_fop      **cas_fop_out);
static int dtm0_cas_fom_spawn(
        struct dtm0_fom *dfom,
        struct m0_fop   *cas_fop,
        void           (*on_cas_fom_complete)(struct m0_fom_thralldom *,
                                              struct m0_fom           *));

static const struct m0_fom_ops dtm0_pmsg_fom_ops = {
        .fo_fini = dtm0_fom_fini,
        .fo_tick = dtm0_pmsg_fom_tick,
        .fo_home_locality = dtm0_fom_locality
};

static const struct m0_fom_ops dtm0_rmsg_fom_ops = {
        .fo_fini = dtm0_fom_fini,
        .fo_tick = dtm0_rmsg_fom_tick,
        .fo_home_locality = dtm0_fom_locality
};

static const struct m0_fom_ops dtm0_emsg_fom_ops = {
        .fo_fini = dtm0_fom_fini,
        .fo_tick = dtm0_emsg_fom_tick,
        .fo_home_locality = dtm0_fom_locality
};

static const struct m0_fom_ops dtm0_tmsg_fom_ops = {
        .fo_fini = dtm0_fom_fini,
        .fo_tick = dtm0_tmsg_fom_tick,
        .fo_home_locality = dtm0_fom_locality
};

extern struct m0_reqh_service_type dtm0_service_type;

static const struct m0_fom_type_ops dtm0_req_fom_type_ops = {
        .fto_create = dtm0_fom_create,
};

M0_INTERNAL void m0_dtm0_fop_fini(void)
{
        m0_fop_type_fini(&dtm0_req_fop_fopt);
        m0_fop_type_fini(&dtm0_rep_fop_fopt);
        m0_fop_type_fini(&dtm0_redo_fop_fopt);
        m0_xc_dtm0_fop_fini();
}

enum {
        M0_FOPH_DTM0_ENTRY = M0_FOPH_TYPE_SPECIFIC,
        M0_FOPH_DTM0_LOGGING,
        M0_FOPH_DTM0_TO_CAS,
        M0_FOPH_DTM0_CAS_DONE
};

struct m0_sm_state_descr dtm0_phases[] = {
        [M0_FOPH_DTM0_ENTRY] = {
                .sd_name      = "dtm0-entry",
                .sd_allowed   = M0_BITS(M0_FOPH_DTM0_LOGGING,
                                        M0_FOPH_DTM0_TO_CAS,
                                        M0_FOPH_SUCCESS,
                                        M0_FOPH_FAILURE)
        },
        [M0_FOPH_DTM0_LOGGING] = {
                .sd_name      = "logging",
                .sd_allowed   = M0_BITS(M0_FOPH_SUCCESS,
                                        M0_FOPH_FAILURE)
        },
        [M0_FOPH_DTM0_TO_CAS] = {
                .sd_name      = "dtm0-to-cas",
                .sd_allowed   = M0_BITS(M0_FOPH_DTM0_CAS_DONE,
                                        M0_FOPH_FAILURE)
        },
        [M0_FOPH_DTM0_CAS_DONE] = {
                .sd_name      = "cas-done",
                .sd_allowed   = M0_BITS(M0_FOPH_SUCCESS,
                                        M0_FOPH_FAILURE)
        },
};

struct m0_sm_trans_descr dtm0_phases_trans[] = {
        [ARRAY_SIZE(m0_generic_phases_trans)] =
        {"dtm0-entry-fail", M0_FOPH_DTM0_ENTRY, M0_FOPH_FAILURE},
        {"dtm0-entry-success", M0_FOPH_DTM0_ENTRY, M0_FOPH_SUCCESS},

        {"dtm0-logging", M0_FOPH_DTM0_ENTRY, M0_FOPH_DTM0_LOGGING},
        {"dtm0-logging-fail", M0_FOPH_DTM0_LOGGING, M0_FOPH_FAILURE},
        {"dtm0-logging-success", M0_FOPH_DTM0_LOGGING, M0_FOPH_SUCCESS},

        {"dtm0-to-cas", M0_FOPH_DTM0_ENTRY, M0_FOPH_DTM0_TO_CAS},

        {"dtm0-to-cas-fail", M0_FOPH_DTM0_TO_CAS, M0_FOPH_FAILURE},
        {"dtm0-cas-done", M0_FOPH_DTM0_TO_CAS, M0_FOPH_DTM0_CAS_DONE},

        {"dtm0-cas-success", M0_FOPH_DTM0_CAS_DONE, M0_FOPH_SUCCESS},
        {"dtm0-cas-fail", M0_FOPH_DTM0_CAS_DONE, M0_FOPH_FAILURE},
};

static struct m0_sm_conf dtm0_conf = {
        .scf_name      = "dtm0-fom",
        .scf_nr_states = ARRAY_SIZE(dtm0_phases),
        .scf_state     = dtm0_phases,
        .scf_trans_nr  = ARRAY_SIZE(dtm0_phases_trans),
        .scf_trans     = dtm0_phases_trans,
};

M0_INTERNAL int m0_dtm0_fop_init(void)
{
        static int init_once = 0;

        if (init_once++ > 0)
                return 0;

        m0_sm_conf_extend(m0_generic_conf.scf_state, dtm0_phases,
                          m0_generic_conf.scf_nr_states);
        m0_sm_conf_trans_extend(&m0_generic_conf, &dtm0_conf);
        m0_sm_conf_init(&dtm0_conf);


        m0_xc_dtm0_fop_init();
        M0_FOP_TYPE_INIT(&dtm0_req_fop_fopt,
                         .name      = "DTM0 request",
                         .opcode    = M0_DTM0_REQ_OPCODE,
                         .xt        = dtm0_req_fop_xc,
                         .rpc_flags = M0_RPC_MUTABO_REQ,
                         .fom_ops   = &dtm0_req_fom_type_ops,
                         .sm        = &dtm0_conf,
                         .svc_type  = &dtm0_service_type);
        M0_FOP_TYPE_INIT(&dtm0_redo_fop_fopt,
                         .name      = "DTM0 redo",
                         .opcode    = M0_DTM0_REDO_OPCODE,
                         .xt        = dtm0_req_fop_xc,
                         .rpc_flags = M0_RPC_ITEM_TYPE_REQUEST,
                         .fom_ops   = &dtm0_req_fom_type_ops,
                         .sm        = &dtm0_conf,
                         .svc_type  = &dtm0_service_type);
        M0_FOP_TYPE_INIT(&dtm0_rep_fop_fopt,
                         .name      = "DTM0 reply",
                         .opcode    = M0_DTM0_REP_OPCODE,
                         .xt        = dtm0_rep_fop_xc,
                         .rpc_flags = M0_RPC_ITEM_TYPE_REPLY,
                         .fom_ops   = &dtm0_req_fom_type_ops);

        return m0_fop_type_addb2_instrument(&dtm0_req_fop_fopt) ?:
                m0_fop_type_addb2_instrument(&dtm0_redo_fop_fopt);
}


/*
  Allocates a fom.
 */
static int dtm0_fom_create(struct m0_fop *fop,
                           struct m0_fom **out,
                           struct m0_reqh *reqh)
{
        struct dtm0_fom         *fom;
        struct m0_fop           *repfop;
        struct dtm0_rep_fop     *reply;
        struct dtm0_req_fop     *req;
        struct m0_dtm0_pmsg_ast *pma;
        int                      rc;

        M0_ENTRY("reqh=%p", reqh);

        M0_ALLOC_PTR(fom);
        M0_ALLOC_PTR(pma);
        repfop = m0_fop_reply_alloc(fop, &dtm0_rep_fop_fopt);

        if (fom == NULL || repfop == NULL || pma == NULL) {
                m0_free(pma);
                m0_free(repfop);
                m0_free(fom);
                return M0_ERR(-ENOMEM);
        }

        *out = &fom->dtf_fom;

        /* TODO: calculate credits for the operation. */

        /* see ::m0_dtm0_dtx_post_persistent for the details */
        fop->f_opaque = pma;
        reply = m0_fop_data(repfop);
        req   = m0_fop_data(fop);
        reply->dr_txr = (struct m0_dtm0_tx_desc) {};
        reply->dr_rc = 0;

        /* TODO avoid copy-paste */
        if (req->dtr_msg == DTM_EXECUTE) {
                M0_ASSERT_INFO(m0_dtm0_in_ut(), "Emsg FOM is only for UTs.");
                rc = m0_dtm0_tx_desc_copy(&req->dtr_txr, &reply->dr_txr);
                M0_ASSERT(rc == 0);
                m0_fom_init(&fom->dtf_fom, &fop->f_type->ft_fom_type,
                            &dtm0_emsg_fom_ops, fop, repfop, reqh);
        } else if (req->dtr_msg == DTM_PERSISTENT) {
                m0_fom_init(&fom->dtf_fom, &fop->f_type->ft_fom_type,
                            &dtm0_pmsg_fom_ops, fop, repfop, reqh);
        } else if (req->dtr_msg == DTM_REDO) {
                m0_fom_init(&fom->dtf_fom, &fop->f_type->ft_fom_type,
                            &dtm0_rmsg_fom_ops, fop, repfop, reqh);
        } else if (req->dtr_msg == DTM_TEST) {
                m0_fom_init(&fom->dtf_fom, &fop->f_type->ft_fom_type,
                            &dtm0_tmsg_fom_ops, fop, repfop, reqh);
        } else
                M0_IMPOSSIBLE();

        return M0_RC_INFO(0, "fom=%p", &fom->dtf_fom);
}

static void dtm0_fom_fini(struct m0_fom *fom)
{
        M0_PRE(fom != NULL);

        m0_fom_fini(fom);
        m0_free(fom);
}

static size_t dtm0_fom_locality(const struct m0_fom *fom)
{
        static size_t locality = 0;

        M0_PRE(fom != NULL);
        return locality++;
}

M0_INTERNAL int m0_dtm0_logrec_update(struct m0_be_dtm0_log  *log,
                                      struct m0_be_tx        *tx,
                                      struct m0_dtm0_tx_desc *txd,
                                      struct m0_buf          *payload)
{
        int rc;

        M0_ENTRY();

        m0_mutex_lock(&log->dl_lock);
        rc = m0_be_dtm0_log_update(log, tx, txd, payload);
        m0_mutex_unlock(&log->dl_lock);

        return M0_RC(rc);
}

M0_INTERNAL int m0_dtm0_on_committed(struct m0_fom            *fom,
                                     const struct m0_dtm0_tid *id)
{
        struct m0_dtm0_service       *dtms;
        struct m0_be_dtm0_log        *log;
        const struct m0_dtm0_log_rec *rec;
        const struct m0_fid          *target;
        const struct m0_fid          *source;
        struct dtm0_req_fop           req = { .dtr_msg = DTM_PERSISTENT };
        struct m0_dtm0_tx_desc       *txd = &req.dtr_txr;
        int                           rc;
        int                           i;

        dtms = m0_dtm0_service_find(fom->fo_service->rs_reqh);

        /*
         * It is impossible to commit a transaction without DTM0 service up and
         * running.
         */
        M0_PRE(dtms != NULL);
        log = dtms->dos_log;
        M0_PRE(log != NULL);
        /* It is impossible to commit something on a volatile log. */
        M0_PRE(log->dl_is_persistent);

        M0_ENTRY();

        m0_mutex_lock(&log->dl_lock);
        /* Get the latest state of the log record. */
        rec = m0_be_dtm0_log_find(log, id);
        /*
         * It is impossible to commit a record that is not a part of the
         * DTM log.
         */
        M0_ASSERT_INFO(rec != NULL, "Log record must be inserted into the log "
                       "in cas_fom_tick().");
        rc = m0_dtm0_tx_desc_copy(&rec->dlr_txd, txd);
        m0_mutex_unlock(&log->dl_lock);

        if (rc != 0)
                goto out;

        /*
         * We have to send N PERSISTENT messages once a local transaction
         * gets committed (where N == txd->dtd_ps.dtp_nr):
         *      N-1 to the other participants (except ourselves),
         *      1   to the originator (txd->dtd_id.dti_fid).
         */
        source = &dtms->dos_generic.rs_service_fid;
        for (i = 0; i < txd->dtd_ps.dtp_nr; ++i) {
                target = &txd->dtd_ps.dtp_pa[i].p_fid;

                /*
                 * Since we should not send Pmsg to ourselves, re-use this
                 * iteration to send Pmsg to the originator.
                 */
                if (m0_fid_eq(target, source))
                        target = &txd->dtd_id.dti_fid;

                rc = m0_dtm0_req_post(dtms, NULL, &req, target, fom, false);
                if (rc != 0) {
                        M0_LOG(M0_WARN, "Failed to send PERSISTENT msg "
                                    FID_F " -> " FID_F " (%d).",
                                    FID_P(source), FID_P(target), rc);
                        /*
                         * If we have failed to send a Pmsg (for any reason),
                         * it is still not a showstopper for the caller
                         * because the transaction has already been committed.
                         */
                        rc = 0;
                }
        }

        m0_dtm0_tx_desc_fini(txd);

out:
        return M0_RC(rc);
}

/*
 * A FOM tick to handle a DTM0 PERSISTENT message (Pmsg).
 * A group of Pmsgs is sent whenever a local transaction gets committed
 * (see ::m0_dtm0_on_committed). This routine is the recipient of such
 * messages.
 */
static int dtm0_pmsg_fom_tick(struct m0_fom *fom)
{
        int                       result = M0_FSO_AGAIN;
        struct   m0_dtm0_service *svc;
        struct   m0_buf           buf = {};
        struct   dtm0_rep_fop    *rep;
        struct   dtm0_req_fop    *req = m0_fop_data(fom->fo_fop);
        int                       phase = m0_fom_phase(fom);
        struct   m0_be_tx_credit  cred = {};

        M0_PRE(req->dtr_msg == DTM_PERSISTENT);
        M0_ENTRY("fom %p phase %d", fom, phase);

        switch (phase) {
        case M0_FOPH_INIT ... M0_FOPH_NR - 1:
                result = m0_fom_tick_generic(fom);
                if (m0_dtm0_is_a_persistent_dtm(fom->fo_service) &&
                    m0_fom_phase(fom) == M0_FOPH_TXN_OPEN) {
                        M0_ASSERT(phase == M0_FOPH_TXN_INIT);
                        m0_be_dtm0_log_credit(M0_DTML_PERSISTENT,
                                              &req->dtr_txr, &buf,
                                              m0_fom_reqh(fom)->rh_beseg,
                                              NULL, &cred);
                        m0_be_tx_credit_add(&fom->fo_tx.tx_betx_cred, &cred);
                }
                break;

        case M0_FOPH_DTM0_ENTRY:
                m0_fom_phase_set(fom, M0_FOPH_DTM0_LOGGING);
                break;

        case M0_FOPH_DTM0_LOGGING:
                rep = m0_fop_data(fom->fo_rep_fop);
                svc = m0_dtm0_fom2service(fom);
                M0_ASSERT(svc != NULL);

                M0_LOG(M0_DEBUG, "Logging a P msg in phase %" PRIu32
                       " %d, " FID_F ", %p", req->dtr_msg,
                       !!m0_dtm0_is_a_volatile_dtm(fom->fo_service),
                       FID_P(&fom->fo_service->rs_service_fid),
                       fom->fo_service->rs_reqh);

                if (m0_dtm0_is_a_volatile_dtm(fom->fo_service)) {
                        /*
                         * On the client side, DTX is the owner of the
                         * corresponding log record, so that it cannot be
                         * modifed right here. We have to post an AST
                         * to ensure DTX is modifed under the group lock held.
                         */
                        m0_be_dtm0_log_pmsg_post(svc->dos_log, fom->fo_fop);
                        rep->dr_rc = 0;
                } else {
                        rep->dr_rc = m0_dtm0_logrec_update(svc->dos_log,
                                                           &fom->fo_tx.tx_betx,
                                                           &req->dtr_txr, &buf);
                }

                /* We do not handle any failures of Pmsg processing. */
                m0_fom_phase_set(fom, M0_FOPH_SUCCESS);

                break;
        default:
                M0_IMPOSSIBLE("Invalid phase");
        }

        return M0_RC(result);
}

/*
 * A FOM tick to handle a DTM0 EXECUTE message (Emsg).
 * TODO:
 * EXECUTE/EXECUTED message is "under development", and it is not a part
 * of the main DTM0 algorithm yet.
 * Previously, it was used to send ping-pongs in the UT. Once DTM0 RPC link
 * gets its version of m0_rpc_post_sync, this FOM tick will be used in the
 * UT that sends ping-pongs between volatile and persistent DTM0 services.
 */
static int dtm0_emsg_fom_tick(struct m0_fom *fom)
{
        int                       result = M0_FSO_AGAIN;
        struct   dtm0_rep_fop    *rep = m0_fop_data(fom->fo_rep_fop);
        struct   dtm0_req_fop    *req = m0_fop_data(fom->fo_fop);
        int                       phase = m0_fom_phase(fom);
        struct   m0_dtm0_service *svc = m0_dtm0_fom2service(fom);
        const struct m0_fid      *tgt = &req->dtr_txr.dtd_id.dti_fid;
        const struct dtm0_req_fop executed = {
                .dtr_msg = DTM_EXECUTED,
                .dtr_txr = req->dtr_txr,
        };

        M0_PRE(req->dtr_msg == DTM_EXECUTE);
        M0_ASSERT_INFO(m0_dtm0_in_ut(), "Emsg cannot be used outside of UT.");

        M0_ENTRY("fom %p phase %d", fom, phase);

        switch (phase) {
        case M0_FOPH_INIT ... M0_FOPH_NR - 1:
                result = m0_fom_tick_generic(fom);
                break;
        case M0_FOPH_DTM0_ENTRY:
                if (m0_dtm0_is_a_persistent_dtm(fom->fo_service))
                        rep->dr_rc = m0_dtm0_req_post(svc, NULL, &executed,
                                                      tgt, fom, false);
                m0_fom_phase_set(fom, M0_FOPH_SUCCESS);
                break;
        default:
                M0_IMPOSSIBLE("Invalid phase");
        }

        return M0_RC(result);
}

static void dtm0_cas_done_cb(struct m0_fom_thralldom *thrall,
                             struct m0_fom           *serf)
{
        struct dtm0_fom   *leader = M0_AMB(leader, thrall, dtf_thrall);
        struct m0_cas_rep *rep;
        int                rc;

        rc = m0_fom_rc(serf);
        if (rc == 0) {
                M0_ASSERT(serf->fo_rep_fop != NULL);
                rep = (struct m0_cas_rep *)m0_fop_data(serf->fo_rep_fop);
                M0_ASSERT(rep != NULL);
                rc = rep->cgr_rc;
                if (rc == 0) {
                        M0_ASSERT(rep->cgr_rep.cr_nr == 1);
                        rc = rep->cgr_rep.cr_rec[0].cr_rc;
                }
        }
        leader->dtf_thrall_rc = rc;
}

static int dtm0_cas_fom_spawn(
        struct dtm0_fom *dfom,
        struct m0_fop   *cas_fop,
        void           (*on_cas_fom_complete)(struct m0_fom_thralldom *,
                                              struct m0_fom           *))
{
#ifndef __KERNEL__
        return m0_cas_fom_spawn(&dfom->dtf_fom, &dfom->dtf_thrall,
                                cas_fop, on_cas_fom_complete);
#else
        /* CAS service is not compiled for kernel. */
        return 0;
#endif
}

static int dtm0_cas_fop_prepare(struct dtm0_req_fop *req,
                                struct m0_fop_type  *cas_fopt,
                                struct m0_fop      **cas_fop_out)
{
        int               rc;
        struct m0_cas_op *cas_op;
        struct m0_fop    *cas_fop;

        *cas_fop_out = NULL;

        M0_ALLOC_PTR(cas_op);
        M0_ALLOC_PTR(cas_fop);

        if (cas_op == NULL || cas_fop == NULL) {
                rc = -ENOMEM;
        } else {
                rc = m0_xcode_obj_dec_from_buf(
                        &M0_XCODE_OBJ(m0_cas_op_xc, cas_op),
                        req->dtr_payload.b_addr,
                        req->dtr_payload.b_nob);
                if (rc == 0)
                        m0_fop_init(cas_fop, cas_fopt, cas_op, &m0_fop_release);
                else
                        M0_LOG(M0_ERROR, "Could not decode the REDO payload");
        }

        if (rc == 0) {
                *cas_fop_out = cas_fop;
        } else {
                m0_free(cas_op);
                m0_free(cas_fop);
        }

        return rc;
}

static int dtm0_rmsg_fom_tick(struct m0_fom *fom)
{
        int                  rc;
        int                  result = M0_FSO_AGAIN;
        int                  phase = m0_fom_phase(fom);
        struct dtm0_fom     *dfom = M0_AMB(dfom, fom, dtf_fom);
        struct dtm0_req_fop *req  = m0_fop_data(fom->fo_fop);
        struct m0_fop       *cas_fop = NULL;

        M0_ENTRY("fom %p phase %d", fom, phase);

        switch (phase) {
        case M0_FOPH_INIT ... M0_FOPH_NR - 1:
                result = m0_fom_tick_generic(fom);
                break;
        case M0_FOPH_DTM0_ENTRY:
                m0_fom_phase_set(fom, M0_FOPH_DTM0_TO_CAS);
                break;
        case M0_FOPH_DTM0_TO_CAS:
                /* REDO_END()s from all recovering processes received, send
                 * RECOVERED() message to the counterpart.

                cs_ha_process_event(m0_cs_ctx_get(m0_fom_reqh(fom)),
                                    M0_CONF_HA_PROCESS_DTM_RECOVERED);
                */
                rc = dtm0_cas_fop_prepare(req, &cas_put_fopt, &cas_fop);
                if (rc == 0) {
                        rc = dtm0_cas_fom_spawn(dfom, cas_fop,
                                                &dtm0_cas_done_cb);
                        if (rc != 0) {
                                M0_LOG(M0_ERROR, "Could not spawn CAS fom");
                                m0_fop_fini(cas_fop);
                                m0_free(cas_fop);
                        } else {
                                result = M0_FSO_WAIT;
                        }
                } else {
                        M0_LOG(M0_ERROR, "Could not prepare CAS fop");
                }

                if (rc != 0)
                        m0_fom_phase_move(fom, rc, M0_FOPH_FAILURE);
                else
                        m0_fom_phase_set(fom, M0_FOPH_DTM0_CAS_DONE);
                break;
        case M0_FOPH_DTM0_CAS_DONE:
                if (dfom->dtf_thrall_rc != 0) {
                        M0_LOG(M0_ERROR, "Spawned CAS fom failed, rc = %d",
                               dfom->dtf_thrall_rc);
                        m0_fom_phase_move(fom, dfom->dtf_thrall_rc,
                                          M0_FOPH_FAILURE);
                } else {
                        m0_fom_phase_set(fom, M0_FOPH_SUCCESS);
                }
                break;
        default:
                M0_IMPOSSIBLE("Invalid phase");
        }
        return M0_RC(result);
}

static int dtm0_tmsg_fom_tick(struct m0_fom *fom)
{
        struct m0_dtm0_service *svc = m0_dtm0_fom2service(fom);
        struct dtm0_req_fop    *req = m0_fop_data(fom->fo_fop);
        int                     phase = m0_fom_phase(fom);
        int                     result;

        M0_ENTRY("fom %p phase %d", fom, phase);

        if (m0_fom_phase(fom) < M0_FOPH_NR) {
                result = m0_fom_tick_generic(fom);
        } else {
                m0_be_queue_lock(svc->dos_ut_queue);
                M0_BE_OP_SYNC(op,
                              M0_BE_QUEUE_PUT(svc->dos_ut_queue, &op,
                                              &req->dtr_txr.dtd_id.dti_fid));
                m0_be_queue_unlock(svc->dos_ut_queue);
                m0_fom_phase_set(fom, M0_FOPH_SUCCESS);
                result = M0_RC(M0_FSO_AGAIN);
        }
        return M0_RC(result);
}

/*
 *  Local variables:
 *  c-indentation-style: "K&R"
 *  c-basic-offset: 8
 *  tab-width: 8
 *  fill-column: 80
 *  scroll-step: 1
 *  End:
 */