Changeset 81ecc05b in rtems


Ignore:
Timestamp:
05/28/00 18:21:16 (23 years ago)
Author:
Joel Sherrill <joel.sherrill@…>
Branches:
4.10, 4.11, 4.8, 4.9, 5, master
Children:
9fa28fbc
Parents:
f50c11b
Message:

Updated to reflect lower confdefs.h values and new control
over number of termios ports.

Location:
doc/user
Files:
2 edited

Legend:

Unmodified
Added
Removed

  • doc/user/conf.t

    rf50c11b r81ecc05b  
    6363#define CONFIGURE_TICKS_PER_TIMESLICE       50 /* 50 milliseconds */
    6464
     65#define CONFIGURE_MAXIMUM_TASKS 4
    6566#define CONFIGURE_RTEMS_INIT_TASKS_TABLE
    6667@end group
    … …  
    8283produced.
    8384
     85The user should be aware that the defaults are intentionally
     86set as low as possible.  By default, no application resources
     87are configured.  The @code{confdefs.h} file ensures that
     88at least one application tasks or thread is configured
     89and that at least one of the initialization task/thread
     90tables is configured.
     91
     92The @code{confdefs.h} file estimates the amount of
     93memory required for the RTEMS Executive Workspace.  This
     94estimate is only as accurate as the information given
     95to @code{confdefs.h} and may be either too high or too
     96low for a variety of reasons.  Some of the reasons that
     97@code{confdefs.h} may reserve too much memory for RTEMS
     98are:
     99
     100@itemize @bullet
     101@item All tasks/threads are assumed to be floating point.
     102@end itemize
     103
     104Conversely, there are many more reasons, the resource
     105estimate could be too low:
     106
     107@itemize @bullet
     108@item Task/thread stacks greater than minimum size must be
     109accounted for explicitly by developer.
     110
     111@item Memory for messages is not included.
     112
     113@item Device driver requirements are not included.
     114
     115
     116@item Network stack requirements are not included.
     117
     118@item Requirements for add-on libraries are not included.
     119@end itemize
     120
     121In general, @code{confdefs.h} is very accurate when given
     122enough information.  However, it is quite easy to use
     123a library and not account for its resources.
     124
    84125The following subsection list all of the constants which can be
    85126set by the user.
    … …  
    96137maximum number of files that can be concurrently open.  Libio requires
    97138a Classic RTEMS semaphore for each file descriptor as well as one
    98 global one.  The default value is 20 file descriptors. 
     139global one.  The default value is 3 file descriptors which is
     140enough to support standard input, output, and error output.
     141
     142@findex CONFIGURE_TERMIOS_DISABLED
     143@item @code{CONFIGURE_TERMIOS_DISABLED} is defined if the
     144software implementing POSIX termios functionality is
     145not going to be used by this application.  By default, this
     146is not defined and resources are reserved for the
     147termios functionality.
     148
     149@findex CONFIGURE_NUMBER_OF_TERMIOS_PORTS
     150@item @code{CONFIGURE_NUMBER_OF_TERMIOS_PORTS} is set to the
     151number of ports using the termios functionality.  Each
     152concurrently active termios port requires resources.
     153By default, this is set to 1 so a console port can be
     154used.
    99155
    100156@findex CONFIGURE_HAS_OWN_MOUNT_TABLE
    … …  
    107163@code{rtems_filesystem_mount_table_t}.
    108164
    109 @findex CONFIGURE_USE_MINIIMFS_AS_BASE_FILESYSTEM
    110 @item @code{CONFIGURE_USE_MINIIMFS_AS_BASE_FILESYSTEM} is defined
    111 if the application wishes to use a minimal functionality subset
    112 of the In-Memory FileSystem (IMFS).  The miniIMFS is comparable
     165@findex CONFIGURE_USE_IMFS_AS_BASE_FILESYSTEM
     166@item @code{CONFIGURE_USE_IMFS_AS_BASE_FILESYSTEM} is defined
     167if the application wishes to use the full functionality
     168IMFS.  By default, the miniIMFS is used.  The miniIMFS
     169is a minimal functionality subset of the In-Memory
     170FileSystem (IMFS).  The miniIMFS is comparable
    113171in functionality to the pseudo-filesystem name space provided
    114172before RTEMS release 4.5.0.  The miniIMFS supports
    115173only directories and device nodes and is smaller in executable
    116 code size than the full IMFS.  By default, this is not
    117 defined and the full functionality IMFS is used.
     174code size than the full IMFS.
    118175
    119176@findex STACK_CHECKER_ON
    … …  
    142199usually set by the BSP but since this memory is allocated
    143200from the RTEMS Ram Workspace, it must be accounted for.  The
    144 default for this field is RTEMS_MINIMUM_STACK_SIZE.
     201default for this field is RTEMS_MINIMUM_STACK_SIZE.  [NOTE:
     202At this time, changing this constant does NOT change the
     203size of the interrupt stack, only the amount of memory
     204reserved for it.]
    145205
    146206@findex CONFIGURE_EXECUTIVE_RAM_WORK_AREA
    … …  
    288348@item @code{CONFIGURE_MAXIMUM_TASKS} is the maximum number of
    289349Classic API tasks that can be concurrently active.
    290 The default for this field is 10.
     350The default for this field is 0.
    291351
    292352@findex CONFIGURE_MAXIMUM_TIMERS
    … …  
    416476@item @code{CONFIGURE_MAXIMUM_POSIX_THREADS} is the maximum number of
    417477POSIX API threads that can be concurrently active.
    418 The default is 10.
     478The default is 0.
    419479
    420480@findex CONFIGURE_MAXIMUM_POSIX_MUTEXES
    … …  
    504564is the maximum number of
    505565ITRON API tasks that can be concurrently active.
    506 The default is 10.
     566The default is 0.
    507567
    508568@findex CONFIGURE_MAXIMUM_ITRON_SEMAPHORES

  • doc/user/example.texi

    rf50c11b r81ecc05b  
    7575#define CONFIGURE_TEST_NEEDS_CLOCK_DRIVER    /* for time services */
    7676
     77#define CONFIGURE_MAXIMUM_TASKS 2
     78
    7779#define CONFIGURE_INIT_TASK_NAME rtems_build_name( 'E', 'X', 'A', 'M' )
    7880#define CONFIGURE_RTEMS_INIT_TASKS_TABLE
Note: See TracChangeset for help on using the changeset viewer.