uid -> uids, i.e. pass a list of user ids to check for
[toast/findwwwritable.git] / findwwwritable.py
1 #!/usr/bin/python
2 # python 2.x is used
3
4 import os
5 import stat
6 from os.path import join
7
8
9 def collect_writable_dirs(rootdir, uids, gids):
10     """Returns a list of directories below rootdir (including rootdir) that are writeable 
11     by the users with the given uids or gids or that are world writeable.
12     Normally, uid(s) is the user id of the apache user (e.g. www-data) and gids is a list
13     of group ids this user is member of.
14     
15     :param rootdir: string. directory where the search should start at
16     :param uids: list of integer user ids
17     :param gids: list of integer group ids"""
18     assert isinstance(rootdir, str)
19     assert isinstance(uids, list)
20     for uid in uids: assert isinstance(uid, int)
21     assert isinstance(gids, list)
22     for gid in gids: assert isinstance(gid, int)
23
24     writable_dirs = [] # dirs with write permissions - this list is filled by this function
25
26     for root, dirs, files in os.walk(rootdir):
27         for d in dirs:
28             dp = join(root, d) # dp is the dir with path
29             s = os.lstat(dp)
30             if (s.st_mode & stat.S_IFLNK) == stat.S_IFLNK: continue # skip symlinks
31             if s.st_uid in uids and (s.st_mode & stat.S_IWUSR) > 0:
32                 writable_dirs.append(dp)
33             elif s.st_gid in gids and (s.st_mode & stat.S_IWGRP) > 0:
34                 writable_dirs.append(dp)
35             elif (s.st_mode & stat.S_IWOTH) > 0:
36                 writable_dirs.append(dp)
37
38     return writable_dirs
39
40
41
42 def summarize_dirs(writable_dirs):
43     """Takes a list of directories and omits each subdirectory if its parent directory
44     is also included in the list. This list is modified "in place" (nothing is returned).
45
46     :param writeable_dirs: List of directories (strings)."""
47     writable_dirs = sorted(writable_dirs)
48
49     i = 0
50     while i < len(writable_dirs)-1:
51         if writable_dirs[i+1].startswith(writable_dirs[i] + '/'):
52             del writable_dirs[i+1]
53         else:
54             i += 1
55
56
57
58 if __name__ == '__main__':
59
60     # variables
61     uids = [33]                # user ids of the user whos write permissions should be found
62     gids = [33, 42, 121, 127]  # group ids of the user whos write permissions should be found
63     rootdir = '/home'          # directory where the seach is started
64
65     # collect and summarize writeable directories
66     writable_dirs = collect_writable_dirs(rootdir, uids, gids)
67     summarize_dirs(writable_dirs)
68
69     # print writeable directories
70     for d in writable_dirs:
71         print d
72
73