3 smugfs \- file system access to SmugMug photo sharing
23 is a user-level file system that provides access to images
24 stored on the SmugMug photo sharing service.
26 obtaining a password from
38 serves a virtual directory tree mounted at
48 The directory tree is arranged in five levels:
49 root, user, category, album, and image.
53 .B /n/smug/cmac/People/
54 is a category directory,
55 .B /n/smug/cmac/People/Friends/
56 is an album directory,
58 .B /n/smug/cmac/albums/Friends/2631/
59 is an image directory.
61 SmugMug allows fine-grained classification
62 via subcategories, but subcategories are not yet implemented.
64 Subcategories are inserted as
65 an additional directory level between category
67 [Subcategories are not yet implemented.]
70 All directories contain a special control file named
72 text commands written to
76 behavior or implement functionality
77 that does not fit nicely into the file system
81 caches information about users, categories, albums,
82 and images. If changes are made outside of
84 (for example, using a web browser),
85 the cache may need to be discarded.
92 to discard all cached information used to
93 present that directory and its children.
102 The root directory contains directories
104 By default, it contains only a directory for
105 the logged-in user, but other directories will
106 be created as needed to satisfy directory lookups.
108 In addition to user directories, the root directory
109 contains three special files:
116 returns a list of recent RPCs issued to the SmugMug API server.
117 Reads at the end of the file block until a new RPC is issued.
120 file lists the file upload queue (q.v.).
121 .SS "User directories"
122 User directories contain category directories
123 named after the categories.
124 SmugMug pre-defines a variety of categories,
125 so it is common to have many categories that
126 do not contain albums.
128 In a user directory, creating a new directory
129 creates a new category on SmugMug.
130 Similarly, renaming or removing a category
131 directory renames or removes the category on SmugMug.
132 Categories cannot be removed if they contain albums.
134 User directories also contain a directory
137 that itself contains all of that user's albums.
138 .SS "Category directories"
139 Each category directory contains album directories
140 named using the album's title.
142 In a category directory, creating a new directory
143 creates a new album on SmugMug.
144 Similarly, renaming or removing an album directory
145 renames or removes the album on SmugMug.
146 Albums cannot be removed if they contain images.
149 Category directories might also contain subcategory directories.
150 Like albums, subcategories can be renamed and removed (when empty).
151 Unlike albums, subcategories cannot be created via ordinary
152 file system operations.
153 Instead, write the command
160 Subcategories are identical to categories
161 except that they cannot themselves contain subcategories.
163 .SS "Album directories"
164 Each album directory contains image directories
165 named using the image's decimal SmugMug ID.
166 Image directories cannot be created or renamed,
167 but they can be removed. Removing an image directory
168 removes the image from the album on SmugMug.
170 Album directories also contain three special files,
178 file contains the album settings in textual form,
179 one setting per line.
180 Each line represents a single setting and is formatted
181 as an alphabetic setting name followed by a single tab
182 followed by the value.
183 Many settings can be changed by writing new setting lines,
184 in the same format, to the
188 Copying a file into the album directory queues it for
189 uploading to SmugMug to be added to the album.
190 Files disappear from the album directory once they
191 have finished uploading, replaced by new image directories.
194 file in the root directory lists all pending uploads,
195 which are stored temporarily
198 .SS "Image directories"
199 Each image directory contains an image file, named
200 with its original name, if available.
201 If the image belongs to another user, SmugMug does not
202 expose the original name, so the file is named
203 .RB \fInnnn\fP .jpg ,
206 is the SmugMug image ID number.
207 The file content is the original image
208 or else the largest image available.
210 The directory contains a
212 file holding per-image settings, similar to the
213 file in the album directory;
216 file, containing URLs to the various sized images
217 on the SmugMug server.
224 the current user must have write access to
232 Watch API calls as they execute:
235 % cat /n/smug/rpclog &
237 Create a new album in the Vacation category
238 and fill it with photos:
241 % mkdir /n/smug/you/Vacation/Summer
242 % cp *.jpg /n/smug/you/Vacation/Summer
245 The photos are now uploading in the background.
246 Wait for the uploads to finish:
249 % while(test -s /n/smug/uploads) sleep 60
252 Make the album publicly viewable and share it.
255 % echo public 1 >/n/smug/you/Vacation/Summer/settings
256 % cat /n/smug/you/Vacation/Summer/url | mail friends
259 .B \*9/src/cmd/smugfs
262 .HR http://smugmug.com/
265 If multiple categories or albums have the same name,
266 only one will be accessible via the file system interface.
267 Renaming the accessible one via Unix's
269 will resolve the problem.
271 Boolean values appear as
275 in settings files but must be changed using
