| Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision |
| access:sysop [2022/02/28 13:52] – Copy/paste of Sysop definition and commands from old docs. Page is intentionally orphaned for now. Andre | access:sysop [2022/04/03 13:38] – [OS & Files] Now that I'm playing with the file section, I'm noticing that some string commands were missing. Andre |
|---|
| ====== Sysop ====== | ====== Sysop ====== |
| There is usually one sysop (System Operator) per BBS - the owner and operator of the hardware which Synchronet is running on and accepting remote users. Quite often systems require more than one sysop and Synchronet is flexible in this respect. Within Synchronet, a sysop is defined as any user with a main level of 90 or above. Any user that qualifies as a sysop, is prompted with an "SY:" to enter the system password at logon. Any time a sysop attempts to perform a sysop function that may breach the system security, he is prompted with an "SY:" to enter the system password before he can proceed. Users with sysop access can cause serious damage to the system. Give out this ability with caution. | The sysop (//**Sys**//tem //**Op**//erator) is the administrator that runs the BBS, and they have unlimited access and control over their instance of Synchronet and its users. When networked with other systems (e.g., DOVE-Net, FidoNet, inter-BBS chat), they are often considered responsible for any traffic originating from their system, including misconfigurations and any of their users' poor behavior. |
| |
| | There is usually one sysop per BBS, though Synchronet can be configured for multiple sysops (sometimes called co-sysops). In Synchronet, any user with a [[access:level|security level]] at or above 90 is considered a sysop. |
| |
| ===== Multiple Sysops ===== | Depending on the "Require Sys Pass During Login" in [[util:scfg:system|SCFG System Configuration]] under Toggle Options, the sysop will either be required to enter the system password at login or when performing a sysop-level function. Synchronet will prompt with ''SY:'' when asking for the system password. |
| As stated above, any user with a security level of 90 or greater can perform sysop functions, "So why have levels 91-99?" you might ask yourself. Well, you can still restrict a user with sysop access from accessing Message Groups or Sub-boards or File Libraries or Directories by setting the minimum required level above that user's level. For example: If you have a remote sysop with a security level of 90, you can still have a Message Group or Sub-board with a minimum required level of 91. Now this remote sysop will not be able to access that Group or Sub-board. While it is true that sysops can edit their own and subordinate user's accounts, they can not edit a sysop of higher level's account (when calling remotely). A remote sysop can't raise any user's level above his own, or add flags or exemptions that he himself doesn't have. | |
| | ===== Multiple Sysops / Co-Sysops ===== |
| | Multiple levels of sysop access (90-99) can be used to restrict some areas (i.e., message groups, sub-boards, file libraries, etc.) by setting the minimum required level of that area higher than the sysop's security level. |
| | |
| | Any user with a [[access:level|security level]] at or above 90 can perform sysop functions, including '';SHELL'' access with the same OS permissions as the OS user that the BBS runs as. |
| | |
| | Using the in-BBS '';UEDIT'' user editor, a sysop with security level at or above 90 cannot edit a sysop with a higher security level. '';SHELL'' can potentially give access to the useredit application that allows full user editing privileges, however. |
| | |
| | :!: Users with sysop access can cause damage to the BBS, as well as compromise the underlying operating system. Give out sysop-level access with caution. |
| |
| |
| Note: The Baja source code file for these commands is: exec/str_cmds.src | Note: The Baja source code file for these commands is: exec/str_cmds.src |
| |
| ^ Command ^ Name ^ Description ^ | ==== Usage ==== |
| | UEDIT [x] | User Edit | This command initiates the User Edit function. If 'x' is specified and is a valid user number, that user will be the current user when User Edit starts, otherwise the user online will be the current user. This command is also available from the transfer menu. Locally, Alt-U is the preferred method of initiating User Edit. \\ \\ See the chapter on User Edit for more information. | | * All commands are preceded by a '';'' |
| | SPY [n] | Spy on Another User | This command allows the sysop to remotely monitor or control another node running in the same instance as the node the sysop is logged into. | | * ''<>'' required parameter |
| | CHUSER | Change into Another User | This command allows the sysop to temporarily change to another user account. If changing to an account with a higher level, the password of that user must be given. Changing to an account of non-sysop status automatically enables Temp Sysop mode so that the sysop can change back to his/her own account before logging off (a suggested action). | | * ''[]'' optional parameter |
| | LOCK [x] | Lock Node | The sysop can use this command to prevent users logging onto a node until the lock is removed. If 'x' is specified, that node's lock status will be toggled, otherwise a list of all nodes is given and the sysop is prompted for the node to lock or unlock. Sysops and users with the 'L' exemption can use this command and log onto locked nodes. A locked node will have an 'L' in parenthesis after the node information in the node listings. | | * ''()'' required exemption |
| | INTR [x] | Interrupt Node | This command allows a sysop (or user with the 'I' exemption) to hang up on a user on another node. If the user is currently executing an external program (editors and transfer protocols included), he will not be disconnected until control returns to Synchronet. A message will be displayed telling the user that the node has been temporarily closed for maintenance before carrier is dropped. If 'x' is specified that node's interrupt status will be toggled, otherwise a list of all nodes is displayed and the sysop is prompted for the node who's interrupt state he wishes to toggle. The current interrupt status of a node is reflected by an 'I' in square brackets following the node information line in the node listings. | | |
| | DOWN [x] | Down Node | A sysop can toggle the down status of a node with this command. When a node has the down status (noted by the [D] flag on the node status line) it will be shutdown immediately after the user logs off. If a user is not online, it will shutdown immediately. | | |
| | ANON | Anonymous | This command makes the current node anonymous. Sysops and users with the 'Q' exemption have access to this command. To a sysop, an anonymous node appears normal with the addition of an 'A' in square brackets following the node information line. | | ==== Commands for All Users ==== |
| | QUIET | Quiet Mode | Using this command, a sysop (or user with the 'Q' exemption) can make his node appear to be "Waiting for call" to other users of the system. Users with this ability can also make this state their default state upon logon in the user defaults section. Local users can logon in this state with the WFC command SPACE, then 'Z' or user number 1 can logon fast and quiet with the WFC command SPACE, then 'Q'. \\ \\ To a sysop, a node in this state appears normal with the addition of a 'Q' in square brackets following the node information line. | | ^ Command ^ Name ^ Description ^ |
| | RERUN [x] | Rerun Node | This command allows a sysop to rerun any node on the system by specifying the node number on the command line. If there is a user on the node that is to be rerun, the node will not rerun until that user logs off. A node that is going to be rerun is noted with an 'R' in square brackets following the node information in node listings. | | | HELP | Display available string commands | List the string commands available to the user along with short descriptions. | |
| | DOS | Shell to DOS | Using this command, a sysop can go straight to the DOS command line locally or remotely. If the sysop is on locally, ALT-D is the preferred method of shelling to DOS. If a local sysop wishes to shell to DOS from the wait for call screen, he can use the 'D' command. | | | FIND [word] | Find a message area or file area | Returns a list of message areas or file areas matching the search term. Search [word] can be part of a word, a full word, or a phrase. The command will search message areas if run from the main menu, or will search file areas if run from the file menu. | |
| | EDIT [s] | Edit Text/MSG File | A sysop can edit any ASCII text (and MSG format) files on the system with this command. If 's' is given, it will be used as the filename to be opened or created if it doesn't exist. If 's' is not specified, the filename will be prompted for. | | | MSGS | Redisplay messages | Redisplay instant messages (notifications and telegrams) that the user previously received. | |
| | LOG | Today's Detail Log | A sysop can view today's detailed log file with this command. This command views the same file as the 'L' wait for call screen command. | | | PLAN | Edit .plan file | Edits or deletes your ''.plan'' file (displayed when somebody [[service:finger|Fingers]] you). | |
| | YLOG | Yesterday's Detail Log | A sysop can view yesterday's detailed log file with this command. This command views the same file as the 'Y' wait for call screen command. | | | POFF | Pager off | Toggles if other users can page you during this session for a multinode chat. | |
| | NS [x] | Node Statistics | This command will give today's statistics for node 'x' if specified, or the current node. | | |
| | SS | System Statistics | This command will give today's statistics for all nodes combined. | | |
| | NLOG [x] | Node Statistics Log | A sysop can view the history of statistics information for any node on the system. If 'x' is specified, that will be the node who's statistics are viewed, otherwise the current node. Same as 'N' from the wait for call screen. | | ==== User & Mail Management ==== |
| | SLOG | System Statistics Log | Using this command, a sysop can view the history of statistics information for the system. Same as 'S' from the wait for call screen. | | ^ Command ^ Name ^ Description ^ |
| | LIST [s] | View Text/MSG File | A sysop can use this command to view any ASCII text (or MSG format) file on the system. If the filename 's' is not specified, it is prompted for. | | | UEDIT [user number or name] | User editor | Starts the User Edit function, allowing the sysop to edit or delete/restore users. If a [user] is specified it will be the current user when User Edit starts. FIXME add link when user editor page is created | |
| | GURU | View Guru Log | A sysop can use this command to view the GURU.LOG file which contains discussions that users have had with the system guru (GURU.DAT). See GURU.DAT for more information. | | | BULKMAIL | Send mass mail | Sends an email to all users that match a specified [[access:requirements|Access Requirements String]] ("ARS"). | |
| | MAIL | Read All Mail | Using this command (or 'M' from the WFC screen) a sysop can read all the e-mail on the system. | | | CHUSER | Change to another user | Allows the sysop to temporarily change to another user account. If changing to an account with a higher level, the password of that user must be given. Changing to a user of non-sysop status automatically enables //Temp Sysop// mode so that the sysop can change back to their own account before logging off (a suggested action). | |
| | BULKMAIL | Send Mass Mailing | Use this command to send a single e-mail message to multiple users. | | | MAIL | Read all mail | Read all the email in the mail base, regardless of recipient. | |
| | CALL [Hub-ID] | Force QWKnet Call-out | Forces a QWKnet call-out to the hub "Hub-ID" the next time the call-out node is at the WFC screen. Example: CALL VERT | | |
| | EXEC [Command] | Execute a DOS program or Baja module | Execute internal DOS commands (DIR, TYPE, etc.) by prepending "command /c" to your command line. Execute Baja modules by prepending "*" to the command line. Baja modules must be located in your EXEC directory. Command line specifiers (see appendix A) may be used. | | |
| | CHAT | FIXME | Users with the 'C' exemption can use this command to page the sysop. | | ==== Node Control ==== |
| | OLD | Search for Files not Downloaded Since New-Scan Date | A sysop can use this command to remove, edit, or move files that were uploaded before the new-scan date (set with the '&P' transfer section command) and have not been downloaded since. | | ^ Command ^ Name ^ Description ^ |
| | OLDUL | Search for Files Uploaded Before New-Scan Date | A sysop can use this command to remove, edit, or move files that were uploaded before the new-scan date (set with the '&P' transfer section command). | | | NODE [parameters] | Node utility | Executes [[util:node|node utility]] with the passed parameters. | |
| | CLOSE | Search for Files Currently Open | If there are no users online and all nodes are running, there should be no file records open. A sysop can check for open file records with this command. Any file records that are left open erroneously, can be closed with this command. This circumstance should not happen. | | | DOWN [#] | Down node | Toggles the down status of a node. When a node has a down status (noted by the [D] flag on the node status line) it will be shut down after the user logs off, or immediately if a user is not online. If a node [#] is not specified, the current node will be shut down. \\ \\ To put an "Offline" node back to a "Waiting for Connection" status, use '';NODE STATUS=0 [node #]''. | |
| | ALTUL [x] | Alternate File Path Uploads | If there are alternate file paths configured, a sysop can use this command to set the current upload path to one of the alternate file paths. All subsequent upload commands will use the alternate upload path as the storage directory regardless of the storage path specified for the directory being uploaded to. This is a useful command for those who wish to have one directory with files listed from multiple CD-ROMs. | | | INTR [#] | Interrupt node | Disconnect a user as soon as it is safe to do so, displaying a "closed for maintenance" message. The current interrupt status of a node is reflected by an [I] in the node listings. If a node [#] is not specified, the current node will be interrupted. \\ \\ If the user is currently executing an [[howto:door:index|external program]] (including [[howto:editor:index|editors]] and transfer protocols), they will be disconnected as soon as control returns to Synchronet. | |
| | UPLOAD | Bulk Local Upload | This command searches for files that are on disk, but not in the database of the directory. If any are found, a description is prompted for and the file is then added to the database. | | | LOCK [#] | Lock node | Prevent users from logging into a node, giving a "down for maintenance" message. A locked node will have an (L) in the node listings. If a node [#] is not specified, the current node will be locked. \\ \\ Sysops and users with the ''L'' [[access:exemptions|exemption]] can still log in. | |
| | RESORT | Re-Sort and/or Compress | A sysop can use this command to re-sort a directory if he has changed the sort order in the directory configuration or can use this command to remove deleted file records from the database to conserve memory and disk space. If there are many deleted files in the database of a directory, performance will also be affected. Deleted file records are used by new uploaded files, but if a substantial amount of files have been removed from a directory, a sysop may wish to use this command. | | | RERUN [#] | Rerun node | Toggles the rerun status of a node (noted by an [R] in the node listing), reloading the configuration before the next login. If individual nodes have a rerun status, that node's configuration will be reloaded just before the next user logs in. If all nodes have a rerun status, the configuration for the nodes will be reloaded when all users have logged off. \\ \\ Note: Saving a configuration change in [[util:scfg|SCFG]] will set a rerun status on all nodes. | |
| | OFFLINE | Search for Offline Files | This command will search the disk for files that are in the database of a directory but not actually on the disk. The sysop can then remove, edit, or move these files to another directory. Offline directories are ignored in this search. | | | SPY [#] | Spy on a node | Allows the sysop to remotely monitor or control another node. | |
| | DIR [s] | Directory of Files | This command displays a DOS directory of the path specified. If no path is specified, a directory of the current file transfer directory is displayed. | | |
| | GET [s] | Download File From Anywhere | A sysop can download a file from any drive or directory on the system by using this command. The file does not have to be in the file database. | | |
| | PUT [s] | Upload File to Anywhere | A sysop can use this command to upload a file to a local disk without having to add it to the file database. | | ==== Logging & Stats ==== |
| | ^ Command ^ Name ^ Description ^ |
| | | ERR | Critical error log | View the error log and optionally delete it, as well as optionally clearing all nodes' error counters. | |
| | | LOG | Today's log | View today's detailed node log file. | |
| | | YLOG | Yesterday's log | View yesterday's detailed node log file. | |
| | | NLOG [#] | Node statistics log | View the historical, daily statistics for a single node. Statistics for the current node will be shown unless a node [#] is specified. | |
| | | NS [#] | Node statistics | Today's statistics for single node. The node [#] will be prompted for if it is not provided. | |
| | | SLOG | System statistics log | View the historical, daily statistics for the system (sum of all nodes). | |
| | | SS | System statistics | Today's combined statistics for all nodes. | |
| | |
| | |
| | ==== Node & Sysop Display ==== |
| | ^ Command ^ Name ^ Description ^ |
| | | ANON | Toggle anonymous mode | Makes the current node anonymous, where the node is listed normally but the user is displayed as "Unknown User." To a sysop, an anonymous node appears normally with the addition of an [A] in the node information line. \\ \\ Sysops and users with the ''Q'' exemption have access to this command. | |
| | | AVAIL | Toggle sysop chat availability | Changes the ability for users to page the sysop for a private chat, visible to them in the [[module:chat_sec|chat module]]. \\ \\ This setting can be overridden by users with a ''C'' exemption or by the [[util:scfg:system|SCFG System Config]] "Sysop Chat Override" Advanced Option. | |
| | | QUIET | Quiet mode | Make the current node appear to be "Waiting for call" to other users. To a sysop, a quiet node appears normally with the addition of a [Q] in the node information line. \\ \\ Sysops and users with the ''Q'' exemption have access to this command. | |
| | |
| | |
| | ==== OS & Files ==== |
| | :!: For any commands where a path is requested, the current working directory is ''ctrl/'' |
| | |
| | ^ Command ^ Name ^ Description ^ |
| | | =) EXEC [command] | FIXME Execute a command with I/O redirected | FIXME Execute internal DOS commands (DIR, TYPE, etc.) by prepending "command /c" to your command line. Execute Baja modules by prepending "*" to the command line. Baja modules must be located in your EXEC directory. Command line specifiers (see appendix A) may be used. | |
| | | =) FOSSIL [command] | Execute FOSSIL driver command | FIXME | |
| | | =) NEXEC [command] | Execute native binary with I/O redirected | FIXME | |
| | | DIR [path] | List files | Displays a directory listing of the specified path. | |
| | | GET [path/file] | Download file | Download a file from any directory on the BBS host system. The file does not have to be in the file database. | |
| | | PUT [path/file] | Upload file | Upload a file to any directory on the BBS host system without having to add it to the file database. | |
| | | OLD | Remove/Edit/Move un-downloaded files | Remove, edit, or move files that have not been downloaded since the new-scan date.\\ \\ Can be followed by ''LIB'' or ''ALL'' to affect files in all directories of the current library, or all directories in all libraries. | |
| | | OLDUL | Remove/Edit/Move old uploaded | Remove, edit, or move files that were uploaded before the new-scan date.\\ \\ Can be followed by ''LIB'' or ''ALL'' to affect files in all directories of the current library, or all directories in all libraries. | |
| | | UPLOAD | Bulk local upload | Bulk add files to the database that are already on the BBS host's local disk.\\ \\ Can be followed by ''LIB'' or ''ALL'' to affect files in all directories of the current library, or all directories in all libraries. | |
| | | OFFLINE | Remove/Edit/Move missing files | Remove, edit, or move files that are in the database but are no longer on the BBS host's local disk.\\ \\ Can be followed by ''LIB'' or ''ALL'' to affect files in all directories of the current library, or all directories in all libraries. | |
| | | TYPE [path/file] | View text/msg file | View any ASCII text or MSG format file on the system. \\ \\ Aliases CAT or LIST also invoke this command. | |
| | | EDIT [path/file] | File editor | Edit any ASCII text or MSG format file on the system using your message editor. If the specified filename does not already exist it will be created. | |
| | | DOS | DOS command shell | Go to the Windows/DOS command line (command.com) with I/O redirected. | |
| | | SHELL | Unix command shell | Starts a native Unix shell (COMSPEC or SHELL env variable). | |
| | |
| | |
| | ==== Miscellaneous ==== |
| | ^ Command ^ Name ^ Description ^ |
| | | CALL <Hub-ID> | Force QWKnet callout | Forces a QWKnet callout to the specified <Hub-ID> outside of the normal timed events [[howto:dove-net|configured]] in SCFG. Example: ''CALL VERT'' | |
| | | CHAT | Page sysop | Users with the ''C'' [[access:exemptions|exemption]] can use this command to page the sysop for chat. | |
| | | ECHO [string] | Print a text message | Prints a string, including [[custom:atcodes|Message Variables (@-codes)]]. | |
| | | EVAL [parameters] | Evaluate JavaScript | Evaluate a JavaScript expression and display the result. | |
| | | EVENT [EventID] | Execute event | Forces a [[util:scfg:external_programs|timed event]] to execute with a [[config:semfiles|semaphore file]]. If the [EventID] is not specified, a menu of timed events will be shown. | |
| | | GURU | Guru log | Display and optionally clear the GURU.LOG file that contains user discussions with the [[https://www.synchro.net/docs/chat_section.html#ArtificialChatGurus|system guru]] (GURU.DAT). | |
| | | LOAD [file] | Load alternate text.dat | Loads a custom [[custom:text.dat|text.dat]] from the specified filename. | |
| |
| ===== See Also ===== | ===== See Also ===== |
