TMSwitch.1

.\"Modified from man(1) of FreeBSD, the NetBSD mdoc.template, and mdoc.samples.
.\"See Also:
.\"man mdoc.samples for a complete listing of options
.\"man mdoc for the short list of editing options
.\"/usr/share/misc/mdoc.template
.Dd 20.03.10               \" DATE 
.Dt TMSwitch 1      \" Program name and manual section number 
.Os Darwin
.Sh NAME                 \" Section Header - required - don't modify 
.Nm TMSwitch
.\" The following lines are read in generating the apropos(man -k) database. Use only key
.\" words here as the database is built based on the words here and in the .ND line. 
.\" .Nm Other_name_for_same_program(),
.\" .Nm Yet another name for the same program.
.\" Use .Nm macro to designate other names for the documented program.
.Nd Switches Time Machine volume and status.
.Sh SYNOPSIS             \" Section Header - required - don't modify
.Nm
.Op Ar list
.Op Ar add|remove path              \" [file]
.Sh DESCRIPTION          \" Section Header - required - don't modify
Switches the current Time Machine volume.
Also switches the Time Machine status, turning Time Machine on when run between 8:08 and 22:30 and off otherwise.
.Pp
.Nm TMSwitch 
needs to be set up prior to usage and is best invoked automatically via a LaunchAgent when volumes are mounted.
.Pp
It can simplify dealing with several backup volumes by automating the switch between them.
.Sh SETUP
.Bl -tag -width -indent
.It list
Lists all known backup volumes 
.Nm TMSwitch 
may switch to
.It add /pathto/BackupVolume
Add new volume to the list of known backup volumes
.It remove /pathto/BackupVolume 
Remove volume from the list of known backup volumes
.El
.Sh USAGE
Call 
.Nm TMSwitch 
to switch the current Time Machine backup volume to the first mounted volume
.Nm TMSwitch 
finds in its list of known volumes. Doing so changes the /Library/Preferences/com.apple.TimeMachine.plist file.
.Pp
It may be a good idea to run /System/Library/CoreServices/backupd.bundle/Contents/Resources/backupd-helper with the -auto or -attach option immediately afterwards.

.Pp                      \" Inserts a space
.\" A list of items with descriptions:
.\" .Bl -tag -width -indent  \" Begins a tagged list 
.\" .It item a               \" Each item preceded by .It macro
.\" Description of item a
.\" .It item b
.\" Description of item b
.\" .El                      \" Ends the list
.\" .Pp
.\" A list of flags and their descriptions:
.\" .Bl -tag -width -indent  \" Differs from above in tag removed 
.\" .It Fl a                 \"-a flag as a list item
.\" Description of -a flag
.\" .It Fl b
.\" Description of -b flag
.\" .El                      \" Ends the list
.\" .Pp
.\" .Sh ENVIRONMENT      \" May not be needed
.\" .Bl -tag -width "ENV_VAR_1" -indent \" ENV_VAR_1 is width of the string ENV_VAR_1
.\" .It Ev ENV_VAR_1
.\" Description of ENV_VAR_1
.\" .It Ev ENV_VAR_2
.\" Description of ENV_VAR_2
.\" .El                      
.Sh FILES                \" File used or created by the topic of the man page
.Bl -tag -width -indent
.It Pa /Library/Preferences/com.apple.TimeMachine.plist
Settings file that is edited
.It Pa /System/Library/CoreServices/backupd.bundle/Contents/Resources/backupd-helper
Helper Tool to kick off Time Machine.
.El                      \" Ends the list
.\" .Sh DIAGNOSTICS       \" May not be needed
.\" .Bl -diag
.\" .It Diagnostic Tag
.\" Diagnostic informtion here.
.\" .It Diagnostic Tag
.\" Diagnostic informtion here.
.\" .El
.\".Sh SEE ALSO 
.\" List links in ascending order by section, alphabetically within a section.
.\" Please do not reference files that do not exist without filing a bug report
.\".Xr a 1 , 
.\".Xr b 1 ,
.\".Xr c 1 ,
.\".Xr a 2 ,
.\".Xr b 2 ,
.\".Xr a 3 ,
.\".Xr b 3 
.\" .Sh BUGS              \" Document known, unremedied bugs 
.\" .Sh HISTORY           \" Document history if command behaves in a unique manner
.Sh BY
Sven-S. Porst <ssp-web@earthlingsoft.net>
.Pp
Source code at http://github.com/ssp/TMSwitch