s3: fix comment header description for smbd_shim
[Samba/gebeck_regimport.git] / source3 / nmbd / nmbd_browserdb.c
blobbd027239eca00cf9be06cadf1fff9835380b50f9
1 /*
2 Unix SMB/CIFS implementation.
3 NBT netbios routines and daemon - version 2
4 Copyright (C) Andrew Tridgell 1994-1998
5 Copyright (C) Luke Kenneth Casson Leighton 1994-1998
6 Copyright (C) Jeremy Allison 1994-1998
7 Copyright (C) Christopher R. Hertel 1998
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>.
23 /* -------------------------------------------------------------------------- **
24 * Modified July 1998 by CRH.
25 * I converted this module to use the canned doubly-linked lists. I also
26 * added comments above the functions where possible.
29 #include "includes.h"
30 #include "nmbd/nmbd.h"
32 /* -------------------------------------------------------------------------- **
33 * Variables...
35 * lmb_browserlist - This is our local master browser list.
38 struct browse_cache_record *lmb_browserlist;
40 /* -------------------------------------------------------------------------- **
41 * Functions...
44 /* ************************************************************************** **
45 * Remove and free a browser list entry.
47 * Input: browc - A pointer to the entry to be removed from the list and
48 * freed.
49 * Output: none.
51 * ************************************************************************** **
53 static void remove_lmb_browser_entry( struct browse_cache_record *browc )
55 DLIST_REMOVE(lmb_browserlist, browc);
56 SAFE_FREE(browc);
59 /* ************************************************************************** **
60 * Update a browser death time.
62 * Input: browc - Pointer to the entry to be updated.
63 * Output: none.
65 * ************************************************************************** **
67 void update_browser_death_time( struct browse_cache_record *browc )
69 /* Allow the new lmb to miss an announce period before we remove it. */
70 browc->death_time = time(NULL) + ( (CHECK_TIME_MST_ANNOUNCE + 2) * 60 );
73 /* ************************************************************************** **
74 * Create a browser entry and add it to the local master browser list.
76 * Input: work_name
77 * browser_name
78 * ip
80 * Output: Pointer to the new entry, or NULL if malloc() failed.
82 * ************************************************************************** **
84 struct browse_cache_record *create_browser_in_lmb_cache( const char *work_name,
85 const char *browser_name,
86 struct in_addr ip )
88 struct browse_cache_record *browc;
89 time_t now = time( NULL );
91 browc = SMB_MALLOC_P(struct browse_cache_record);
93 if( NULL == browc ) {
94 DEBUG( 0, ("create_browser_in_lmb_cache: malloc fail !\n") );
95 return( NULL );
98 memset( (char *)browc, '\0', sizeof( *browc ) );
100 /* For a new lmb entry we want to sync with it after one minute. This
101 will allow it time to send out a local announce and build its
102 browse list.
105 browc->sync_time = now + 60;
107 /* Allow the new lmb to miss an announce period before we remove it. */
108 browc->death_time = now + ( (CHECK_TIME_MST_ANNOUNCE + 2) * 60 );
110 unstrcpy( browc->lmb_name, browser_name);
111 unstrcpy( browc->work_group, work_name);
112 if (!strupper_m( browc->lmb_name )) {
113 SAFE_FREE(browc);
114 return NULL;
116 if (!strupper_m( browc->work_group )) {
117 SAFE_FREE(browc);
118 return NULL;
121 browc->ip = ip;
123 DLIST_ADD_END(lmb_browserlist, browc, struct browse_cache_record *);
125 if( DEBUGLVL( 3 ) ) {
126 Debug1( "nmbd_browserdb:create_browser_in_lmb_cache()\n" );
127 Debug1( " Added lmb cache entry for workgroup %s ", browc->work_group );
128 Debug1( "name %s IP %s ", browc->lmb_name, inet_ntoa(ip) );
129 Debug1( "ttl %d\n", (int)browc->death_time );
132 return( browc );
135 /* ************************************************************************** **
136 * Find a browser entry in the local master browser list.
138 * Input: browser_name - The name for which to search.
140 * Output: A pointer to the matching entry, or NULL if no match was found.
142 * ************************************************************************** **
144 struct browse_cache_record *find_browser_in_lmb_cache( const char *browser_name )
146 struct browse_cache_record *browc;
148 for( browc = lmb_browserlist; browc; browc = browc->next ) {
149 if( strequal( browser_name, browc->lmb_name ) ) {
150 break;
154 return browc;
157 /* ************************************************************************** **
158 * Expire timed out browsers in the browserlist.
160 * Input: t - Expiration time. Entries with death times less than this
161 * value will be removed from the list.
162 * Output: none.
164 * ************************************************************************** **
166 void expire_lmb_browsers( time_t t )
168 struct browse_cache_record *browc;
169 struct browse_cache_record *nextbrowc;
171 for( browc = lmb_browserlist; browc; browc = nextbrowc) {
172 nextbrowc = browc->next;
174 if( browc->death_time < t ) {
175 if( DEBUGLVL( 3 ) ) {
176 Debug1( "nmbd_browserdb:expire_lmb_browsers()\n" );
177 Debug1( " Removing timed out lmb entry %s\n", browc->lmb_name );
179 remove_lmb_browser_entry( browc );