/*
- * Copyright (C) 2005-2007 Andre Noll <maan@systemlinux.org>
+ * Copyright (C) 2005-2008 Andre Noll <maan@systemlinux.org>
*
* Licensed under the GPL v2. For licencing details see COPYING.
*/
/**
- * \file stat.c functions used for sending/receiving the status of para_server
- * and para_audiod
+ * \file stat.c Functions used for sending/receiving the status of para_server
+ * and para_audiod.
*/
#include "string.h"
#include "fd.h"
-/** the maximal number of simultaneous connections */
+/** The maximal number of simultaneous connections. */
#define MAX_STAT_CLIENTS 50
/**
- * describes a status client of para_audiod
+ * Describes a status client of para_audiod.
*
* There's one such structure per audiod client that sent the 'stat' command.
*
* keeps a list of connected status clients.
*/
struct stat_client {
- /** the stat client's file descriptor */
+ /** The stat client's file descriptor. */
int fd;
- /** bitmask of those status items the client is interested in */
+ /** Bitmask of those status items the client is interested in. */
long unsigned item_mask;
- /** its entry in the list of stat clients */
+ /** Its entry in the list of stat clients. */
struct list_head node;
};
static int initialized;
static int num_clients;
-/** The list of all status items used by para_server/para_audiod. */
-const char *status_item_list[NUM_STAT_ITEMS] = {
- [SI_BASENAME] = "basename",
- [SI_STATUS] = "status",
- [SI_NUM_PLAYED] = "num_played",
-
- [SI_MTIME] = "mtime",
- [SI_LENGTH_MIN] = "length_min",
- [SI_LENGTH_SEC] = "length_sec",
-
- [SI_FILE_SIZE] = "file_size",
- [SI_STATUS_FLAGS] = "status_flags",
- [SI_FORMAT] = "format",
-
- [SI_SCORE] = "score",
- [SI_AUDIO_FILE_INFO] = "audio_file_info",
-
- [SI_TAG_INFO1] = "taginfo1",
- [SI_TAG_INFO2] = "taginfo2",
- [SI_AFS_MODE] = "afs_mode",
- [SI_ATTRIBUTES] = "attributes",
-
- [SI_DIRECTORY] = "dir",
- [SI_DECODER_FLAGS] = "decoder_flags",
- [SI_AUDIOD_STATUS] = "audiod_status",
-
- [SI_PLAY_TIME] = "play_time",
- [SI_UPTIME] = "uptime",
- [SI_OFFSET] = "offset",
-
- [SI_SECONDS_TOTAL] = "seconds_total",
- [SI_STREAM_START] = "stream_start",
- [SI_CURRENT_TIME] = "current_time",
-
- [SI_AUDIOD_UPTIME] = "audiod_uptime",
- [SI_IMAGE_ID] = "image_id",
- [SI_LYRICS_ID] = "lyrics_id",
- [SI_DURATION] = "duration"
-};
+/** The list of all status items used by para_{server,audiod,gui}. */
+const char *status_item_list[] = {STATUS_ITEM_ARRAY};
static void dump_stat_client_list(void)
{
PARA_INFO_LOG("stat client on fd %d\n", sc->fd);
}
/**
- * add a status client to the list
+ * Add a status client to the list.
*
- * \param fd the file descriptor of the client
- * \param mask bitfield of status items for this client
+ * \param fd The file descriptor of the client.
+ * \param mask Bitfield of status items for this client.
*
* Only those status items having the bit set in \a mask will be
* sent to the client.
return 1;
}
/**
- * write a message to all connected status clients
+ * Write a message to all connected status clients.
*
- * \param msg a \p NULL terminated buffer
- * \param itemnum The number of the status item of \a msg
+ * \param msg A \p NULL terminated buffer.
+ * \param itemnum The number of the status item of \a msg.
*
* On write errors, remove the status client from the client list and close its
* file descriptor.
{
struct stat_client *sc, *tmp;
size_t len = strlen(msg);
- struct timeval tv = {0 , 0};
if (!initialized || !len)
return;
list_for_each_entry_safe(sc, tmp, &client_list, node) {
int fd = sc->fd, ret;
- fd_set wfds;
if (!((1 << itemnum) & sc->item_mask))
continue;
- FD_ZERO(&wfds);
- FD_SET(fd, &wfds);
-// PARA_DEBUG_LOG("%s: p=%lx\n", __func__, (long)p);
- ret = para_select(fd + 1, NULL, &wfds, &tv);
- if (ret > 0) {
+ if (write_ok(fd) > 0) {
ret = write(fd, msg, len);
PARA_DEBUG_LOG("dumped %s to fd %d, ret = %d\n", msg, fd, ret);
- if (ret == len )
+ if (ret == len)
continue;
}
/* write error or fd not ready for writing */
free(sc);
dump_stat_client_list();
}
- PARA_DEBUG_LOG("%d client(s)\n", num_clients);
+ if (num_clients)
+ PARA_DEBUG_LOG("%d client(s)\n", num_clients);
}
/**
- * check if string is a known status item.
+ * Check if string is a known status item.
*
- * \param item buffer containing the text to check
+ * \param item Buffer containing the text to check.
*
* \return If \a item is a valid status item, the number of that status item is
* returned. Otherwise, this function returns \p -E_UNKNOWN_STAT_ITEM.
PARA_ERROR_LOG("%s\n", "no item");
return -E_UNKNOWN_STAT_ITEM;
}
- FOR_EACH_STAT_ITEM(i)
+ FOR_EACH_STATUS_ITEM(i)
if (!strcmp(status_item_list[i], item))
return i;
PARA_ERROR_LOG("invalid stat item: %s\n", item);
}
/**
- * check if line starts with known status item.
+ * Check if line starts with known status item.
*
- * \param line buffer containing the line
+ * \param line Buffer containing the line.
*
* \return If the beginning of \a line matches any paraslash status item and is
* followed by a colon, the number of that status item is returned. Otherwise,
if (!line || !*line)
return -E_UNKNOWN_STAT_ITEM;
line_len = strlen(line);
- FOR_EACH_STAT_ITEM(i) {
+ FOR_EACH_STATUS_ITEM(i) {
const char *s = status_item_list[i];
size_t item_len = strlen(s);