The Null Pointer Black

The Null Pointer Black is a simple CLI file storage service that allows you to upload files and share them via URL. Here's how to use it:

Terms of Service

Upload Options

1. HTTP POST Files

Upload a local file to the service:

curl -F'file=@yourfile.png' https://0x0.black

This command uploads yourfile.png from your local directory to the service.

2. POST Remote URLs

Upload a file from a remote URL:

curl -F'url=http://example.com/image.jpg' https://0x0.black

This fetches the file from the specified URL and uploads it to the service.

3. Secret URL (Harder to Guess)

Create a URL that's more difficult to guess by adding the secret parameter:

curl -F'file=@yourfile.png' -Fsecret= https://0x0.black
curl -F'url=http://example.com/image.jpg' -Fsecret= https://0x0.black
    

This adds a random string to the URL, making it harder for others to guess.

4. Custom File Name

Append your own file name to the URL:

https://0x0.black/aaa.jpg/image.jpeg

This allows you to specify a custom file name in the URL, which can be useful for organization or clarity.

5. Set Expiration Time (max 24hours)

Set an expiration time in hours:

curl -F'file=@yourfile.png' -Fexpires=24 https://0x0.black

Or as a timestamp in epoch milliseconds:

curl -F'file=@yourfile.png' -Fexpires=1681996320000 https://0x0.black

This allows you to specify when the file should be automatically deleted from the service.

The X-Token header is provided in the HTTP response when you upload a new file to the service. This token is essential for file management operations like deleting or changing the expiration date of the file.

If you upload a file that already exists on the service (i.e., a file with the same content), the X-Token header might not appear in the response. This is because the service identifies files by their content using a hash. If the file has been uploaded before, it is considered an existing file, and the management token is not reissued.

HTTP/1.1 200 OK
X-Expires: [Expiration Timestamp]
X-Token: [Your Management Token]
...
[File URL]
    

File Management

Use the token from the X-Token field in the HTTP response header for these operations:

1. Delete File

curl -Ftoken=your_token_here -Fdelete= https://0x0.black/abc.txt

This immediately deletes the file from the service.

2. Change Expiration Date

curl -Ftoken=your_token_here -Fexpires=3 https://0x0.black/abc.txt

This changes the expiration time of the file to 3 hours from now.

3. Download File

Download a file using its URL:

curl https://0x0.black/abc.txt -o downloaded_file.txt

This command downloads abc.txt from the service and saves it as downloaded_file.txt on your local machine.

Handling Errors with curl

When using curl, you might encounter errors. Here are some common issues and how to handle them:

1. Verbose Output

To get more information about what's happening, use the -v flag:

curl -v -F'file=@yourfile.png' https://0x0.black

This will show you the full HTTP request and response, which can be helpful for debugging.

2. Connection Errors

If you're having trouble connecting, try using the --connect-timeout option:

curl --connect-timeout 10 -F'file=@yourfile.png' https://0x0.black

This sets a 10-second connection timeout, which can help identify network issues.

3. SSL Certificate Issues

If you're having SSL certificate problems, you can bypass the certificate check (not recommended for security reasons):

curl -k -F'file=@yourfile.png' https://0x0.black

The -k option tells curl to skip certificate validation.

4. File Not Found

If curl can't find your local file, double-check the path and filename:

curl -F'file=@/full/path/to/yourfile.png' https://0x0.black

Using the full path can help avoid issues with relative paths.

Limitations

• Maximum file size: 512.0 MiB
• Files are automatically pruned 24h after upload
• Certain file types are not allowed: most executale type of files, macro enabled documents, java files, insatller files, torrent files, ... basically stuff that this service was not intended for.

For further assistance or inquiries: white(@)0x0.black