Skip to content

Commit 1c5a325

Browse files
committed
Rename Distributed to DistributedNext
1 parent 729ba6a commit 1c5a325

File tree

2 files changed

+28
-16
lines changed

2 files changed

+28
-16
lines changed

Project.toml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
name = "Distributed"
2-
uuid = "8ba89e20-285c-5b6f-9357-94700520ee1b"
3-
version = "1.11.0"
1+
name = "DistributedNext"
2+
uuid = "fab6aee4-877b-4bac-a744-3eca44acbb6f"
3+
version = "1"
44

55
[deps]
66
Random = "9a3f8284-a2c9-5f02-9a11-845980a1fd5c"

README.md

Lines changed: 25 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,20 @@
1-
# Distributed
1+
# DistributedNext
22

3-
The `Distributed` package provides functionality for creating and controlling multiple Julia processes remotely, and for performing distributed and parallel computing. It uses network sockets or other supported interfaces to communicate between Julia processes, and relies on Julia's `Serialization` stdlib package to transform Julia objects into a format that can be transferred between processes efficiently. It provides a full set of utilities to create and destroy new Julia processes and add them to a "cluster" (a collection of Julia processes connected together), as well as functions to perform Remote Procedure Calls (RPC) between the processes within a cluster. See the `API` section for details.
3+
The `DistributedNext` package provides functionality for creating and
4+
controlling multiple Julia processes remotely, and for performing distributed
5+
and parallel computing. It uses network sockets or other supported interfaces to
6+
communicate between Julia processes, and relies on Julia's `Serialization`
7+
stdlib package to transform Julia objects into a format that can be transferred
8+
between processes efficiently. It provides a full set of utilities to create and
9+
destroy new Julia processes and add them to a "cluster" (a collection of Julia
10+
processes connected together), as well as functions to perform Remote Procedure
11+
Calls (RPC) between the processes within a cluster. See the `API` section for
12+
details.
413

5-
This package ships as part of the Julia stdlib.
6-
7-
## Using development versions of this package
8-
9-
To use a newer version of this package, you need to build Julia from scratch. The build process is the same as any other build except that you need to change the commit used in `stdlib/Distributed.version`.
10-
11-
It's also possible to load a development version of the package using [the trick used in the Section named "Using the development version of Pkg.jl" in the `Pkg.jl` repo](https://github.com/JuliaLang/Pkg.jl#using-the-development-version-of-pkgjl), but the capabilities are limited as all other packages will depend on the stdlib version of the package and will not work with the modified package.
1214

1315
## API
1416

15-
The public API of `Distributed` consists of a variety of functions for various tasks; for creating and destroying processes within a cluster:
17+
The public API of `DistributedNext` consists of a variety of functions for various tasks; for creating and destroying processes within a cluster:
1618

1719
- `addprocs` - create one or more Julia processes and connect them to the cluster
1820
- `rmprocs` - shutdown and remove one or more Julia processes from the cluster
@@ -49,6 +51,16 @@ For controlling multiple processes at once:
4951

5052
### Process Identifiers
5153

52-
Julia processes connected with `Distributed` are all assigned a cluster-unique `Int` identifier, starting from `1`. The first Julia process within a cluster is given ID `1`, while other processes added via `addprocs` get incrementing IDs (`2`, `3`, etc.). Functions and macros which communicate from one process to another usually take one or more identifiers to determine which process they target - for example, `remotecall_fetch(myid, 2)` calls `myid()` on process 2.
53-
54-
**Note:** Only process 1 (often called the "head", "primary", or "master") may add or remove processes, and manages the rest of the cluster. Other processes (called "workers" or "worker processes") may still call functions on each other and send and receive data, but `addprocs`/`rmprocs` on worker processes will fail with an error.
54+
Julia processes connected with `DistributedNext` are all assigned a
55+
cluster-unique `Int` identifier, starting from `1`. The first Julia process
56+
within a cluster is given ID `1`, while other processes added via `addprocs` get
57+
incrementing IDs (`2`, `3`, etc.). Functions and macros which communicate from
58+
one process to another usually take one or more identifiers to determine which
59+
process they target - for example, `remotecall_fetch(myid, 2)` calls `myid()` on
60+
process 2.
61+
62+
**Note:** Only process 1 (often called the "head", "primary", or "master") may
63+
add or remove processes, and manages the rest of the cluster. Other processes
64+
(called "workers" or "worker processes") may still call functions on each other
65+
and send and receive data, but `addprocs`/`rmprocs` on worker processes will
66+
fail with an error.

0 commit comments

Comments
 (0)