Login | ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/userdetect2/trunk/UserDetect2/README.md
Revision: 97
Committed: Mon Oct 25 15:23:58 2021 UTC (8 months, 1 week ago) by daniel-marschall
Content type: text/markdown
File size: 2853 byte(s)
Log Message:
Added README.md for UserDetect2

File Contents

# Content
1 # ViaThinkSoft UserDetect2
2
3 ## What is UserDetect2?
4
5 UserDetect2 is a program that allows the user to execute different programs depending on their current environment (e.g. MAC addresses, user name or computer name), so that a single executable file, e.g. shared over a network drive, a flash drive or external hard disk, can perform tasks for different work stations. The environment identifications can be extended by plugins.
6
7 ## Usage example
8
9 You have an external hard disk which you use for a daily backup with a backup tool (e.g. Microsoft RoboCopy).
10
11 You use this external drive to perform backups for different computers.
12
13 Additionally, you want to decide if the computer should be shutdown after the backup, or not. (Can be useful if you leave the computer alone, while the backup is performing)
14
15 If you have 2 computers with the names “JohnPC” and “JohnLaptop”, then you would probably need 4 batch files:
16
17 1. E:\JohnPC\backup_no_shutdown.bat
18 2. E:\JohnPC\backup_shutdown.bat
19 3. E:\JohnLaptop\backup_no_shutdown.bat
20 4. E:\JohnLaptop\backup_shutdown.bat
21
22 If you accidently start the wrong batch file, the backups will be inconsistent, and there may be data loss.
23
24 But if you use UserDetect2, you could create following Task Definition File:
25
26 [NoShutdown]
27 Description=Run backup without shutdown
28 ComputerName:JohnPC=JohnPC\backup_no_shutdown.bat
29 ComputerName:JohnLaptop=JohnLaptop\backup_no_shutdown.bat
30
31 [Shutdown]
32 Description=Run backup and shutdown
33 ComputerName:JohnPC=JohnPC\backup_shutdown.bat
34 ComputerName:JohnLaptop=JohnLaptop\backup_shutdown.bat
35
36 In this case, you would only need to run “E:\UserDetect2.exe” (maybe even use it as AutoRun application, if you are working with Windows Vista or previous versions of Windows) and then select if you want to perform a backup with or without shutdown. UserDetect2 will select the correct batch file for you.
37
38 ## Documentation
39
40 In the [documentation](https://github.com/danielmarschall/userdetect2/blob/master/UserDetect2/Documentation.pdf) you can read more about:
41
42 - Command line usage and return codes
43 - Task Definition File (UserDetect2.ini)
44 - Troubleshooting
45 - Plugin development / SDK
46 - Migration from the software "testuser" (predecessor)
47 - Known issues
48 - Changelog
49 - Contact the author
50
51 ## License
52
53 This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
54
55 This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.