diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/snac.1 | 15 | ||||
| -rw-r--r-- | doc/snac.5 | 3 | ||||
| -rw-r--r-- | doc/snac.8 | 16 |
3 files changed, 20 insertions, 14 deletions
| @@ -288,7 +288,9 @@ Starts a migration from this account to the one set as an alias (see | |||
| 288 | section 'Migrating from snac to Mastodon'). | 288 | section 'Migrating from snac to Mastodon'). |
| 289 | .It Cm import_csv Ar basedir Ar uid | 289 | .It Cm import_csv Ar basedir Ar uid |
| 290 | Imports CSV data files from a Mastodon export. This command expects the | 290 | Imports CSV data files from a Mastodon export. This command expects the |
| 291 | following files to be in the current directory: | 291 | following files to be inside the |
| 292 | .Pa import/ | ||
| 293 | subdirectory of a user's directory inside the server base directory: | ||
| 292 | .Pa bookmarks.csv , | 294 | .Pa bookmarks.csv , |
| 293 | .Pa blocked_accounts.csv , | 295 | .Pa blocked_accounts.csv , |
| 294 | .Pa lists.csv , and | 296 | .Pa lists.csv , and |
| @@ -316,10 +318,15 @@ for a job to be assigned), input or output (processing I/O packets) | |||
| 316 | or stopped (not running, only to be seen while starting or stopping | 318 | or stopped (not running, only to be seen while starting or stopping |
| 317 | the server). | 319 | the server). |
| 318 | .It Cm import_list Ar basedir Ar uid Ar file | 320 | .It Cm import_list Ar basedir Ar uid Ar file |
| 319 | Imports a Mastodon list in CSV format. This option can be used to | 321 | Imports a Mastodon list in CSV format. The file must be stored inside the |
| 320 | import "Mastodon Follow Packs". | 322 | .Pa import/ |
| 323 | subdirectory of a user's directory inside the server base directory. | ||
| 324 | This option can be used to import "Mastodon Follow Packs". | ||
| 321 | .It Cm import_block_list Ar basedir Ar uid Ar file | 325 | .It Cm import_block_list Ar basedir Ar uid Ar file |
| 322 | Imports a Mastodon list of accounts to be blocked in CSV format. | 326 | Imports a Mastodon list of accounts to be blocked in CSV format. The |
| 327 | file must be stored inside the | ||
| 328 | .Pa import/ | ||
| 329 | subdirectory of a user's directory inside the server base directory. | ||
| 323 | .El | 330 | .El |
| 324 | .Ss Migrating an account to/from Mastodon | 331 | .Ss Migrating an account to/from Mastodon |
| 325 | See | 332 | See |
| @@ -212,6 +212,9 @@ local timeline in previous months or other cached data. | |||
| 212 | .It Pa export/ | 212 | .It Pa export/ |
| 213 | This directory will contain exported data in Mastodon-compatible CSV format | 213 | This directory will contain exported data in Mastodon-compatible CSV format |
| 214 | after executing the 'export_csv' command-line operation. | 214 | after executing the 'export_csv' command-line operation. |
| 215 | .It Pa import/ | ||
| 216 | Mastodon-compatible CSV files must be copied into this directory to use | ||
| 217 | any of the importing functions. | ||
| 215 | .It Pa server.pid | 218 | .It Pa server.pid |
| 216 | This file stores the server PID in a single text line. | 219 | This file stores the server PID in a single text line. |
| 217 | .El | 220 | .El |
| @@ -511,7 +511,9 @@ directory: | |||
| 511 | .Pa lists.csv , and | 511 | .Pa lists.csv , and |
| 512 | .Pa following_accounts.csv . | 512 | .Pa following_accounts.csv . |
| 513 | .Pp | 513 | .Pp |
| 514 | 2. From the directory where those files are stored, run | 514 | 2. Copy all those files to the |
| 515 | .Pa import/ | ||
| 516 | subdirectory of the user's directory inside the server base directory, and run | ||
| 515 | .Bd -literal -offset indent | 517 | .Bd -literal -offset indent |
| 516 | snac import_csv $SNAC_BASEDIR destination | 518 | snac import_csv $SNAC_BASEDIR destination |
| 517 | .Ed | 519 | .Ed |
| @@ -521,7 +523,9 @@ of all the ActivityPub servers involved (webfinger, accounts, posts, etc.). Some | |||
| 521 | may be transient and retried later. Also, if | 523 | may be transient and retried later. Also, if |
| 522 | .Nm | 524 | .Nm |
| 523 | complains that it can't find any of these files, please check that they are really | 525 | complains that it can't find any of these files, please check that they are really |
| 524 | stored in the current directory and that their names match exactly. Some of them may be | 526 | stored in the |
| 527 | .Pa import/ | ||
| 528 | subdirectory and that their names match exactly. Some of them may be | ||
| 525 | empty (for example, if you didn't create any list) and that's fine. | 529 | empty (for example, if you didn't create any list) and that's fine. |
| 526 | .Pp | 530 | .Pp |
| 527 | 3. Again on your | 531 | 3. Again on your |
| @@ -551,14 +555,6 @@ account from all accounts that followed the Mastodon one. According to the great | |||
| 551 | I linked above, this process may or may not start immediately, and its success may depend | 555 | I linked above, this process may or may not start immediately, and its success may depend |
| 552 | heavily on how all the servers involved behave. Just cross your fingers and hope for the best. | 556 | heavily on how all the servers involved behave. Just cross your fingers and hope for the best. |
| 553 | .Pp | 557 | .Pp |
| 554 | NOTE: If you run | ||
| 555 | .Nm | ||
| 556 | on OpenBSD, please take note that the pledge()/unveil() security system disallows | ||
| 557 | opening or creating files in the current directory; to do this operation, please | ||
| 558 | temporarily set the disable_openbsd_security option to true in the | ||
| 559 | .Pa server.json | ||
| 560 | file and restart before migrating. You can restore the option back to the default false | ||
| 561 | value afterwards. | ||
| 562 | .Ss Instance blocking | 558 | .Ss Instance blocking |
| 563 | Full instances can be blocked. This operation must be done from | 559 | Full instances can be blocked. This operation must be done from |
| 564 | the command-line tool. See | 560 | the command-line tool. See |