[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
AIX Fast Connect
Version 3.1 Guide
net Command
Purpose
Configures and controls Fast Connect servers.
Syntax
net [ help | start | stop | pause | resume | config | status | statistics | trace | user | share | name | session | (NBNS subcommands) ]
Description
The net command configures and controls Fast Connect
servers.
Subcommands
| help |
Displays help on the subcommand. |
| start |
Starts the server. |
| stop |
Stops the server. |
| pause |
Stops the server temporarily. |
| resume |
Resumes the paused server. |
| config |
Lists and changes configuration parameters for the server. |
| status |
Gives status of the server. |
| statistics |
Gives statistics on server resources. |
| trace |
Turns the server tracing on and off. |
| user |
Lists, adds, deletes, and modifies user accounts on the server. |
| share |
Lists, adds or deletes file and printer shares on the server. |
| name |
Lists, adds, or deletes server name aliases. |
| session |
Administer user sessions on the server. |
| nblistnames |
Lists the NBNS name table. |
| nbbackup |
Writes the NBNS name table to a file. |
| nbrestore |
Restores the NBNS name table from a file. |
| nbaddname |
Adds a NetBIOS unique name to the NBNS name table. |
| nbaddgroup |
Adds a NetBIOS group name to the NBNS name table. |
| nbaddmulti |
Adds a NetBIOS multihomed name to the NBNS name table. |
| nbdelname |
Deletes a name from the NBNS name table. |
| nbaddingrp |
Adds a NetBIOS internet group name to the NBNS name table. |
| nbdeladdr |
Deletes an IP address in the NBNS name table of an NetBIOS internet
group name. |
| nbstatus |
Gives status of NetBIOS Name Server. |
net help Subcommand
- Syntax
- net help subcommand
or
net subcommand help
- Description
- Provides help information about the subcommands.
net start Subcommand
- Purpose
- Starts the server
- Syntax
- net start [/load]
- Description
- The start subcommand starts and initializes the
server using parameters from the configuration file. It can start the server
only if the server process is already loaded but the server is in stopped
(not running) state.
Note: Normally, instead
of net start /load, use /etc/rc.cifs
start to load and start the server, so that extra performance parameters
are configured for AIX Fast Connect.
- Flags
-
- /load
- Loads the server process if it is not already loaded.
-
-
- Return Codes
-
- 0
- The server (%s) is already running.
- 0
- The server (%s) has started successfully.
- 1
- Syntax error was detected: Unknown keyword or command option (%s).
- 2
- The server (%s) could not be started because its process was not running.
- 3
- The request is not valid for the current state of the server (%s).
- 4
- Operation could not be performed.
-
-
net stop Subcommand
- Purpose
- Stops and unloads the server process.
- Syntax
- net stop [/unload]
- Description
- The net stop subcommand stops and unloads the
server. It can stop the server only if it is running or paused. After it is
stopped, the server can be restarted using /etc/rc.cifs start.
- Flags
-
- /unload
- Unloads the server process.
-
-
- Return Codes
-
- 0
- The server (%s) has stopped successfully.
- 0
- The server (%s) has stopped and its process unloaded successfully.
- 1
- Syntax error detected: Unknown keyword or command option (%s).
- 2
- The request is not valid for the current state of the server (%s).
- 3
- Error in unloading the server process on the server (%s).
- 4
- Operation could not be performed.
- 5
- Either cifsPrintServer is not running or it could not be terminated.
-
-
net pause Subcommand
- Purpose
- Pauses the server
- Syntax
- net pause
- Description
- The net pause subcommand pauses the server. It
can pause the server only if it is running. After it is paused, the server
does not accept any new connections but continues serving the existing ones.
It can be resumed with the net resume subcommand.
- Return Codes
-
- 0
- The server (%s) has paused successfully.
- 1
- Syntax error detected: Unknown keyword or command option (%s).
- 2
- The request is not valid for the current state of server
- 3
- Operation could not be performed.
-
-
net resume Subcommand
- Purpose
- Resumes the server.
- Syntax
- net resume
- Description
- The net resume subcommand resumes the server.
It can resume the server only if it is paused. After it is resumed, it starts
accepting new connections.
- Return Codes
-
- 0
- The server (%s) has resumed successfully.
- 1
- Syntax error detected: Unknown keyword or command option (%s).
- 2
- The request is not valid for the current state of server
- 3
- Operation could not be performed.
-
-
net config Subcommand
- Purpose
- Lists and changes the configuration parameters of the server.
- Syntax1
- net config
- Syntax2
- net config /component
- Syntax3
- net config /component:cname /parameter:value
- Syntax4
- net config [ /listparm ]
[ /component:cname ] /parm:parameter
- Description
- The net config subcommand lists and changes the
configuration parameters of the server. For example:
- Syntax1
- Lists the configuration parameters.
- Syntax2
- Lists all the components or groups of configuration parameters for the
server.
- Syntax3
- Adds or changes the given parameter for the
given component cname.
- Syntax4
- Lists the entry for the given parameter for
the given component cname from the configuration file.
Note: Only the root user can change configuration
parameters.
-
-
- Flags
-
- /listparm
- Lists the given parameter for the given component.
- /component:cname
- Specifies the component in the configuration file whose parameter needs
to be added or changed. The default component is smbserver, the AIX Fast Connect server.
The parameter can
be one of the following:
- /maxconnections:number
- Maximum number of connections to server resources. 0 specifies unlimited
number.
- /maxusers:number
- Maximum number of users (sessions) that are permitted. 0 specifies unlimited
number.
- /autodisconnect:number
- Timeout (in minutes) for inactive, unused sessions.
- /maxopens:number
- Maximum number of open files on the server. 0 specifies unlimited number.
- /maxsearches:number
- Maximum number of open searches on the server. 0 specifies unlimited
number.
- /servername:s_name
- The name of the server.
- /domainname:d_name
- The name of the domain that the server belongs to.
- /guestname:g_name
- Logon name as guest on the server.
- /passthrough_authentication_server:pas_name
- The name of the passthrough authentication server.
- /backup_passthrough_authentication_server:bpas_name
- The name of the backup passthrough authentication server.
- /primary_wins_ipaddr:pwins_addr
- Specifies the dotted IP address of the primary WINS server.
- /secondary_wins_ipaddr:swin_ipaddr
- Specifies the dotted IP address of the secondary WINS server.
- /wins_proxy:0|1
- Specifies whether the server must act as WINS PROXY. Valid values are
0 for no and 1 for yes, with 0 as the default value.
- /send_file_api:0|1
- Specifies whether the send_file API is to be used.
Valid values are 0 for off and 1 for on, with 1 as the default value.
- /send_file_size:sf_size
- If the send_file_api is 1 and the requested SMB
read size is greater than the value of this parameter, send_file API will be used in the SMB operation. The value ranges between 1 and
4194304, with 4096 as the default value.
- /send_file_cache_size:sfc_size
- If the send_file_api is 1 and the requested SMB
read size is less than the value of this parameter, the send_file API will cache the file. The value ranges between 0 and 4194304
with 0 as the default value, which means that the send_file API will not cache the file.
- /umask:u_mask
- umask. It is an octal value and ranges between
0 and 0777, with 022 as the default value.
- /guestlogonsupport: 0|1
- Specifies whether guest access is allowed. Valid values are 0 for no
and 1 for yes, with 0 as the default value.
- /dosattrmapping:0|1
- If set to 1, Archive, System, and Hidden attributes will be mapped
to user, group, and other execute bits, respectively. Otherwise, these attributes
are not supported.
- /dosfilenamemapping:0|1
- If set to 1, long file names will be mapped to 8.3 format. Otherwise,
long file names will be truncated.
- /dosfilenamemapchar:m_char
- The character used to map long file names to 8.3 format. Valid values
are'~' and '^' with '~' being the default.
-
-
-
-
- Return Codes
-
- 0
- Command completed successfully.
- 1
- Syntax error: Unknown keyword or command option (%s).
- 2
- Command could not be executed. Invalid parameter value (%s).
- 3
- Operation could not be performed.
-
-
Output for syntax1 command net config
Server Name ........
Server Description ........
Server Software version ........
Domain Name ........
Primary WINS IP Address ........
Secondary WINS IP Address ........
Passthrough Authentication Server ........
Backup Passthrough Authentication Server ........
Guest logon ID ........
Assuming that the smbserver has shares FILE0 and PRINT1 defined, and also has the following entries:
servername = fcserver
comment = Fast Connect server
Output for syntax2 command net config /component
smbserver
en
FILE0
PRINT1
Output for syntax4 command net config /parm:servername
fcserver
Output for syntax4 command net config /parm:comment
Fast Connect server
net status Subcommand
- Purpose
- Displays status of the server.
- Syntax
- net status
- Description
- The status subcommand displays status of the server,
as either running, paused, or stopped.
- Return Codes
-
- 0
- Server (%s) is running.
- 1
- Syntax error: Unknown keyword or command option (%s).
- 2
- Server (%s) is not running.
- 3
- Server (%s) has been paused.
- 4
- Operation could not be performed
-
-
net statistics Subcommand
- Purpose
- Displays the statistics on server resource usage.
- Syntax
- net statistics [ /reset ]
- Description
- Lists the statistics on server resources since it was started, or it
resets the statistics.
- Flags
-
- /reset
- Resets all statistic fields for the server.
-
-
- Return Codes
-
- 0
- Command completed successfully.
- 1
- Syntax error: Unknown keyword or command option (%s).
- 2
- Operation could not be performed.
-
-
- Output
-
Server statistics for server (%s) since %s time
Sessions started .....
Sessions timed out .....
Sessions dropped .....
Password Errors .....
Permission Errors .....
Bytes sent low .....
Bytes sent high .....
Bytes received low .....
Bytes received high .....
Request buffer failures .....
Big buffer failures .....
Print jobs queued .....
net trace Subcommand
- Purpose
- Turns tracing on or off for the server.
- Syntax1
- net trace /on
- Syntax2
- net trace /off
- Description
- Turns tracing on or off for the server. The user does not have to start
or stop the server.
- Flags
-
- /on
- Turns tracing on.
- /off
- Turns tracing off.
-
-
- Return Codes
-
- 0
- Command completed successfully.
- 1
- Syntax error: Unknown keyword or command option (%s).
- 2
- Operation could not be performed.
-
-
net user Subcommand
- Purpose
- To list, add, delete, and modify AIX Fast Connect user accounts to
support password encryption and client-to-server user-name mappings.
- Syntax1
- net user [username [ {password|-p} [/changeaixpwd:{yes|no}] ]
[/active:{yes|no}] [/comment:text] [/serverUserName:srvUserName] ]
- Syntax2
- net user /add username {password|-p} [/changeaixpwd:{yes|no}] [/active:{yes|no}]
[/comment:text]
- Syntax3
- net user /delete username
- Syntax4
- net user /map clientUserName srvUserName
- Syntax5
- net user /showmapping:username
- Description
- Syntax1 lists or modifies AIX Fast Connect user accounts.
Syntax2
adds a user on the server.
Syntax3 deletes the given
user from the server.
Syntax4 maps a client user name
to a server user name.
Syntax5 lists all the mappings
related to the specified user name.
- Parameters
-
- username
- The user name of the account to list, add, delete, or modify, either
a client user name or a server user name.
- clientUserName
- The name of the user account on the client machine. The maximum length
is 25 characters.
- srvUserName
- The name of the user account on the server machine. The maximum length
is 8 characters.
- password
- The password to be assigned or changed for the account. All client
usernames that map to this server account will be affected.
- -p
- Produces a prompt for the password. The password is not displayed when
it is typed at the password prompt.
-
-
- Flags
-
- /add
- Adds a AIX Fast Connect user account to support encrypted passwords.
- /delete
- Deletes the given AIX Fast Connect user-name mapping or encrypted password
support.
- /changeaixpwd:{yes|no}
- Change the system password of the user name to match the AIX Fast Connect user
password. Requires root access.
- /active:{yes|no}
- Activates or deactivates the account. If the account is not active,
the user cannot access the AIX Fast Connect server. The default is yes.
- /comment:text
- Provides a descriptive comment about the user's account. Enclose the
text in quotation marks.
- /serverUserName:srvUserName
- The username specified is remapped to srvUserName.
- /map
- Creates a user-name mapping from clientUserName to srvUserName.
- /showmapping:username
- Shows all the client-name mappings for the given user name.
-
-
Note: This subcommand manages a user database
file (/etc/cifs/cifsPasswd) specific to AIX Fast Connect,
which is used only for user-name mapping and encrypted passwords. These two
features operate independently, and are enabled/disabled by the usernamemapping and encrypt_passwords configuration
parameters.
net share Subcommand
- Purpose
- To list, add and delete file shares or printer shares on the server.
- Syntax1
- net share [/netname:share_name] [/infolevel:N]
- Syntax2
- net share /add /netname:share_name [/type:{file|f}] /path:path_name [/desc:share_desc]
[/ro_password:password1] [/rw_password:password2]
[/mode:x] [/sh_oplockfiles:x] [/sh_searchcache:x] [/sh_sendfile:x]
- Syntax3
- net share /add /netname:share_name /type:{printer|p} /printq:qname [/print_options:ostr] [/desc:share_desc]
- Syntax4
- net share /delete /netname:share_name
- Syntax5
- net share /change /netname:share_name [/ro_password:password1] [/rw_password:password2]
- Description
- Syntax1 lists one or more shares.
Syntax2 adds
a file share to the server.
Syntax3 adds a printer
share.
Syntax4 deletes a share from the server.
Syntax5
changes password(s) of a file share.
Note: To
change a share, you must first delete it and then add it again, except for
file-share passwords.
- Flags
-
- /add
- Adds a share to the server.
- /delete
- Deletes a share from the server.
- /change
- Changes properties of a file share.
- /infolevel:N
- Specifies the level of information desired. Default level is 1. Valid
values are 0, 1, 2 and 99.
- /type:type
- Specifies the share type. Valid values are file (or f) and printer (or p). Default value is file.
- /netname:share_name
- Network name of the share. Without this option, all shares will be listed.
- /path:path_name
- Absolute AIX path name being exported by that file share.
- /printq:qname
- AIX print queue being exported by that printer share.
- /print_options:ostr
- String specifying printer options.
- /desc:desc
- Brief description of the share.
- /ro_password:password1
- Share-level security password for ReadOnly access. (Default is null.)
- /rw_password:password1
- Share-level security password for ReadWrite access. (Default is null.)
- /mode:x
- File-share access mode -- 0:ReadOnly, 1:ReadWrite. (Default is
1.)
- /sh_oplockfiles:x
- Allows opportunistic locks to be used -- 0:Disabled, 1:Enabled.
(Default is 0.)
- /sh_searchcache:x
- Allows search-caching to be used -- 0:Disabled, 1:Enabled. (Default
is 0.)
- /sh_sendfile:x
- Allows SendFile API to be used -- 0:Disabled, 1:Enabled. (Default
is 0.)
-
-
- Return Codes
-
- 0
- Command completed successfully.
- 1
- Syntax error: Unknown keyword or command option (%s).
- 2
- Operation could not be performed.
- 3
- Command could not be executed. Invalid value (%s) of parameter.
- 4
- Syntax Error: The share path or queue name must be specified.
- 5
- Error adding the share - share name already exists.
- 6
- Error deleting the share - share name not found.
- 7
- The configuration file could not be updated to reflect the current change.
-
-
- Output for info level 0 :
-
netname1
netname2
...
netnameN
- Output for info level 1 :
-
Share Name Share Type Path Name/Queue Name Share Description
---------- ---------- -------------------- ------------------
netname1 File /home/name/xxx File Description
netname2 Printer lpq1 Printer Description
...... ...... .... ..........
netnameN Printer lpq2 Printer Description
- Output for info level 99 :
-
netname:%s:type:%s:path:%s:printq:%s:print_options:%s:desc:%s::
net name Subcommand
- Purpose
- To list, add, and delete AIX Fast Connect server aliases (alternate
NetBIOS names).
- Syntax1
- net name [ /list ]
- Syntax2
- net name /add aliasname [/sub:value]
- Syntax3
- net name /delete aliasname [/sub:value]
- Description
- Syntax1 lists all server aliases (NetBIOS names).
Syntax2
adds a server alias (NetBIOS name).
Syntax3 deletes
a server alias (NetBIOS name).
- Flags
-
- /list
- Lists all server aliases (NetBIOS names).
- /add:aliasname
- Adds a server alias (NetBIOS name).
- /delete:aliasname
- Deletes a server alias (NetBIOS name).
- /sub:value
- Allows any NetBIOS subcode, (hexadecimal 00 to FF), to be specified.
Default is 00.
-
-
net session Subcommand
- Purpose
- To list and control user sessions connected to AIX Fast Connect.
- Syntax1
- net session
- Syntax2
- net session /user:Username /workstation:{IPaddress|NetBIOSname} [/fileinfo | /shareinfo]
- Syntax3
- net session /user:Username /workstation:{IPaddress|NetBIOSname} /close [/file:filename | /netname:sharename]
- Description
- Syntax1 lists connected user sessions.
Syntax2
lists files or resources in use by a connected user session.
Syntax3
closes a user session, or files or resources in use by a user session.
- Flags
-
- /user:Username
- User name of the session.
- /workstation:{IPaddress | NetBIOSname}
- NetBIOS computer name or IP address of the session.
- /fileinfo
- Lists statistics of files currently open by the session (default).
- /shareinfo
- Lists statistics of share resources currently used by the session.
- /close
- Closes specified user session, file, or resource.
- /file:filename
- Full AIX path name of file to be closed.
- /netname:sharename
- Share name resource to be closed.
-
-
- Return Codes
-
- 0
- Command completed successfully.
- 8
- ERROR: Invalid Workstation Name '%s'.
- 231
- ERROR: Missing user name or workstation name.
- 231
- Syntax Error: Unknown command action keyword (%s).
-
-
- Output for Syntax1:
-
User Workstation Open Files Connection Idle
Time(days:hrs:mins:secs)
-------------------------------------------------------------------------------
user1 station1 10 10:23:45:33 00:00:55:21
user2 station2 0 00:03:45:33 00:00:20:21
...
userN stationN 20 30:12:45:33 00:01:55:21
- Output for Syntax2, fileinfo:
-
Open mode Locks File name(s)
----------------------------------------------
r 0 /home/user3/test1.txt
w 3 /tmp/output.tmp
- Output for Syntax2, shareinfo:
-
Share name Connected Path/Queue name
------------------------------------------------
HOME 1 $HOME
NETTEMP 1 /tmp
NBNS Subcommands
The following subcommands are used to administer the NetBIOS Name Server
(NBNS) feature of AIX Fast Connect.
net nblistnames Subcommand
- Purpose
- To list the NetBIOS name table.
- Syntax
- net nblistnames
- Description
- Lists all names in the NetBIOS name table.
net nbaddname Subcommand
- Purpose
- To add a NetBIOS unique name to the NBNS name table.
- Syntax
- net nbaddname /name:name /ipaddress:ipaddress [ /sub:value ]
- Description
- Adds a NetBIOS unique name and its IP address to the NBNS name table.
- Flags
-
- /name:name
- NetBIOS unique name to be added to the NBNS name table.
- /ipaddress:ipaddress
- IP-address (dotted decimal format) of the added NetBIOS unique name.
- /sub:value
- The NetBIOS subcode value is a hex number from
00-ff. The default is 00.
-
-
net nbaddgroup Subcommand
- Purpose
- To add a NetBIOS group name to the NBNS name table.
- Syntax
- net nbaddgroup /name:name /ipaddress:ipaddress [ /sub:value ]
- Description
- Adds a NetBIOS group name and its IP address to the NBNS name table.
- Flags
-
- /name:name
- NetBIOS group name to be added to the NBNS name table.
- /ipaddress:ipaddress
- IP-address (dotted decimal format) of the added NetBIOS group name.
- /sub:value
- The NetBIOS subcode value is a hex number from
00-ff. The default is 00.
-
-
net nbaddmulti Subcommand
- Purpose
- To add a NetBIOS multihomed name to the NBNS name table.
- Syntax
- net nbaddmulti /name:name /ipaddress:ipaddress [ /sub:value ]
- Description
- Adds a NetBIOS multihomed name and its IP address to the NBNS name table.
If
the name already exists in the name table and the name is a multihomed name, ipaddress is added to its list of IP addresses.
- Flags
-
- /name:name
- NetBIOS multihomed name to be added to the NBNS name table.
- /ipaddress:ipaddress
- IP-address (dotted decimal format) of the NetBIOS multihomed name.
- /sub:value
- The NetBIOS subcode value is a hex number from
00-ff. The default is 00.
-
-
net nbdelname Subcommand
- Purpose
- To delete a NetBIOS name from the NBNS name table.
- Syntax
- net nbdelname /name:name [ /sub:value ]
- Description
- Deletes any type of permanent name from the NBNS name table.
- Flags
-
- /name:name
- NetBIOS name to be deleted from the NBNS name table.
- /sub:value
- The NetBIOS subcode value is a hex number from
00-ff. The default is 00.
-
-
net nbaddingrp Subcommand
- Purpose
- To add a NetBIOS internet group name to the NBNS name table.
- Syntax
- net nbaddingrp /name:name /ipaddress:ipaddress
- Description
- Adds a NetBIOS internet group name and its IP address to the NBNS name
table.
If the name already exists in the name table
and the name is a internet group name, ipaddress is
added to its list of IP addresses. A limit of 25 IP addresses is allowed per
internet group.
- Flags
-
- /name:name
- NetBIOS internet group name to be added to the NBNS name table.
- /ipaddress:ipaddress
- IP-address (dotted decimal format) of the NetBIOS internet group name.
-
-
net nbdeladdr Subcommand
- Purpose
- To delete an IP address from a NetBIOS internet group name in the NBNS
name table.
- Syntax
- net nbdeladdr /name:name /ipaddress:ipaddress
- Description
- Deletes an IP address of an NetBIOS internet group name from the NBNS
name table. If there is more than one IP address associated with the internet
group name, only that IP address is deleted from its list. Otherwise, the
internet group name is also deleted.
- Flags
-
- /name:name
- NetBIOS internet group name.
- /ipaddress:ipaddress
- IP address (dotted decimal format) to be deleted.
-
-
net nbbackup Subcommand
- Purpose
- To back up the NetBIOS name table to a file.
- Syntax
- net nbbackup /file:filename
- Description
- Copies all of the entries that are in the NetBIOS name table to a file.
Do not edit this file -- it should be used only as input to the net nbrestore command.
- Flags
-
- /file:filename
- The name of the file that the NetBIOS name table is written to.
-
-
net nbrestore Subcommand
- Purpose
- To restore the NetBIOS name table from a file.
- Syntax
- net nbrestore /file:filename
- Description
- Copies all of the entries that are in the file into the NetBIOS name
table to a file. Do not edit this file -- it should be the
output file from the net nbbackup command.
- Flags
-
- /file:filename
- The name of the file that the NetBIOS name table is restored from.
-
-
net nbstatus Subcommand
- Purpose
- To check the status of the NetBIOS Name Server.
- Syntax
- net nbstatus
- Description
- Prints the status of the NetBIOS Name Server (NBNS).
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]