lucidiot/NullSharp
lucidiot
/
NullSharp
Archived
1
0
Fork 0

Add README

This commit is contained in:
Lucidiot 2019-04-08 03:55:28 +02:00
parent 6c3933e42e
commit ec3a060b48
No known key found for this signature in database
GPG Key ID: AE3F7205692FA205
1 changed files with 41 additions and 0 deletions

41
README.md Normal file
View File

@ -0,0 +1,41 @@
# NullSharp
NullSharp is a C# API client for [/dev/null As A Service](https://devnull-as-a-service.com/) that lets you delete data securely in the cloud.
## Usage
The service has been implemented in this client as a write-only Stream:
``` csharp
using System;
using System.IO;
using NullSharp;
namespace MyProject
{
class Program
{
static void Main(string[] args)
{
string password = "hunter2";
var stream = new NullStream();
using (var sw = new StreamWriter(stream)) {
sw.WriteLine(password);
}
// Get rid of the local copy
password = null;
// ...immediately
GC.Collect();
GC.WaitForPendingFinalizers();
}
}
}
```
## Offline usage
You may use the standard [System.IO.Stream.Null](https://docs.microsoft.com/en-us/dotnet/api/system.io.stream.null), a special Stream that *should* write to nowhere; however, secure immediate deletion and end-to-end encryption are not guaranteed. You should only use this method when no other options are available and disclose the potential breach risks to your Data Protection Officer as it may not be GDPR-compliant.
## Disclaimer
Do **not** use this in any actual application code, unless you are crazy, want to prank someone, or heavily confuse whoever will maintain your code in ten years.