Second Life viewer sources 1.13.2.12

1 files changed, 109 insertions, 0 deletions

diff --git a/linden/indra/llmessage/llcachename.h b/linden/indra/llmessage/llcachename.h
new file mode 100644
index 0000000..4dd42cb
--- /dev/null
+++ b/linden/indra/llmessage/llcachename.h
@@ -0,0 +1,109 @@
+/** 
+ * @file llcachename.h
+ * @brief A cache of names from UUIDs.
+ *
+ * Copyright (c) 2002-2007, Linden Research, Inc.
+ * 
+ * The source code in this file ("Source Code") is provided by Linden Lab
+ * to you under the terms of the GNU General Public License, version 2.0
+ * ("GPL"), unless you have obtained a separate licensing agreement
+ * ("Other License"), formally executed by you and Linden Lab.  Terms of
+ * the GPL can be found in doc/GPL-license.txt in this distribution, or
+ * online at http://secondlife.com/developers/opensource/gplv2
+ * 
+ * There are special exceptions to the terms and conditions of the GPL as
+ * it is applied to this Source Code. View the full text of the exception
+ * in the file doc/FLOSS-exception.txt in this software distribution, or
+ * online at http://secondlife.com/developers/opensource/flossexception
+ * 
+ * By copying, modifying or distributing this software, you acknowledge
+ * that you have read and understood your obligations described above,
+ * and agree to abide by those obligations.
+ * 
+ * ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO
+ * WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY,
+ * COMPLETENESS OR PERFORMANCE.
+ */
+
+#ifndef LL_LLCACHENAME_H
+#define LL_LLCACHENAME_H
+
+// Forward declarations
+#include <stdio.h>
+
+class LLMessageSystem;
+class LLHost;
+class LLUUID;
+
+// agent_id/group_id, first_name, last_name, is_group, user_data
+typedef void (*LLCacheNameCallback)(const LLUUID&, const char*, const char*, BOOL, void*);
+
+// Here's the theory:
+// If you request a name that isn't in the cache, it returns "waiting"
+// and requests the data.  After the data arrives, you get that on 
+// subsequent calls.
+// If the data hasn't been updated in an hour, it requests it again,
+// but keeps giving you the old value until new data arrives.
+// If you haven't requested the data in an hour, it releases it.
+class LLCacheName
+{
+public:
+        LLCacheName(LLMessageSystem* msg);
+        LLCacheName(LLMessageSystem* msg, const LLHost& upstream_host);
+        ~LLCacheName();
+
+        // registers the upstream host
+        // for viewers, this is the currently connected simulator
+        // for simulators, this is the data server
+        void setUpstream(const LLHost& upstream_host);
+
+        void addObserver(LLCacheNameCallback callback);
+        void removeObserver(LLCacheNameCallback callback);
+
+        // storing cache on disk; for viewer, in name.cache
+        void importFile(FILE* fp);
+        void exportFile(FILE* fp);
+
+        // If available, copies the first and last name into the strings provided.
+        // first must be at least DB_FIRST_NAME_BUF_SIZE characters.
+        // last must be at least DB_LAST_NAME_BUF_SIZE characters.
+        // If not available, copies the string "waiting".
+        // Returns TRUE iff available.
+        BOOL getName(const LLUUID& id, char* first, char* last);
+        
+        // If available, this method copies the group name into the string
+        // provided. The caller must allocate at least
+        // DB_GROUP_NAME_BUF_SIZE characters. If not available, this
+        // method copies the string "waiting". Returns TRUE iff available.
+        BOOL getGroupName(const LLUUID& id, char* group);
+
+        // Call the callback with the group or avatar name.
+        // If the data is currently available, may call the callback immediatly
+        // otherwise, will request the data, and will call the callback when
+        // available.  There is no garuntee the callback will ever be called.
+        void get(const LLUUID& id, BOOL is_group, LLCacheNameCallback callback, void* user_data = NULL);
+        
+        // LEGACY
+        void getName(const LLUUID& id, LLCacheNameCallback callback, void* user_data = NULL)
+                        { get(id, FALSE, callback, user_data); }
+
+        // This method needs to be called from time to time to send out
+        // requests.
+        void processPending();
+
+        // Expire entries created more than "secs" seconds ago.
+        void deleteEntriesOlderThan(S32 secs);
+
+        // Debugging
+        void dump();
+
+private:
+        class Impl;
+        Impl& impl;
+};
+
+
+
+extern LLCacheName* gCacheName;
+
+#endif