Guide to File Storage Feature

OSDN File Storage is a feature for file release, which allows uploading and managing in rsync, scp, and sftp.

How to Use

1. First, let's register the SSH public key from the user's settings.
2. Then turn on the File Storage feature from the project's admin page.
3. Lastly, to operate the upload and file management, refer to the command examples that are listed in the HELP area of the File Storage feature page.

Command example also avilable bellow:

rsync over ssh

rsync -a /your/files/dir/ username@storage.osdn.net:/storage/groups/p/pr/project1/

scp

scp -r srcfiles... username@storage.osdn.net:/storage/groups/p/pr/project1/

sftp

sftp username@storage.osdn.net:/storage/groups/p/pr/project1/

Note: We do not provide shell access on the storage server, so you can not use ssh or slogin command to access the file storage server

Release Notes

When README file is uploaded in txt, html, or Markdown, on the page of the URL that shows the directory where README file is located, details of the file will be shown at the bottom. It will be useful for release notes and such.

Cautions

• For file upload and management, you can not use other forms except rsync, scp, and sftp. We do not provide shell access on the storage server, so you can not use ssh or slogin command to access the storage server. ssh or slogin access will be always fail.
• Uploaded files will be granted adequate permissions automatically by the system.
• Directory can be made optionally.
• Dot file (including directories) can be uploaded but will not show on web. It will work like the limited release(Hidden) of a conventional package-style release system.
• File will be released as soon as it's been uploaded and will be open for downloads. You can not specify a release date just like a conventional package-style release system.

Direct Downloading

Currently, when there are download accesses from clients such as wget, curl, libwww-perl, PowerShell, apt, dnf, and other package management tools to a file URL, the file will be downloaded directly without going via html page. If you wish to add a client that allows direct downloading, please contact Support.

Simplifying File URLs

URLs that indicate files, that were made public by File Storage feature, will usually look like below.

• File URL: https://osdn.net/projects/(project name)/storage/(directory name)/(file name)

File storage features can treat general UNIX file system like UNIX file system, so you can create directory with as many layers as you wish. However, if you make the directory hierarchy complex, there's a disadvantage that the files that should be downloaded by users become hard to find. So storage feature offers simplified URLs like below that allows downloading with file name only.

• Simplified File URL: https://osdn.net/dl/(project name)/(file name)

There are times when different files with the same name exist in a project, but in such cases, the URL will indicate the file with a newer time stamp. By the way, URLs of this format are the same format as the former file release feature, and the principle that it becomes the URL indicating a newer file will be applied to file release features as well.