/* SPDX-License-Identifier: GPL-2.0 */
/*
 * Copyright (c) 2020, Oracle and/or its affiliates
 */

#ifndef SVC_RDMA_PCL_H
#define SVC_RDMA_PCL_H

#include <linux/list.h>

struct svc_rdma_segment {
        u32                     rs_handle;
        u32                     rs_length;
        u64                     rs_offset;
};

struct svc_rdma_chunk {
        struct list_head        ch_list;

        u32                     ch_position;
        u32                     ch_length;
        u32                     ch_payload_length;

        u32                     ch_segcount;
        struct svc_rdma_segment ch_segments[];
};

struct svc_rdma_pcl {
        unsigned int            cl_count;
        struct list_head        cl_chunks;
};

/**
 * pcl_init - Initialize a parsed chunk list
 * @pcl: parsed chunk list to initialize
 *
 */
static inline void pcl_init(struct svc_rdma_pcl *pcl)
{
        INIT_LIST_HEAD(&pcl->cl_chunks);
}

/**
 * pcl_is_empty - Return true if parsed chunk list is empty
 * @pcl: parsed chunk list
 *
 */
static inline bool pcl_is_empty(const struct svc_rdma_pcl *pcl)
{
        return list_empty(&pcl->cl_chunks);
}

/**
 * pcl_first_chunk - Return first chunk in a parsed chunk list
 * @pcl: parsed chunk list
 *
 * Returns the first chunk in the list, or NULL if the list is empty.
 */
static inline struct svc_rdma_chunk *
pcl_first_chunk(const struct svc_rdma_pcl *pcl)
{
        if (pcl_is_empty(pcl))
                return NULL;
        return list_first_entry(&pcl->cl_chunks, struct svc_rdma_chunk,
                                ch_list);
}

/**
 * pcl_next_chunk - Return next chunk in a parsed chunk list
 * @pcl: a parsed chunk list
 * @chunk: chunk in @pcl
 *
 * Returns the next chunk in the list, or NULL if @chunk is already last.
 */
static inline struct svc_rdma_chunk *
pcl_next_chunk(const struct svc_rdma_pcl *pcl, struct svc_rdma_chunk *chunk)
{
        if (list_is_last(&chunk->ch_list, &pcl->cl_chunks))
                return NULL;
        return list_next_entry(chunk, ch_list);
}

/**
 * pcl_for_each_chunk - Iterate over chunks in a parsed chunk list
 * @pos: the loop cursor
 * @pcl: a parsed chunk list
 */
#define pcl_for_each_chunk(pos, pcl) \
        for (pos = list_first_entry(&(pcl)->cl_chunks, struct svc_rdma_chunk, ch_list); \
             &pos->ch_list != &(pcl)->cl_chunks; \
             pos = list_next_entry(pos, ch_list))

/**
 * pcl_for_each_segment - Iterate over segments in a parsed chunk
 * @pos: the loop cursor
 * @chunk: a parsed chunk
 */
#define pcl_for_each_segment(pos, chunk) \
        for (pos = &(chunk)->ch_segments[0]; \
             pos <= &(chunk)->ch_segments[(chunk)->ch_segcount - 1]; \
             pos++)

/**
 * pcl_chunk_end_offset - Return offset of byte range following @chunk
 * @chunk: chunk in @pcl
 *
 * Returns starting offset of the region just after @chunk
 */
static inline unsigned int
pcl_chunk_end_offset(const struct svc_rdma_chunk *chunk)
{
        return xdr_align_size(chunk->ch_position + chunk->ch_payload_length);
}

struct svc_rdma_recv_ctxt;

extern void pcl_free(struct svc_rdma_pcl *pcl);
extern bool pcl_alloc_call(struct svc_rdma_recv_ctxt *rctxt, __be32 *p);
extern bool pcl_alloc_read(struct svc_rdma_recv_ctxt *rctxt, __be32 *p);
extern bool pcl_alloc_write(struct svc_rdma_recv_ctxt *rctxt,
                            struct svc_rdma_pcl *pcl, __be32 *p);
extern int pcl_process_nonpayloads(const struct svc_rdma_pcl *pcl,
                                   const struct xdr_buf *xdr,
                                   int (*actor)(const struct xdr_buf *,
                                                void *),
                                   void *data);

#endif  /* SVC_RDMA_PCL_H */