source: mainline/uspace/srv/hid/remcons/user.h@ 4e5dabf

/*
 * Copyright (c) 2012 Vojtech Horky
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * - Redistributions of source code must retain the above copyright
 *   notice, this list of conditions and the following disclaimer.
 * - Redistributions in binary form must reproduce the above copyright
 *   notice, this list of conditions and the following disclaimer in the
 *   documentation and/or other materials provided with the distribution.
 * - The name of the author may not be used to endorse or promote products
 *   derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

/** @addtogroup remcons
 * @{
 */
/** @file
 */

#ifndef TELNET_USER_H_
#define TELNET_USER_H_

#include <fibril_synch.h>
#include <inttypes.h>
#include "remcons.h"

#define BUFFER_SIZE 32

/** Representation of a connected (human) user. */
typedef struct {
        /** Mutex guarding the whole structure. */
        fibril_mutex_t guard;

        /** Internal id, used for creating locfs entries. */
        int id;
        /** Associated socket. */
        int socket;
        /** Location service id assigned to the virtual terminal. */
        service_id_t service_id;
        /** Path name of the service. */
        char *service_name;

        /** Producer-consumer of kbd_event_t. */
        prodcons_t in_events;
        link_t link;
        char socket_buffer[BUFFER_SIZE];
        size_t socket_buffer_len;
        size_t socket_buffer_pos;

        /** Task id of the launched application. */
        task_id_t task_id;

        /* Reference counting. */
        fibril_condvar_t refcount_cv;
        bool task_finished;
        int locsrv_connection_count;
        bool socket_closed;

        /** X position of the cursor. */
        int cursor_x;
} telnet_user_t;

telnet_user_t *telnet_user_create(int socket);
void telnet_user_destroy(telnet_user_t *user);
telnet_user_t *telnet_user_get_for_client_connection(service_id_t id);
bool telnet_user_is_zombie(telnet_user_t *user);
void telnet_user_notify_client_disconnected(telnet_user_t *user);
int telnet_user_get_next_keyboard_event(telnet_user_t *user, kbd_event_t *event);
int telnet_user_send_data(telnet_user_t *user, uint8_t *data, size_t size);
void telnet_user_update_cursor_x(telnet_user_t *user, int new_x);

/** Print informational message about connected user. */
#ifdef CONFIG_DEBUG
#define telnet_user_log(user, fmt, ...) \
        printf(NAME " [console %d (%d)]: " fmt "\n", user->id, (int) user->service_id, ##__VA_ARGS__)
#else
#define telnet_user_log(user, fmt, ...) (void)0
#endif

/** Print error message associated with connected user. */
#define telnet_user_error(user, fmt, ...) \
        fprintf(stderr, NAME " [console %d (%d)]: ERROR: " fmt "\n", user->id, (int) user->service_id, ##__VA_ARGS__)

#endif

/**
 * @}
 */