/*
 * \brief  C-API Genode block backend
 * \author Stefan Kalkowski
 * \date   2021-07-05
 */

/*
 * Copyright (C) 2006-2021 Genode Labs GmbH
 *
 * This file is part of the Genode OS framework, which is distributed
 * under the terms of the GNU Affero General Public License version 3.
 */

#ifndef _GENODE_C_API__BLOCK_H_
#define _GENODE_C_API__BLOCK_H_

#include <genode_c_api/base.h>


struct genode_block_session; /* definition is private to the implementation */


#ifdef __cplusplus
extern "C" {
#endif


/********************
 ** Initialization **
 ********************/

/**
 * Initialize block root component
 *
 * \param handler  signal handler to be installed at each block session
 */
void genode_block_init(struct genode_env            *env,
                       struct genode_allocator      *alloc,
                       struct genode_signal_handler *handler,
                       genode_shared_dataspace_alloc_attach_t,
                       genode_shared_dataspace_free_t);


/**************************************
 ** Block device lifetime management **
 **************************************/

typedef unsigned long long genode_block_sector_t;

void genode_block_announce_device(const char *          name,
                                  genode_block_sector_t sectors,
                                  int                   writeable);

void genode_block_discontinue_device(const char * name);


/************************************
 ** Block session request handling **
 ************************************/

enum Operation {
	GENODE_BLOCK_READ,
	GENODE_BLOCK_WRITE,
	GENODE_BLOCK_SYNC,
	GENODE_BLOCK_UNAVAIL,
};

struct genode_block_request {
	int                   op;
	genode_block_sector_t blk_nr;
	genode_block_sector_t blk_cnt;
	void *                addr;
};

struct genode_block_session * genode_block_session_by_name(const char * name);

struct genode_block_request *
genode_block_request_by_session(struct genode_block_session * const session);

void genode_block_ack_request(struct genode_block_session * const session,
                              struct genode_block_request * const request,
                              int success);

void genode_block_notify_peers(void);

#ifdef __cplusplus
}
#endif

#endif /* _GENODE_C_API__BLOCK_H_ */