Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Glossary-0.43.0 #1263

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
203 changes: 203 additions & 0 deletions docs/glossary.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,203 @@
{:shortdesc: .shortdesc}
{:new_window: target="_blank"}

# Glossary
*Last update: 2024/01/29*


This glossary provides terms and definitions for Runtimes OpenJ9 ®.
{:shortdesc}

The following cross-references are used in this glossary:

- *See* refers you from a nonpreferred term to the preferred term or from an abbreviation to the spelled-out form.
- *See also* refers you to a related or contrasting term.


<!--If you do not want letter links at the top of your glossary, delete the text between these comment tags.-->

[A](#glossa)
[B](#glossb)
[C](#glossc)
[D](#glossd)
[E](#glosse)
[F](#glossf)
[G](#glossg)
[H](#glossh)
[I](#glossi)
[J](#glossj)
[K](#glossk)
[L](#glossl)
[M](#glossm)
[N](#glossn)
[O](#glosso)
[P](#glossp)
[Q](#glossq)
[R](#glossr)
[S](#glosss)
[T](#glosst)
[U](#glossu)
[V](#glossv)
[W](#glossw)
[Z](#glossz)

<!--end letter link tags-->

## A
{: #glossa}


### AWT font subsystem
{: #x10447151}

The Abstract Window Toolkit (AWT) package in Java that is used to create graphical user interface applications. It contains classes that help to implement common windows-based tasks, such as adding scroll bars, buttons, list items, and text boxes.

## C
{: #glossc}


### cryptographic acclerator
{: #x10447156}

The use of hardware to run cryptographic operations to improve performance.

## D
{: #glossd}


### dump
{: #x2021514}

A capture of storage information at the time of an error.

### dynamic logical partitioning
{: #x10447168}

Partitioning with the capability to logically attach and detach a managed system's resources to and from a logical partition's operating system without rebooting.

## H
{: #glossh}


### heap dump
{: #x2788665}

A dump that shows the content of the Java heap.

### heuristic
{: #x2085115}

A problem-solving method or algorithm used to derive a workable solution in within a reasonable time.

### huge page
{: #x4550512}

In Linux, a block of memory that can be 2 MB or 1 GB in size. Using huge pages increases the kernel-level performance by creating fewer pages and therefore fewer mapping tables that the kernel has to load.
Copy link
Member

@pshipton pshipton Jan 30, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2MB and 1GB are just examples, not the only possibilities.


## J
{: #glossj}


### Java dump
{: #x8172135}

A dump that contains information from the Java application, such as the operating environment, locks, threads, hooks, shared classes, and class loaders.

## L
{: #glossl}


### large page
{: #x10447162}

In Windows, a block of memory that can be 2 MB or 1 GB in size.

### logical partition (LP,LPAR)
{: #x2002959}

A function of an operating system that creates segments of resources that can be run on copies, or instances, of the operating system and associated applications.

### LP
{: #x2029334}
See [logical partition](#x2002959).


### LPAR
{: #x2029338}
See [logical partition](#x2002959).


## O
{: #glosso}


### OpenSSL
{: #x10447142}

An open source version of the SSL and TLS security protocols, which provide encryption and server authentication over the internet.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's more than this. Copying from openssl.org it's also a "toolkit for general-purpose cryptography", which is the part of OpenSSL used by OpenJ9 with OpenJDK.


## P
{: #glossp}


### page
{: #x2003565}

A block of memory that equals 4096 bytes.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It depends on the platform and configuration, it's not always 4096 bytes.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How can we generalise it? Maybe as follows:

A contiguous block of virtual memory, usually of 4096 bytes size. A page size can be 2^n.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"usually of 4096" bytes only applies to certain platforms/OSes.


## R
{: #glossr}


### release cadence
{: #x10447137}

The frequency at which new software updates or features are released to users.

## S
{: #glosss}


### SDUMP
{: #x2685105}
See [system dump](#x2095425).


### Secure Sockets Layer (SSL)
{: #x2038004}

A security protocol that provides communication privacy. With SSL, client/server applications can communicate in a way that is designed to prevent eavesdropping, tampering, and message forgery.

### SSL
{: #x2483907}
See [Secure Sockets Layer](#x2038004).


### system dump (SDUMP)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Where does SDUMP come from, does OpenJ9 use this term?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We are expected to use the Terminology-in-ibm for creating glossaries. The idea is to use standardised terms and definition across IBM. We can suggest changes and make it specific to each product. SDUMP might be an existing term that is being reused. I am coordinating with Carla Quinn. I will pass on these comments to her and work on correcting it. Please do let me know any other concerns you might have. Thanks!

{: #x2095425}

A dump of all the storage in the system that can be used for problem determination.

## T
{: #glosst}


### THP
{: #x10447179}
See [Transparent Huge Pages](#x10447174).


### TLS
{: #x2041643}
See [Transport Layer Security](#x2069299).


### Transparent Huge Pages (THP)
{: #x10447174}

An abstraction layer that is a Linux kernel feature for automating most parts of creating and managing huge pages.

### Transport Layer Security (TLS)
{: #x2069299}

A set of encryption rules that uses verified certificates and encryption keys to secure communications over the Internet. TLS is an update to the SSL protocol.
2 changes: 2 additions & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -479,6 +479,8 @@ nav:
- "OpenJ9 messages" : messages_intro.md
- "Environment variables" : env_var.md

- "Glossary" : glossary.md

- "API documentation" :
- "Overview" : api-overview.md
- "Java 8 API" :
Expand Down