From the NannyMUD documentation

LAST CHANGE

2001-01-13

NAME

        fingerd - /obj/daemon/fingerd.c - a finger daemon

FUNCTIONS

QUERY FUNCTIONS

	age
	query_banished
	finger
	get_player_stats
	appwizp
	wizardp
	playerp
	all_player_files

DESCRIPTION

	This daemon keeps track of finger information. The Finger command
	available to all players uses this daemon to return its data. It
	has some very useful functions for obtaining information about
	players who are logged in and those that are not. This daemon is
	also used for the information on Nanny's WWW pages.

FUNCTION

NAME
        playerp - Does the player exist?


SYNTAX
int playerp(string name)

DESCRIPTION
	If the player 'name' exists, this function returns 1.




FUNCTION

NAME
        age - Age as a string.


SYNTAX
string age(int i_age)

DESCRIPTION
	Given an integer, assumes the argument is a number of seconds,
	and makes a string on the form "1 day 3 hours 46 minutes 40
	seconds".




FUNCTION

NAME
        query_banished - Check if a name is banished.


SYNTAX
int query_banished(string name)

DESCRIPTION
	If the name 'name' is banished, the function returns 1, else it
	return 0.




FUNCTION

NAME
        finger - Delivers the Finger info.


SYNTAX
string finger(string name)

DESCRIPTION
	This function returns finger information for the given name, if
	there is such a player, else it returns nothing.




FUNCTION

NAME
        wizardp - Is the player a wizard?


SYNTAX
int wizardp(string name)

DESCRIPTION
	If the player 'name' exists and is a wizard, this function returns
	one, else it returns 0.




FUNCTION

NAME
        appwizp - Is this player att the lowest wizlevel?


SYNTAX
int appwizp(string name)

DESCRIPTION
	If the player 'name' exists and is at the lowest wizardlevel, this
	function returns one, else it returns 0.




FUNCTION

NAME
        all_player_files - Like 'ls' in the player save dir.


SYNTAX
string
        all_player_files()

DESCRIPTION
	This returns a list of all player save files. It's equivalent to
	doing 'ls /saves/*' or so.




FUNCTION

NAME
        get_player_stats - Delivers player stats.


SYNTAX
mixed get_player_stats(string name)

DESCRIPTION
	This function can be called from an information gathering command.
	The data it returns is in an array. The array values are as follows
	and always in same order:
	    0:  Name of character. Same as this_player()->query_real_name().
		Given as a string.
	    1:  Title of character. Title without alignment string. Given as
		a string.
	    2:  Alignment string. What is usually between () on a player.
		Given as a string.
            3:  Plan of the character. A string representing whole plan, with
		newlines included.
	    4:  The amount of money on a character. Given as an int.
	    5:  Level of the character. Given as an int.
	    6:  The max hit points of the character. Given as an int.
	    7:  The max spell points of the character. Given as an int.
	    8:  Age of the character. Given as an int. This is the total
		amount of heartbeats the character has "lived". To get this
		in seconds, multiply by 2. 1 heartbeat is approx 2 seconds.
	    9:  Value of Str stat of character given as an int.
	    10: Value of Int stat of character given as an int.
	    11: Value of Con stat of character given as an int.
	    12: Value of Dex stat of character given as an int.
	    13: Quest point max of the player given as an int. This figure
		is the amount of quest points available as a whole when the
		player was first created.
	    14: Gender of character. Given as an int.
		0 = neuter, 1 = male, 2 = female.
	    15: Last time the character logged in. Given as a string in the
		format of: Month Date Time. Time is local to Lysator.
	    16: Character's registered email address. This is given as a
		string. This is the email address that the character gives
		when they first logged in, or through email command.
	    17: This is an int that determines whether character is a
		playerkiller.
	    18: IP address that the character last connected from. Given
		as a string of the form: aaa.bbb.ccc.ddd.
	    19: DNS address for IP the player last called from if possible.
		This is given as a string. May not be possible, in which case
		it is given in same format as IP address.
	    20: Experience the character currently has. Given as an int.
	    21: Whether the char is a testchar or not. Given as an int.
		Note: admin see this as a string.
	    22: Whether the char is a second character of a wizard or not.
		Given as an int. Note: admin see this as a string.
	    23: Last time character logged in. Given as an int. This is given
		in same format as time(). Running this through ctime() will
		convert this to a string.
	    24: Last time the character logged out. Given as an int. This is
		also same format as time(). Running this through ctime() will
		convert this to a string.
	    25: The character's WWW address. Given as a string.	
	    26: The quests a char has solved. Given as a string with the
		quests seperated by "#" character.
	    27: The environment variables of character. Environment variables
		are used by quite a few objects. For possibilities on wizards,
		do: help setenv. This can be very useful.
	    28: The character's paragon status. Given as an int.
	    29: The character's paragon level. Given as an int.
	    30: The player's RL location, if set, as a string.
	    31: The player's alignment. Given as an int.
	    32: The time() when the character was created.
	    33: The characters NannyPoints.

	The preceding array can be used for a lot of items, mostly items
	giving info about characters. These are all things that do not
	change very often. Other things such as current alignment, current
	hit/spell points, and current quest points that change often are
	not returned through this array.


RETURN VALUES
	An array containing character information.