Another (but minor) documentation bug

T

TG4FOSS

Member
May 25, 2022
13
0
6
In the "Backup Repository Locations" section of the "Backup Client Usage" chapter, there is a table showing examples.

Is this line correct?
ExampleUserHost : PortDatastore
user@pbs!token@host:storeuser@pbs!tokenmyhostname:8007mydatastore

The user portion looks ok, but the shouldn't the Host : Port be "host:8007", and the Datastore be "store"?
 
According to other parts of the documentation the example looks fine:
The client uses the following format to specify a datastore repository on the backup server (where username is specified in the form of user@realm):

[[username@]server[:port]:]datastore
Click to expand...
Click to expand...
"user@pbs!token" is a valid username.
And "host:store" would also be correct as the port part is optional. I guess PBS will interpret "host:store" as "host:8007:store in case the second part is not an integer and will then assume you want to use the default port.

So a "host:store" or"user@pbs@host:store" or "user@pbs!token@host:store" or "user@pbs!token@host:8007:store" should be fine.
 
Last edited:
Dunuin said:
According to other parts of the documentation the example looks fine:

"user@pbs!token" is a valid username.
And "host:store" would also be correct as the port part is optional. I guess PBS will interpret "host:store" as "host:8007:store in case the second part is not an integer and will then assume you want to use the default port.

So a "host:store" or"user@pbs@host:store" or "user@pbs!token@host:store" or "user@pbs!token@host:8007:store" should be fine.
Click to expand...
Yes, the syntax looks fine. It's just that a parse of the value in the "Example" column doesn't yield the values in the other columns.
 
Jup, you are right. A "user@pbs!token@myhostname:8007:mydatastore" as an example would be less confusing.
 
TG4FOSS said:
OK, good. Hopefully someone can file a bug on it (I'm presently a non-subscription user).

... And while I've got you here, any chance you could help with the other documentation problem I'm having? It's at https://forum.proxmox.com/threads/documentation-errors-non-subscription-repos-for-pbs-client.112245/. The second post in the thread is the TL;DR.
Click to expand...
You don't need a subscription to file a bug or features request. Just create a account on the bug tracker and file it there: bugzilla.proxmox.com
 
You must log in or register to reply here.
Top Bottom