Fossil

Check-in [aa36afc52c]
Login

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:Doc touchups.
Downloads: Tarball | ZIP archive
Timelines: family | ancestors | descendants | both | xfer-login-card
Files: files | file ages | folders
SHA3-256: aa36afc52c41a6a1c15e7fa8ec9fd97d928bd6140db8adc7931ee696fcdfe5c0
User & Date: stephan 2025-07-24 03:03:09.747
Context
2025-07-24
03:16
Previous checkin should not have compiled - clean rebuild uncovered a stale dep. Re-map the fLoginCardMode to a bitmask so that it's possible to tell when multiple paths toggle that on, and which paths they were. check-in: 780d3b2fe3 user: stephan tags: xfer-login-card
03:03
Doc touchups. check-in: aa36afc52c user: stephan tags: xfer-login-card
02:41
Update the change log and sync.wiki for the login card additions. check-in: edfa01d9d2 user: stephan tags: xfer-login-card
Changes
Unified Diff Ignore Whitespace Patch
Changes to www/sync.wiki.
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255





256
257
258
259
260
261
262

Only one login card is permitted. A second login card will trigger
a sync error. (Prior to 2025-07-21, the protocol permitted multiple
logins, treating the login as the union of all privileges from all
login cards. That capability was never used and has been removed.)

As of version 2.27, Fossil supports transfering of the login card
outside of the payload body, in one of the following ways:

<ul>
<li> URL parameter named "x-f-x-l". The value must be URL-encoded.
<li> An HTTP header named "X-Fossil-Xfer-Login". The caveat for the
     header is that CGI-hosted fossils cannot see the headers. It
     works for standalone severs and those running via fossil's
     "test-http" mechanism. This approach is retained, despite the CGI
     disadvantage, because the URL parameter approach cannot be used
     to capture sync payload bodies for re-use with the "test-http"
     mechanism, a capability useful in testing.
</ul>







<h3 id="file">3.3 File Cards</h3>

Artifacts are transferred using either "file" cards, or "cfile"
or "uvfile" cards.
The name "file" card comes from the fact that most artifacts correspond to







|


|
|

|
|
<
<
<

>
>
>
>
>







237
238
239
240
241
242
243
244
245
246
247
248
249
250
251



252
253
254
255
256
257
258
259
260
261
262
263
264

Only one login card is permitted. A second login card will trigger
a sync error. (Prior to 2025-07-21, the protocol permitted multiple
logins, treating the login as the union of all privileges from all
login cards. That capability was never used and has been removed.)

As of version 2.27, Fossil supports transfering of the login card
externally to the request payload in one of the following ways:

<ul>
<li> URL parameter named "x-f-x-l".
<li> An HTTP header named "X-Fossil-Xfer-Login". The caveat for this
     header is that CGI-hosted fossils cannot see the headers. It
     works for standalone severs and connections running via fossil's
     "test-http" mechanism.



</ul>

It is legal to use both of those approaches together but it is not
possible to use either of them with an in-body login card because
including an in-body login card would change the login card's value
for the header or URL parameter.


<h3 id="file">3.3 File Cards</h3>

Artifacts are transferred using either "file" cards, or "cfile"
or "uvfile" cards.
The name "file" card comes from the fact that most artifacts correspond to