/*    					W3C Sample Code Library libwww User Profile Class!  The User Profile Class!*//***	(c) COPYRIGHT MIT 1995.**	Please first read the full copyright statement in the file COPYRIGH.*//*The User profile class manages what we know about a user on thishost. This can for example be the FQDN of the host, the user's emailaddress, the time zone, the news server etc. Note that this information doesnot correspond to the actual information for the host but instead represents"the information that the user wants to show the world". The user may usean arbitrary email address to be used in a HTTPrequest, for example. The application may assign a context to each usewhich gives the application to extend the use of this class.This module is implemented by HTUser.c, and it isa part of the W3C Sample CodeLibrary.*/#ifndef HTUSER_H#define HTUSER_Htypedef struct _HTUserProfile HTUserProfile;/*.  Creation and Deletion Methods.The application may create any number of user profile objects. By defaultthe Library creates a generic user which is the default value used to initializea Request object. This can be replaced by otheruser profiles at any point in time.(  Create a User Profile)*/extern HTUserProfile * HTUserProfile_new (const char * name, void * context);/*(  Localize a User Profile)Localize a user profile by filling in all the information that we can figureout automatically, for example the email address, news server etc.*/extern BOOL HTUserProfile_localize (HTUserProfile * up);/*(  Delete a User Profile)*/extern BOOL HTUserProfile_delete (HTUserProfile * up);/*.  User Profile Class Methods.(  Fully Qualified Domain Name (FQDN))The FQDN is a fully qualified domain name in that it contains both a localhost name and the domain name. It turns out that this is in fact very difficultto obtain a FQDN on a variety of platforms.*/extern char * HTUserProfile_fqdn (HTUserProfile * up);extern BOOL HTUserProfile_setFqdn (HTUserProfile * up, const char * fqdn);/*(  User Email Address)This is the email address that the user wants to send out for example asa "password" when using anonymous FTP access andas a "From" field in a HTTP request.*/extern char * HTUserProfile_email (HTUserProfile * up);extern BOOL HTUserProfile_setEmail (HTUserProfile * up, const char * email);/*(  News Server)Control the news server that this user wishes to use*/extern char * HTUserProfile_news (HTUserProfile * host);extern BOOL HTUserProfile_setNews (HTUserProfile * host, const char * news);/*(  Location of Temporary Files)Control the location for temporary files for this profile. The formatmust be in URL format which is different from local file syntax asURL syntaz always uses '/' as delimiters and also encoding of specialcharacters. See thedocumentation on URLsfor more information about URL syntax.*/extern char * HTUserProfile_tmp (HTUserProfile * host);extern BOOL HTUserProfile_setTmp (HTUserProfile * host, const char * tmp);/*(  Local Time Zone (in seconds))Another widely used piece information that is very hard toobtain is the localtime zone. As we often must convert to and from GMT (Universal Time) we musthave the correct time zone. If we for some reason guesses wrong then theuser must change it manually.*/extern time_t HTUserProfile_timezone (HTUserProfile * up);extern BOOL HTUserProfile_setTimezone (HTUserProfile * up, time_t timezone);/*(  User Profile Context)The applicatoin may have additional information that it wishes to assignto a user profile. It can do this using the user context which is handledas follows:*/extern void * HTUserProfile_context (HTUserProfile * up);extern BOOL HTUserProfile_setContext (HTUserProfile * up, void * context);/**/#endif /* HTUser_H *//*    @(#) $Id: HTUser.html,v 2.4 1998/05/14 02:11:16 frystyk Exp $*/