[CalendarServer-changes] [5249] CalendarServer/trunk

[source_changes at macosforge.org]

Revision: 5249
          http://trac.macosforge.org/projects/calendarserver/changeset/5249
Author:   sagen at apple.com
Date:     2010-03-04 22:44:09 -0800 (Thu, 04 Mar 2010)
Log Message:
-----------
Adds manpage for calendarserver_purge_events, plus installs script

Modified Paths:
--------------
    CalendarServer/trunk/setup.py
    CalendarServer/trunk/support/Makefile.Apple

Added Paths:
-----------
    CalendarServer/trunk/doc/calendarserver_purge_events.8

Added: CalendarServer/trunk/doc/calendarserver_purge_events.8
===================================================================
--- CalendarServer/trunk/doc/calendarserver_purge_events.8	                        (rev 0)
+++ CalendarServer/trunk/doc/calendarserver_purge_events.8	2010-03-05 06:44:09 UTC (rev 5249)
@@ -0,0 +1,57 @@
+.\"
+.\" Copyright (c) 2006-2010 Apple Inc. All rights reserved.
+.\"
+.\" Licensed under the Apache License, Version 2.0 (the "License");
+.\" you may not use this file except in compliance with the License.
+.\" You may obtain a copy of the License at
+.\"
+.\"     http://www.apache.org/licenses/LICENSE-2.0
+.\"
+.\" Unless required by applicable law or agreed to in writing, software
+.\" distributed under the License is distributed on an "AS IS" BASIS,
+.\" WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+.\" See the License for the specific language governing permissions and
+.\" limitations under the License.
+.\"
+.\" The following requests are required for all man pages.
+.Dd June 17, 2009
+.Dt CALENDARSERVER_PURGE_EVENTS 8
+.Os
+.Sh NAME
+.Nm calendarserver_purge_events
+.Nd Darwin Calendar Server event clean-up utility
+.Sh SYNOPSIS
+.Nm
+.Op Fl -config Ar file
+.Op Fl -days Ad number
+.Op Fl -dry-run
+.Op Fl -verbose
+.Op Fl -help
+.Sh DESCRIPTION
+.Nm
+is a tool for removing old events from the calendar server.  By default, events older than 365 days are removed, but the user can specify the number of days in the past to use as a cut-off.  Repeating events that have any occurrences after the cut-off day are not removed.
+.Pp
+.Nm
+should be run as a user with the same priviledges as the Calendar
+Server itself, as it needs to read and write data that belongs to the
+server.
+.Sh OPTIONS
+.Bl -tag -width flag
+.It Fl h, -help
+Display usage information
+.It Fl f, -config Ar FILE
+Use the Calendar Server configuration specified in the given file.  Defaults to /etc/caldavd/caldavd.plist.
+.It Fl n, -dry-run
+Calculate and display how many events would be removed, but don't actually remove them.  
+.It Fl v, -verbose
+Print progress information including purged events per calendar home.  
+.It Fl d, -days Ar NUMBER
+Specify how many days in the past to retain.  Defaults to 365 days.
+.El
+.Sh FILES
+.Bl -tag -width flag
+.It /etc/caldavd/caldavd.plist
+The Calendar Server configuration file.
+.El
+.Sh SEE ALSO
+.Xr caldavd 8

Modified: CalendarServer/trunk/setup.py
===================================================================
--- CalendarServer/trunk/setup.py	2010-03-05 00:25:12 UTC (rev 5248)
+++ CalendarServer/trunk/setup.py	2010-03-05 06:44:09 UTC (rev 5249)
@@ -114,6 +114,7 @@
                              "bin/calendarserver_manage_augments",
                              "bin/calendarserver_manage_principals",
                              "bin/calendarserver_command_gateway",
+                             "bin/calendarserver_purge_events",
                              "bin/carddavd",
                            ],
         data_files       = [ ("caldavd", ["conf/caldavd.plist"]),

Modified: CalendarServer/trunk/support/Makefile.Apple
===================================================================
--- CalendarServer/trunk/support/Makefile.Apple	2010-03-05 00:25:12 UTC (rev 5248)
+++ CalendarServer/trunk/support/Makefile.Apple	2010-03-05 06:44:09 UTC (rev 5249)
@@ -111,6 +111,7 @@
 	$(_v) $(INSTALL_FILE) "$(Sources)/doc/calendarserver_export.8"            "$(DSTROOT)$(MANDIR)/man8"
 	$(_v) $(INSTALL_FILE) "$(Sources)/doc/calendarserver_manage_principals.8" "$(DSTROOT)$(MANDIR)/man8"
 	$(_v) $(INSTALL_FILE) "$(Sources)/doc/calendarserver_command_gateway.8"   "$(DSTROOT)$(MANDIR)/man8"
+	$(_v) $(INSTALL_FILE) "$(Sources)/doc/calendarserver_purge_events.8"   "$(DSTROOT)$(MANDIR)/man8"
 	$(_v) gzip -9 -f "$(DSTROOT)$(MANDIR)/man8/"*.[0-9]
 	@echo "Installing launchd config..."
 	$(_v) $(INSTALL_DIRECTORY) "$(DSTROOT)$(NSLOCALDIR)/$(NSLIBRARYSUBDIR)/$(Project)"
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/calendarserver-changes/attachments/20100304/4669ef0a/attachment.html>