Update REAME with TMP directory setting instructions

This commit is contained in:
Will Hedgecock 2021-12-13 10:55:32 -06:00
parent 7e4e45493b
commit d456a72eac
2 changed files with 14 additions and 2 deletions

2
NOTICE
View File

@ -1,5 +1,5 @@
Fazecast jSerialComm
Copyright (C) 2012-2020 Fazecast, Inc.
Copyright (C) 2012-2022 Fazecast, Inc.
This product includes software developed at Fazecast, Inc: you can
redistribute it and/or modify it under the terms of either the Apache

View File

@ -97,7 +97,19 @@ Additionally, some systems may block execution of libraries from the system
temp folder. If you are experiencing this problem, you can specify a different,
less restrictive temp folder by adding
```System.setProperty("java.io.tmpdir", "/folder/where/execution/is/allowed")```
to your program before the first use of this library.
to your program before the first use of this library. When doing this, make sure
that the folder you specify already exists and has the correct permissions set
to allow execution of a shared library.
Optionally, the same result can be achieved by running your Java application
from the command line and specifying the `java.io.tmpdir` directory as an
additional parameter,
e.g.: ```java -Djava.io.tmpdir=/folder/of/your/choice -jar yourApplication.jar```
On Windows, you may be able to achieve the same result by setting the TMP
environment variable (either through the Settings->System Properties->Environment
Variables GUI or via ```SET TMP=C:\Desired\Tmp\Folder``` in a command terminal),
although setting this variable through Java is preferable when possible.
An additional note for Linux users: If you are operating this library in
event-based mode, the ```LISTENING_EVENT_DATA_WRITTEN``` event will never occur.