port latest changes from SAMBA_3_0 tree
[kamenim/samba.git] / source3 / nsswitch / winbindd.h
index 9de23b986d044b1c0545e91b227b282e55d1b33a..677afa1849f2f571627fec91a6c37f9de98dd2a1 100644 (file)
@@ -1,10 +1,10 @@
 /* 
-   Unix SMB/Netbios implementation.
-   Version 2.0
+   Unix SMB/CIFS implementation.
 
    Winbind daemon for ntdom nss module
 
    Copyright (C) Tim Potter 2000
+   Copyright (C) Jim McDonough <jmcd@us.ibm.com> 2003
    
    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
 
 #include "winbindd_nss.h"
 
+#undef DBGC_CLASS
+#define DBGC_CLASS DBGC_WINBIND
+
 /* Client state structure */
 
 struct winbindd_cli_state {
-    struct winbindd_cli_state *prev, *next;   /* Linked list pointers */
-    int sock;                                 /* Open socket from client */
-    pid_t pid;                                /* pid of client */
-    int read_buf_len, write_buf_len;          /* Indexes in request/response */
-    BOOL finished;                            /* Can delete from list */
-    BOOL write_extra_data;                    /* Write extra_data field */
-    struct winbindd_request request;          /* Request from client */
-    struct winbindd_response response;        /* Respose to client */
-    struct getent_state *getpwent_state;      /* State for getpwent() */
-    struct getent_state *getgrent_state;      /* State for getgrent() */
+       struct winbindd_cli_state *prev, *next;   /* Linked list pointers */
+       int sock;                                 /* Open socket from client */
+       pid_t pid;                                /* pid of client */
+       int read_buf_len, write_buf_len;          /* Indexes in request/response */
+       BOOL finished;                            /* Can delete from list */
+       BOOL write_extra_data;                    /* Write extra_data field */
+       time_t last_access;                       /* Time of last access (read or write) */
+       BOOL privileged;                           /* Is the client 'privileged' */
+
+       struct winbindd_request request;          /* Request from client */
+       struct winbindd_response response;        /* Respose to client */
+       struct getent_state *getpwent_state;      /* State for getpwent() */
+       struct getent_state *getgrent_state;      /* State for getgrent() */
 };
 
 /* State between get{pw,gr}ent() calls */
@@ -51,10 +57,8 @@ struct getent_state {
        struct getent_state *prev, *next;
        void *sam_entries;
        uint32 sam_entry_index, num_sam_entries;
-       uint32 dispinfo_ndx;
-       uint32 grp_query_start_ndx;
-       BOOL got_all_sam_entries, got_sam_entries;
-       struct winbindd_domain *domain;
+       BOOL got_sam_entries;
+       fstring domain_name;
 };
 
 /* Storage for cached getpwent() user entries */
@@ -62,7 +66,8 @@ struct getent_state {
 struct getpwent_user {
        fstring name;                        /* Account name */
        fstring gecos;                       /* User information */
-       uint32 user_rid, group_rid;          /* NT user and group rids */
+       DOM_SID user_sid;                    /* NT user and primary group SIDs */
+       DOM_SID group_sid;
 };
 
 /* Server state structure */
@@ -80,37 +85,119 @@ extern struct winbindd_state server_state;  /* Server information */
 typedef struct {
        char *acct_name;
        char *full_name;
-       uint32 user_rid;
-       uint32 group_rid; /* primary group */
-} WINBIND_DISPINFO;
+       DOM_SID *user_sid;                    /* NT user and primary group SIDs */
+       DOM_SID *group_sid;
+} WINBIND_USERINFO;
+
+/* Structures to hold per domain information */
+
+struct winbindd_domain {
+       fstring name;                          /* Domain name */        
+       fstring alt_name;                      /* alt Domain name (if any) */
+       DOM_SID sid;                           /* SID for this domain */
+       BOOL native_mode;                      /* is this a win2k domain in native mode ? */
+
+       /* Lookup methods for this domain (LDAP or RPC) */
+       struct winbindd_methods *methods;
+
+       /* the backend methods are used by the cache layer to find the right
+          backend */
+       struct winbindd_methods *backend;
+
+        /* Private data for the backends (used for connection cache) */
+
+       void *private; 
+
+       /* Sequence number stuff */
+
+       time_t last_seq_check;
+       uint32 sequence_number;
+       NTSTATUS last_status;
+
+       /* Linked list info */
+
+       struct winbindd_domain *prev, *next;
+};
 
 /* per-domain methods. This is how LDAP vs RPC is selected
-   This will eventually be the sole entry point to all the methods,
-   I'm just starting small
  */
 struct winbindd_methods {
-       NTSTATUS (*query_dispinfo)(struct winbindd_domain *domain,
+       /* does this backend provide a consistent view of the data? (ie. is the primary group
+          always correct) */
+       BOOL consistent;
+
+       /* get a list of users, returning a WINBIND_USERINFO for each one */
+       NTSTATUS (*query_user_list)(struct winbindd_domain *domain,
                                   TALLOC_CTX *mem_ctx,
-                                  uint32 *start_ndx, uint32 *num_entries, 
-                                  WINBIND_DISPINFO **info);
+                                  uint32 *num_entries, 
+                                  WINBIND_USERINFO **info);
 
+       /* get a list of domain groups */
        NTSTATUS (*enum_dom_groups)(struct winbindd_domain *domain,
                                    TALLOC_CTX *mem_ctx,
-                                   uint32 *start_ndx, uint32 *num_entries, 
+                                   uint32 *num_entries, 
                                    struct acct_info **info);
-};
 
-/* Structures to hold per domain information */
-struct winbindd_domain {
-       fstring name;                          /* Domain name */        
-       DOM_SID sid;                           /* SID for this domain */
-       struct winbindd_methods *methods;      /* lookup methods for
-                                                  this domain (LDAP or
-                                                  RPC) */
-       struct winbindd_domain *prev, *next;   /* Linked list info */
-};
+       /* get a list of domain local groups */
+       NTSTATUS (*enum_local_groups)(struct winbindd_domain *domain,
+                                   TALLOC_CTX *mem_ctx,
+                                   uint32 *num_entries, 
+                                   struct acct_info **info);
+                                   
+       /* convert one user or group name to a sid */
+       NTSTATUS (*name_to_sid)(struct winbindd_domain *domain,
+                               TALLOC_CTX *mem_ctx,
+                               const char *name,
+                               DOM_SID *sid,
+                               enum SID_NAME_USE *type);
+
+       /* convert a sid to a user or group name */
+       NTSTATUS (*sid_to_name)(struct winbindd_domain *domain,
+                               TALLOC_CTX *mem_ctx,
+                               DOM_SID *sid,
+                               char **name,
+                               enum SID_NAME_USE *type);
+
+       /* lookup user info for a given SID */
+       NTSTATUS (*query_user)(struct winbindd_domain *domain, 
+                              TALLOC_CTX *mem_ctx, 
+                              DOM_SID *user_sid,
+                              WINBIND_USERINFO *user_info);
+
+       /* lookup all groups that a user is a member of. The backend
+          can also choose to lookup by username or rid for this
+          function */
+       NTSTATUS (*lookup_usergroups)(struct winbindd_domain *domain,
+                                     TALLOC_CTX *mem_ctx,
+                                     DOM_SID *user_sid,
+                                     uint32 *num_groups, DOM_SID ***user_gids);
+
+       /* find all members of the group with the specified group_rid */
+       NTSTATUS (*lookup_groupmem)(struct winbindd_domain *domain,
+                                   TALLOC_CTX *mem_ctx,
+                                   DOM_SID *group_sid,
+                                   uint32 *num_names, 
+                                   DOM_SID ***sid_mem, char ***names, 
+                                   uint32 **name_types);
+
+       /* return the current global sequence number */
+       NTSTATUS (*sequence_number)(struct winbindd_domain *domain, uint32 *seq);
+
+       /* enumerate trusted domains */
+       NTSTATUS (*trusted_domains)(struct winbindd_domain *domain,
+                                   TALLOC_CTX *mem_ctx,
+                                   uint32 *num_domains,
+                                   char ***names,
+                                   char ***alt_names,
+                                   DOM_SID **dom_sids);
 
-extern struct winbindd_domain *domain_list;  /* List of domains we know */
+       /* find the domain sid */
+       NTSTATUS (*domain_sid)(struct winbindd_domain *domain,
+                              DOM_SID *sid);
+
+       /* setup the list of alternate names for the domain, if any */
+       NTSTATUS (*alternate_name)(struct winbindd_domain *domain);
+};
 
 /* Used to glue a policy handle and cli_state together */
 
@@ -119,26 +206,31 @@ typedef struct {
        POLICY_HND pol;
 } CLI_POLICY_HND;
 
-#include "winbindd_proto.h"
+/* Filled out by IDMAP backends */
+struct winbindd_idmap_methods {
+  /* Called when backend is first loaded */
+  BOOL (*init)(void);
+
+  BOOL (*get_sid_from_uid)(uid_t uid, DOM_SID *sid);
+  BOOL (*get_sid_from_gid)(gid_t gid, DOM_SID *sid);
+
+  BOOL (*get_uid_from_sid)(DOM_SID *sid, uid_t *uid);
+  BOOL (*get_gid_from_sid)(DOM_SID *sid, gid_t *gid);
+
+  /* Called when backend is unloaded */
+  BOOL (*close)(void);
+  /* Called to dump backend status */
+  void (*status)(void);
+};
+
+#include "../nsswitch/winbindd_proto.h"
 
 #include "rpc_parse.h"
 #include "rpc_client.h"
 
 #define WINBINDD_ESTABLISH_LOOP 30
-#define DOM_SEQUENCE_NONE ((uint32)-1)
+#define WINBINDD_RESCAN_FREQ 300
 
-/* SETENV */
-#if HAVE_SETENV
-#define SETENV(name, value, overwrite) setenv(name,value,overwrite)
-#elif HAVE_PUTENV
-#define SETENV(name, value, overwrite)                                  \
-{                                                                       \
-       fstring envvar;                                                  \
-       slprintf(envvar, sizeof(fstring), "%s=%s", name, value);         \
-       putenv(envvar);                                                  \
-}
-#else
-#define SETENV(name, value, overwrite) ;
-#endif
+#define DOM_SEQUENCE_NONE ((uint32)-1)
 
 #endif /* _WINBINDD_H */