Yncf 3.0.1 PDF
Yncf 3.0.1 PDF
The Usage Conventions For Your Network Configuration Files manual is supplied pursuant to and subject to the terms
of the Sony Computer Entertainment PlayStation® license agreements.
The Usage Conventions For Your Network Configuration Files manual is intended for distribution to and use by only
Sony Computer Entertainment licensed Developers and Publishers in accordance with the PlayStation® license
agreements.
Unauthorized reproduction, distribution, lending, rental or disclosure to any third party, in whole or in part, of this book
is expressly prohibited by law and by the terms of the Sony Computer Entertainment PlayStation® license agreements.
Ownership of the physical property of the book is retained by and reserved by Sony Computer Entertainment.
Alteration to or deletion, in whole or in part, of the book, its presentation, or its contents is prohibited.
The information in the Usage Conventions For Your Network Configuration Files manual is subject to change without
notice. The content of this book is Confidential Information of Sony Computer Entertainment.
and PlayStation are registered trademarks of Sony Computer Entertainment Inc. All other trademarks are property
of their respective owners and/or their licensors.
Table of Contents
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
4 Table of Contents
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
About This Document 5
Related Documentation
Note: the Developer Support Web site posts current developments regarding the Libraries and also
provides notice of future documentation releases and upgrades.
Typographic Conventions
Certain Typographic Conventions are used throughout this manual to clarify the meaning of the text:
Convention Meaning
courier Indicates literal program code.
italic Indicates names of arguments and structure
members (in structure/function definitions
only).
medium bold Indicates data types and structure/function
names (in structure/function definitions
only).
blue Indicates a hyperlink.
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
6 About This Document
Developer Support
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
Your Network Configuration Files 7
Figure 1
Your Network
Configuration Files
Operations performed on Your Network Configuration files must be via the common network configuration
library (netcnf) and the common network configuration interface library (netcnfif). In addition, since Your
Network Configuration files are shared resources, an application that uses these files (hereafter referred to
as a network configuration application) must follow prescribed standards.
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
8 Your Network Configuration Files
Table 2
File Type Maximum Size Maximum No. of Files Filename
Configuration 3K bytes 1 BWNETCNF
management file
Temporary file 3K bytes 1 BWNETCNF.tmp
Network configuration 3K bytes 6 net???.cnf
file
Hardware settings file 3K bytes 4 dev???.dat
Internet service 3K bytes 4 ifc???.dat
provider settings file
Icon file 34K bytes 1 SYS_NET.ICO
icon.sys 1K byte 1 icon.sys
File entries 9K bytes ((18+1)/2)
Directory entries 2K bytes
• The ??? of net???.cnf, dev???.dat, and ifc???.dat are automatically assigned by the common
network configuration library (netcnf).
• The temporary file is temporarily created by the common network configuration library (netcnf)
when manipulating Your Network Configuration files.
• The file entries and directory entries conform to the memory card library specification.
Table 4
File Type Maximum Size Maximum No. of Files Filename
Configuration 17K bytes 1 net.db
management file
Temporary file 17K bytes 1 net.db.tmp
Network configuration 3K bytes 10 net???.cnf
file
Hardware settings file 3K bytes 30 dev???.dat
Internet service 3K bytes 30 ifc???.dat
provider settings file
• The ??? of net???.cnf, dev???.dat, and ifc???.dat are automatically assigned by the common
network configuration library (netcnf).
• The temporary file is temporarily created by the common network configuration library (netcnf)
when manipulating Your Network Configuration files.
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
Your Network Configuration Files 9
Table 5
Type Meaning
Required A setting that is always entered or selected by the user and
must be set
Required/automatic A setting determined internally which must be set by the
network configuration application
Optional A setting that exists but doesn't get set unless it is entered or
selected by the user (it's also not saved if it isn't set)
In addition, the Applicable Keyword column shows the keyword provided by the common network
configuration library (netcnf) corresponding to that setting (for a description of keywords, refer to the
Common Network Configuration Library (netcnf) Overview).
Table 6: Network configuration file that contains combinations of hardware settings and Internet service
provider settings files
Type Setting Applicable Keyword
Required Combination of a hardware setting interface "ifc???.dat +
and Internet service provider setting dev???.dat" "ifc???.dat"
"dev???.dat"
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
10 Your Network Configuration Files
Also, because the vendor name and product name are used for the setting name, commas ',' cannot be
used.
Table 7: Settings when an Ethernet adapter manufactured by SCE is used for the connection hardware
Type Setting Applicable Keyword
Required/automatic Device layer type type nic
Required/automatic Vendor name vendor "vendor"
Required/automatic Product name product "product"
Required Operation mode of the One of the following
Ethernet hardware
Auto-detect phy_config auto
10Base-T Half-Duplex phy_config 10
10Base-T Full-Duplex phy_config 10_fd
100Base-TX Half-Duplex phy_config tx
100Base-TX Full-Duplex phy_config tx_fd
Table 8: Settings when a non-SCE Ethernet adapter is used for the connection hardware
Type Setting Applicable Keyword
Required/automatic Device layer type type eth
Required/automatic Vendor name vendor "vendor"
Required/automatic Product name product "product"
Required Operation mode of the One of the following
Ethernet hardware
Auto-detect phy_config auto
10Base-T Half-Duplex phy_config 10
10Base-T Full-Duplex phy_config 10_fd
100Base-TX Half-Duplex phy_config tx
100Base-TX Full-Duplex phy_config tx_fd
Table 9: Settings when a modem or terminal adapter is used for the connection hardware
Type Setting Applicable Keyword
Required/automatic Device layer type type ppp
Required/automatic Vendor name vendor "vendor"
Required/automatic Product name product "product"
Required Dialing type One of the following
Tone dialing_type tone
Pulse dialing_type pulse
Optional Additional AT commands chat_additional
"chat_script"
Optional Outside line outside_number
"outside_number" and
outside_delay
"outside_delay"
Required Line timeout (minutes) idle_timeout ?
• Although the line timeout setting is in units of minutes, the keyword that is defined by the common
network configuration library (netcnf) uses seconds as the units.
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
Your Network Configuration Files 11
• It must be possible to set a value from 0 to 90 minutes for the line timeout. The application must
treat any other value as an error. A 0 entry means no timeout. The default value must be 10
minutes.
Table 10: Settings when an Ethernet adapter manufactured by SCE is used for the connection hardware and
DHCP is not used
Type Setting Applicable Keyword
Required/automatic Device layer type type nic
Required Do not use DHCP -dhcp
Required IP address address "?.?.?.?"
Required Netmask netmask "?.?.?.?"
Required Default router route add -net 0.0.0.0
gw ?.?.?.? netmask 0.0.0.0
Optional Primary DNS nameserver add ?.?.?.?
Optional Secondary DNS nameserver add ?.?.?.?
• The IP address, netmask, default router, primary DNS, and secondary DNS are displayed in dot
format, which must be specified as follows.
num8.num8.num8.num8 (num8 is a decimal number represented as an unsigned 8 bit value)
• It must be possible to set values from 0.0.0.0 to 255.255.255.255 for the IP address, netmask,
default router, primary DNS, and secondary DNS. The application must treat any other value as an
error.
• For the IP address, netmask, and default router, 0.0.0.0 must be considered to be an error.
• For the primary DNS and secondary DNS, 0.0.0.0 must be either considered to be an error, or
treated as a specification for automatic acquisition.
Table 11: Settings when an Ethernet adapter manufactured by SCE is used for the connection hardware and
DHCP is used
Type Setting Applicable Keyword
Required/automatic Device layer type type nic
Required Use DHCP dhcp
Optional Primary DNS nameserver add ?.?.?.?
Optional Secondary DNS nameserver add ?.?.?.?
Optional DHCP host name dhcp_host_name
"host_name"
• The primary DNS and secondary DNS are displayed in dot format, which must be specified as
follows.
num8.num8.num8.num8 (num8 is a decimal number represented as an unsigned 8 bit value)
• It must be possible to set values from 0.0.0.0 to 255.255.255.255 for the primary DNS and
secondary DNS. The application must treat any other value as an error.
• For the primary DNS and secondary DNS, 0.0.0.0 must be either considered to be an error, or
treated as a specification for automatic acquisition.
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
12 Your Network Configuration Files
Table 12: Settings when a non-SCE Ethernet adapter is used for the connection hardware and DHCP is not
used
Type Setting Applicable Keyword
Required/automatic Device layer type type eth
Required Do not use DHCP -dhcp
Required IP address address "?.?.?.?"
Required Netmask netmask "?.?.?.?"
Required Default router route add -net 0.0.0.0
gw ?.?.?.? netmask 0.0.0.0
Optional Primary DNS nameserver add ?.?.?.?
Optional Secondary DNS nameserver add ?.?.?.?
• The IP address, netmask, default router, primary DNS, and secondary DNS are displayed in dot
format, which must be specified as follows.
num8.num8.num8.num8 (num8 is a decimal number represented as an unsigned 8 bit value)
• It must be possible to set values from 0.0.0.0 to 255.255.255.255 for the IP address, netmask,
default router, primary DNS, and secondary DNS. The application must treat any other value as an
error.
• For the IP address, netmask, and default router, 0.0.0.0 must be considered to be an error.
• For the primary DNS and secondary DNS, 0.0.0.0 must be either considered to be an error, or
treated as a specification for automatic acquisition.
Table 13: Settings when a non-SCE Ethernet adapter is used for the connection hardware and DHCP is used
Type Setting Applicable Keyword
Required/automatic Device layer type type eth
Required Use DHCP dhcp
Optional Primary DNS nameserver add ?.?.?.?
Optional Secondary DNS nameserver add ?.?.?.?
Optional DHCP host name dhcp_host_name
"host_name"
• The primary DNS and secondary DNS are displayed in dot format, which must be specified as
follows.
num8.num8.num8.num8 (num8 is a decimal number represented as an unsigned 8 bit value)
• It must be possible to set values from 0.0.0.0 to 255.255.255.255 for the primary DNS and
secondary DNS. The application must treat any other value as an error.
• For the primary DNS and secondary DNS, 0.0.0.0 must be either considered to be an error, or
treated as a specification for automatic acquisition.
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
Your Network Configuration Files 13
Table 14: Settings when an Ethernet adapter is used for the connection hardware, PPPoE is used, and the DNS
server address is automatically obtained
Type Setting Applicable Keyword
Required/automatic Device layer type type ppp
Required/automatic Authentication name of peer_name "*"
connection destination
Required/automatic Authentication method allow.auth chap/pap
Required/automatic Do not use DHCP -dhcp
Required User ID auth_name "user_id"
Required Password auth_key "password"
Required Automatically obtain DNS want.dns1_nego
server address want.dns2_nego
Required/automatic Default router route add -net 0.0.0.0
netmask 0.0.0.0
Required/automatic Prohibit PFC negotiation -want.prc_nego
Required/automatic Prohibit ACFC negotiation -want.acc_nego
Required/automatic Prohibit ACCM negotiation -want.accm_nego
Required/automatic MTU and MRU setting mtu 1454
(1454 bytes)
Required Use PPPoE pppoe
Required/automatic Line timeout (minutes) idle_timeout 0
Table 15: Settings when an Ethernet adapter is used for the connection hardware, PPPoE is used, but the DNS
server address is not automatically obtained
Type Setting Applicable Keyword
Required/automatic Device layer type type ppp
Required/automatic Authentication name of peer_name "*"
connection destination
Required/automatic Authentication method allow.auth chap/pap
Required/automatic Do not use DHCP -dhcp
Required User ID auth_name "user_id"
Required Password auth_key "password"
Required Primary DNS nameserver add ?.?.?.?
Optional Secondary DNS nameserver add ?.?.?.?
Required/automatic Default router route add -net 0.0.0.0
netmask 0.0.0.0
Required/automatic Prohibit PFC negotiation -want.prc_nego
Required/automatic Prohibit ACFC negotiation -want.acc_nego
Required/automatic Prohibit ACCM negotiation -want.accm_nego
Required/automatic MTU and MRU setting mtu 1454
(1454 bytes)
Required Use PPPoE pppoe
Required/automatic Line timeout (minutes) idle_timeout 0
• The primary DNS and secondary DNS are displayed in dot format, which must be specified as
follows.
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
14 Your Network Configuration Files
Table 16: Settings when a modem or terminal adapter is used for the connection hardware, and the DNS server
address is automatically obtained
Type Setting Applicable Keyword
Required/automatic Device layer type type ppp
Required/automatic Authentication name of peer_name "*"
connection destination
Required/automatic Authentication method allow.auth chap/pap
Required/automatic Do not use DHCP -dhcp
Required User ID auth_name "user_id"
Required Password auth_key "password"
Required Telephone number 1 phone_number0
??????????
Optional Telephone number 2 phone_number1
??????????
Optional Telephone number 3 phone_number2
??????????
Required Automatically obtain DNS want.dns1_nego
server address want.dns2_nego
Required/automatic Default router route add -net 0.0.0.0
netmask 0.0.0.0
Table 17: Settings when a modem or terminal adapter is used for the connection hardware, and the DNS server
address is not automatically obtained
Type Setting Applicable Keyword
Required/automatic Device layer type type ppp
Required/automatic Authentication name of peer_name "*"
connection destination
Required/automatic Authentication method allow.auth chap/pap
Required/automatic Do not use DHCP -dhcp
Required User ID auth_name "user_id"
Required Password auth_key "password"
Required Telephone number 1 phone_number0
??????????
Optional Telephone number 2 phone_number1
??????????
Optional Telephone number 3 phone_number2
??????????
Required Primary DNS nameserver add ?.?.?.?
Optional Secondary DNS nameserver add ?.?.?.?
Required/automatic Default router route add -net 0.0.0.0
netmask 0.0.0.0
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
Your Network Configuration Files 15
• The primary DNS and secondary DNS are displayed in dot format, which must be specified as
follows.
num8.num8.num8.num8 (num8 is a decimal number represented as an unsigned 8 bit value)
• It must be possible to set values from 0.0.0.0 to 255.255.255.255 for the primary DNS and
secondary DNS. The application must treat any other value as an error.
• For the primary DNS and secondary DNS, 0.0.0.0 must be either considered to be an error, or
treated as a specification for automatic acquisition.
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
16 Criteria For Creating Network Configuration Applications (Read Processing)
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
Criteria For Creating Network Configuration Applications (Read Processing) 17
• When a network configuration that has been saved as the default data in individual data is used
for the connection, a check must be done to be sure that a network configuration with the same
contents is present in the directory where the original Your Network Configuration file is located.
At the same time, the presence of the hardware setting and Internet service provider setting that
are registered in the network configuration as well as their contents must also be confirmed.
• When telephone numbers 1-3 have been set, there must be a mechanism to redial telephone
number 2 when telephone number 1 is busy, and to redial telephone number 3 when telephone
number 2 is busy.
• Make sure that the connection can be established even if the Internet service provider setting is
inconsistent for the type of Ethernet adapter as follows.
a. When an attempt is made to connect with an Ethernet adapter manufactured by SCE, and the
hardware setting is type nic, but the Internet service provider setting is type eth.
b. When an attempt is made to connect with a non-SCE Ethernet adapter, and the hardware
setting is type eth, but the Internet service provider setting is type nic.
• When hardware settings that have been saved as the default data in individual data are displayed,
a check must be done to be sure that a hardware settings file with the same contents is present in
the directory where the original Your Network Configuration file is located.
• When displaying additional AT commands, the sceNetCnfConvS2A() function must be executed
first before displaying. This function is provided in the common network configuration library for
processing strings that are read from Your Network Configuration files. In addition, be sure to
provide a 256-byte buffer for the converted string, in order to avoid the
sceNETCNF_TOO_LONG_STR(-19) error.
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
18 Criteria For Creating Network Configuration Applications (Read Processing)
• When Internet service provider settings that have been saved as the default data in individual data
are displayed, a check must be done to be sure that an Internet service provider settings file with
the same contents is present in the directory where the original Your Network Configuration file is
located.
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
Criteria For Creating Network Configuration Applications (Read Processing) 19
• When displaying the user ID, the sceNetcnfifConvAuthname() function must be executed on the
user ID and the result must be displayed on the screen.
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
20 Criteria For Creating Network Configuration Applications (Write Processing)
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
Criteria For Creating Network Configuration Applications (Write Processing) 21
• Hardware settings must be saved in the stipulated directory using valid filenames (see "Structure
Of Your Network Configuration Files", above).
• Make sure that not more than the stipulated maximum number of hardware settings files can be
saved (see "Structure Of Your Network Configuration Files", above).
• All stipulated settings must be supported. Settings other than those which are stipulated must not
be saved (see "Contents Of Your Network Configuration Files", above).
• The settings name must be saved in the form below, using the vendor name and product name
obtained from the device driver.
vendor-name/product-name
• If an unknown setting is encountered during editing, that setting must be saved unchanged.
• Stipulated characters must be used. Inputting of characters other than those which are stipulated
must be prevented (see "Usable Characters", below).
• A 256-byte internal buffer must be provided for items in which strings are to be set to enable at
most 255 characters + "\0" to be read and written correctly (note that hiragana and katakana can
require up to 3 bytes per character). Also, a mechanism must be implemented for preventing input
that would exceed the size of the provided buffer.
• The application must allow additional AT commands to be entered, in either plain AT command
format or as CHAT script sequences (defined in the "Common Network Configuration Library
Overview"). The user input must be filtered with the sceNetCnfConvA2S() function provided by the
common network configuration library before saving the setting. If
sceNETCNF_TOO_LONG_STR(-19) is detected during the conversion, an error message must be
displayed indicating that the input contains too many characters.
• The same contents must not be saved within application-specific data for any purpose other than
making it the default data.
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
22 Criteria For Creating Network Configuration Applications (Write Processing)
• The same contents must not be saved within application-specific data for any purpose other than
making it the default data.
• When sceNETCNF_AOL_CONFIGURATION(-20) is detected, the Internet service provider setting
must not be added or edited.
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
Implementation Details 23
Implementation Details
// Execute sceNetCnfLoadEntry()
sceNetCnfLoadEntry("configuration management file name", type,
"setting name(network configuration name)", &env);
// Set redial_count
for(i = 0, redial_count = 0; i < sceNetCnf_MAX_PHONE_NUMBERS; i++)
{
if(NULL == (env.root->pair_head->ifc->phone_numbers[i]))
continue;
switch(i){
case 0: redial_count++; break;
case 1: redial_count++; break;
case 2: redial_count++; break;
}
}
env.root->pair_head->ifc->redial_count = redial_count - 1;
In addition, the redial_count value that is set by the processing shown above must not be saved to a Your
Network Configuration file. This should be implemented as processing that is performed only when making
a connection.
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
24 Implementation Details
• When PPPoE is not used and the type for the Internet service provider setting is not ppp,
overwrite the type for the Internet service provider setting with the type for the hardware setting.
An implementation example is shown below.
sceNetCnfEnv_t env;
// Execute sceNetCnfLoadEntry()
sceNetCnfLoadEntry("configuration management file name", type,
"setting name(network configuration name)", &env);
// When PPPoE is not used and the Internet service provider setting
// type is not ppp, overwrite the type
if(env.root->pair_head->ifc->pppoe != 1 &&
env.root->pair_head->ifc->type != sceNetCnf_IFC_TYPE_PPP){
env.root->pair_head->ifc->type = env.root->pair_head->dev-
>type;
}
In addition, the value that is set by the processing shown above must not be saved to a Your Network
Configuration file. This should be implemented as processing that is performed only when making a
connection.
Usable Characters
The following table lists the characters that can be used in Your Network Configuration files. A network
configuration application must be able to handle the characters displayed here. Characters other than
those displayed here must not be saved to Your Network Configuration files.
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
Implementation Details 25
Table 21
Char UTF-8 JIS SJIS Unicode
ぁ e3 81 81 2421 829f 3041
あ e3 81 82 2422 82a0 3042
ぃ e3 81 83 2423 82a1 3043
い e3 81 84 2424 82a2 3044
ぅ e3 81 85 2425 82a3 3045
う e3 81 86 2426 82a4 3046
ぇ e3 81 87 2427 82a5 3047
え e3 81 88 2428 82a6 3048
ぉ e3 81 89 2429 82a7 3049
お e3 81 8a 242a 82a8 304a
か e3 81 8b 242b 82a9 304b
が e3 81 8c 242c 82aa 304c
き e3 81 8d 242d 82ab 304d
ぎ e3 81 8e 242e 82ac 304e
く e3 81 8f 242f 82ad 304f
ぐ e3 81 90 2430 82ae 3050
け e3 81 91 2431 82af 3051
げ e3 81 92 2432 82b0 3052
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
26 Implementation Details
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
Implementation Details 27
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
28 Implementation Details
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
Implementation Details 29
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1
30 Implementation Details
Usage Conventions For Your Network Configuration Files - Runtime Library Release 3.0.1